Upgrading

Key Concepts

• Nova Control Plane: The central management unit running on a hosting Kubernetes cluster.
• Nova Agent: The component deployed to each workload cluster for management.
• Workload Cluster: A Kubernetes cluster managed by the Nova Control Plane.
• Hosting Cluster: A Kubernetes cluster where the Nova Control Plane runs.

Upgrade Control plane components

1. Download the tarball for the latest version and unpack it.
2. Make sure there is nova/install/ directory there.
3. To upgrade your control plane components, apply the associated manifests to your hosting cluster:

kubectl --context=${K8S_HOSTING_CLUSTER_CONTEXT} apply -k nova/install/base/control-plane/

4. To upgrade the Nova CRDs, apply the nova_crds.yaml manifest to the Nova Control Plane cluster:

kubectl --context=${NOVA_CONTROLPLANE_CONTEXT} apply -f nova/install/base/crds/nova_crds.yaml --server-side

5. Wait until control plane pods are up and running.

Upgrade Nova agent in the workload cluster

1. Download the tarball for the latest version and unpack it.
2. Make sure there is nova/install/ directory there.
3. Modify the cluster name in the nova/install/overlays/workload-cluster-1/nova_agent.yaml if needed.
4. You can review the changes by running kubectl --context=${K8S_CLUSTER_CONTEXT_1} kustomize nova/install/overlays/workload-cluster-1 (it will output generated manifests)
5. To upgrade your Nova agent in the workload cluster, apply the workload cluster overlay in the correct kube context:

kubectl --context=${K8S_CLUSTER_CONTEXT_1} apply -k nova/install/overlays/workload-cluster-1