Upgrading Cosmonic Control

This document contains information on upgrading an existing Cosmonic Control deployment to a new version.

Upgrading from v0.2.0 or lower

In v0.3.0 and higher, there is a change to the CRDs. Performing helm upgrade --install will not upgrade existing CRDs used by Cosmonic Control—this is by Helm's design, in order to avoid any current Custom Resources of the same type in the cluster from being deleted, and thus a potential data loss.

To upgrade, administrators will want to export the new CRDs in the Helm chart to a file, using the following command:

helm show crds charts/cosmonic-control > updated_crds.yaml

Review the updated_crds.yaml file for your own reference. Then you can use kubectl to apply the updated CRDs:

kubectl apply -f updated_crds.yaml

Alternatively, the same actions can be performed with a one-line command:

helm show crds charts/cosmonic-control | kubectl apply -f -