Kubernetes on Docker Desktop (for learning and development only)#
Important
Docker Desktop is a paid product with a freemium tier for individual developers.
Docker Desktop is bundled with a Kubernetes cluster on a single computer that requires activation in the Docker Desktop’s settings. Docker Desktop is suitable in order to learn about Kubernetes and to develop and test changes, but its not meant to be used for production purposes.
Important
The Zero to JupyterHub guide assumes you’re using a managed Kubernetes service with one of the main cloud platforms and Docker Desktop is not officially supported. You may be able to get help on the Jupyter community forum.
Kubernetes cluster requirements#
All the requirements are implemented in Docker Desktop >= 4.37.1 that includes Kubernetes >= 1.30.5:
Dynamic Volume Provisioning for persistent storage
LoadBalancer or Ingress for managing external access to JupyterHub
Docker Desktop installation#
Follow the installation steps in the offical Docker Desktop’s Manual:
Install Docker Desktop on Linux
If you are on Linux, you might prefer to use minikube following Kubernetes on minikube (for learning and development only).
Kubernetes cluster creation#
Click in
Settings.Click in
Kubernetes.Click in
Enable Kubernetes.Click in
Apply & restart.
To test if your cluster is initialized, run:
kubectl config get-contexts
The response should list the cluster docker-desktop.
kubectl get node
The response should list one running node.
Congrats. Now that you have your Kubernetes cluster running, it’s time to begin Setting up helm.