Kubeflow
- Kubeflow Charmers | bundle
- Cloud
Channel | Revision | Published |
---|---|---|
latest/candidate | 294 | 24 Jan 2022 |
latest/beta | 430 | 30 Aug 2024 |
latest/edge | 423 | 26 Jul 2024 |
1.9/stable | 432 | 03 Dec 2024 |
1.9/beta | 420 | 19 Jul 2024 |
1.9/edge | 431 | 03 Dec 2024 |
1.8/stable | 414 | 22 Nov 2023 |
1.8/beta | 411 | 22 Nov 2023 |
1.8/edge | 413 | 22 Nov 2023 |
1.7/stable | 409 | 27 Oct 2023 |
1.7/beta | 408 | 27 Oct 2023 |
1.7/edge | 407 | 27 Oct 2023 |
juju deploy kubeflow --channel latest/edge
Deploy Kubernetes operators easily with Juju, the Universal Operator Lifecycle Manager. Need a Kubernetes cluster? Install MicroK8s to create a full CNCF-certified Kubernetes system in under 60 seconds.
Platform:
This guide describes how to install Charmed Kubeflow (CKF) on Azure Kubernetes Service (AKS).
You will spin up an AKS cluster using the Azure CLI (Command Line Interface) on your local machine. Then, you will interact with the cluster and deploy CKF using kubectl and Juju.
Requirements
- Local machine with Ubuntu 22.04 or later.
- An Azure account.
- Azure CLI.
- kubectl.
Make sure the Azure CLI has the following configuration:
- Authentication permissions required for AKS.
Managed Application Contributor Role
added.
Deploy AKS cluster
Note that the deployment incurs charges for every hour the cluster is running.
First, create a resource group to deploy the cluster:
az group create --name myResourceGroup --location westeurope
Regarding location, choose whichever suits best your needs. You can list all locations available using az account list-locations -o table
.
Now, spin up the cluster. The configuration below provides the minimum requirements for deploying CKF. For further customization, see the full list of available parameters:
az aks create \
--resource-group myResourceGroup \
--name myAKSCluster \
--kubernetes-version 1.29 \
--node-count 2 \
--node-vm-size Standard_D8s_v3 \
--node-osdisk-size 100 \
--node-osdisk-type Managed \
--os-sku Ubuntu \
--ssh-key-value <path-to-public-key>
kubernetes-version
: this example uses Kubernetes (K8s)1.29
. For using other versions, see Supported versions for compatibility with K8s and Juju.node-count
: this cluster has two worker nodes, given that the cluster autoscaler option is disabled by default. You can also enable it and define insteadmax-count
andmin-count
.node-vm-size
: the cluster is deployed with Azure VM instances of sizeStandard_D8s_v3
for worker nodes. See VM sizes and Sizes for cloud services for more details.node-osdisk-type
:Managed
node disks are used sinceEphemeral
ones are better suited when applications are tolerant of individual VM failures, which is not the case for CKF.ssh-key-value
: public key path or key contents to access individual nodes using SSH. Its default value is~\.ssh\id_rsa.pub
.
Spinning up the cluster may take some time to complete.
Verify access to the cluster
Check if the AKS cluster has been added to kubeconfig
as follows:
kubectl config get-clusters
If you don’t see it there, use the following command to add it:
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster --admin
You may need to remove --admin
from the command above, depending on the type of kubeconfig
that you have access to.
Now check your access to the cluster as follows:
kubectl get nodes
You should expect an output like the following:
NAME STATUS ROLES AGE VERSION
aks-nodepool1-18441560-vmss000000 Ready agent 1m20s v1.29.4
aks-nodepool1-40664177-vmss000001 Ready agent 1m20s v1.29.4
Set up Juju
- Install Juju:
sudo snap install juju --channel=3.4/stable
- Add your AKS cluster as a cloud to Juju:
juju add-k8s aks --client
- Bootstrap a Juju controller:
juju bootstrap aks aks-controller
See Get started with Juju for more details.
Deploy CKF
To deploy CKF and access its dashboard, follow the steps provided in the general installation guide from creating the kubeflow
model section.
Clean up resources
You can delete the AKS cluster and related resources as follows:
az aks delete --resource-group myResourceGroup --name myAKSCluster --yes
az group delete --name myResourceGroup --yes
You can check if a resource group exists using:
az group exists --name <resource-group-name>
See Azure resource manager for further information.
To clean up Juju resources, run the following commands:
juju unregister aks-controller
juju remove-cloud aks --client