If you are upgrading an existing Kubernetes setup to require plane isolation, please read more about the migration process.
The migration process is performed in two stages.
Confirm that your environment has enough hosts with labels for the planes. You can either add new hosts or use existing hosts.
compute=true
. These are the nodes already registered to Kubernetes when you run kubectl get node
. This step is critically important because, without the label, Kubernetes pods will be orphaned on the host during this upgrade. If you have hosts running the kubelet and proxy containers, you can follow the steps of removing them from the compute plane. You can also add more hosts and label these hosts with compute=true
.etcd=true
labels are on those hosts.orchestration=true
. You can get away with 1 host, but you sacrifice high availability. In the event of this host failing, some K8s features such as the API, rescheduling pods in the event of failure, etc. will not occur until a new host is provisioned.required
for Plane Isolation.upgraded
state, click on Upgraded: Finish Upgrade.WARNING: If you plan to remove any hosts from the compute plane, bare pods that aren’t part of a replication controller or similar will not be rescheduled. This is normal behavior.
Hosts in the compute plane are running the kubelet and proxy containers.
compute=true
label, remove the label from the host. This will prevent the kubelet and proxy containers to be re-scheduled onto the host after these containers are deleted.kubectl
through the remote CLI or shell, run kubectl delete node <HOST>
. You can find the hostname (i.e. <HOST>
) from the Rancher UI or from kubectl by running kubectl get node
. Please wait for all pods to be deleted before moving to the next optional step.