Skip to content

Latest commit

 

History

History
executable file
·
81 lines (50 loc) · 4.21 KB

README.md

File metadata and controls

executable file
·
81 lines (50 loc) · 4.21 KB

Weights and Biases on OCI OKE

This quickstart template deploys the self managed WandB on Oracle Kubernetes Engine (OKE).

Pre-Requisites

Please read the following prerequisites sections thoroughly prior to deployment.

Instance Principals & IAM Policy

Deployment depends on use of Instance Principals via OCI CLI to generate kube config for use with kubectl. You should create a dynamic group for the compartment where you are deploying wandb.

instance.compartment.id='ocid.comp....'

After creating the group, you should set specific IAM policies for OCI service interaction:

Allow dynamic-group wandb to manage cluster-family in compartment wandb
Allow dynamic-group wandb to manage object-family in compartment wandb
Allow dynamic-group wandb to manage virtual-network-family in compartment wandb

Storing WandB artifacts to OCI Bucket

Weights and Biases allows to use an Object Storage Bucket of your choosing only when using a paying licence. Specifying the Bucket is easly done using the Console. More info can be found on Wandb Bring Your Own Bucket.

Reserved Public IP

Deployment depends on a public ip for the Load Balancer. This is used to create the certificates and expose the Wandb Console to public network. Go to Create a Reserved Public IP.

Deployment

This deployment uses Oracle Resource Manager and consists of a VCN,an OKE Cluster with Node Pool, and an Edge node. The Edge node installs OCI CLI, Kubectl, wandb and configures everything. This is done using cloudinit - the build process is logged in /var/log/OKE-wandb-initialize.log.

Note that you should select shapes and scale your node pool as appropriate for your workload.

This template deploys the following by default:

  • Virtual Cloud Network
    • Public (Edge) Subnet
    • Private Subnet
    • Internet Gateway
    • NAT Gateway
    • Service Gateway
    • Route tables
    • Security Lists
      • TCP 22 for Edge SSH on public subnet
      • Ingress to both subnets from VCN CIDR
      • Egress to Internet for both subnets
  • OCI Virtual Machine Edge Node
  • OKE Cluster and Node Pool
  • Load Balancer

Simply click the Deploy to OCI button to create an ORM stack, then walk through the menu driven deployment. Once the stack is created, use the menu to Plan and Apply the template.

Deploy to Oracle Cloud

OKE post-deployment

Please wait for 10-12 minutes until the cloud init script installs and configures everything.

You can check status of the OKE cluster using the following kubectl commands:

kubectl get all -A

wandb Access

The console should be available at https://wandb.<reserved_public_ip>.nip.io. In case you're not seeing it, please wait for it to be available or:

ssh -i ~/.ssh/PRIVATE_KEY opc@EDGE_NODE_IP
cat /var/log/OKE-wandb-initialize.log|egrep -i "Point your browser to"

Wandb offers the use of a trial licence but it has limitations. Information on how to configure the accounts and licence can be found on this page.

Destroying the Stack

Note that with the inclusion of SSL Load Balancer, you will need to remove the ingress-nginx-controller service before you destroy the stack, or you will get an error.

kubectl delete svc ingress-nginx-controller -n ingress-nginx

This will remove the service, then you can destroy the build without errors.