Skip to main content

Rancher Desktop Integration

Rancher Desktop is the default Kubernetes provider for UIS. The provision host includes a compatibility layer so scripts written for MicroK8s also work on Rancher Desktop without modification.

MicroK8s Compatibility Layer​

Context Aliasing​

  • MicroK8s uses default as the primary context
  • Rancher Desktop uses rancher-desktop as the primary context
  • UIS creates a default context alias pointing to the rancher-desktop cluster

Storage Class Mapping​

  • MicroK8s uses microk8s-hostpath storage class
  • Rancher Desktop uses local-path storage class
  • UIS creates a microk8s-hostpath alias pointing to local-path

This is set up automatically when the provision host starts.

Troubleshooting​

Context Issues​

Check available contexts:

./uis shell
kubectl config get-contexts

Manually create default context if missing:

kubectl config set-context default --cluster=rancher-desktop --user=rancher-desktop

Storage Class Issues​

Verify the alias exists:

kubectl get storageclass microk8s-hostpath