The CloudCasa agent OpenShift Helm chart
An OpenShift-specific version of the CloudCasa agent Helm chart is available in Red Hat’s OpenShift Helm Charts repository. This version is essentially the same as the standard Helm chart, but it defaults to retrieving the agent container(s) from Red Hat’s container repo, and it has been certified by Red Hat.
Red Hat’s OpenShift Helm Charts repository comes configured by default starting with OpenShift 4.8. For earlier version of OpenShift or other Kubernetes distributions, the following command allows you to access the charts from this repository:
$ helm repo add openshift-helm-charts https://charts.openshift.io/
Helm is also integrated into the OpenShift Dedicated Console (ODC) web terminal. You can use the Helm CLI directly from there if you’ve installed the Web Terminal Operator.
To install the repo to be used from the OpenShift console run the following command as an OpenShift admin:
$ oc apply -f https://charts.openshift.io/openshift-charts-repo.yaml
Installing the CloudCasa agent using the OpenShift Helm chart
Log in to https://home.cloudcasa.io and add your Kubernetes cluster under the Protection tab. Note the returned cluster ID.
See also
For more information on configuring clusters see Overview of Clusters.
Add the OpenShift Helm Charts repo to your Helm configuration if it hasn’t been added already.
helm repo add openshift-helm-charts https://charts.openshift.io/
To install the agent, execute the following helm commands, replacing
<Cluster ID>
with the Cluster ID obtained above:helm repo update helm install cloudcasa openshift-helm-charts/cloudcasa --set clusterID=<Cluster ID>
This will install the CloudCasa agent and complete registration of the cluster with the CloudCasa service.
Using an alternate image repository
The agent manager container can be installed from an alternate repository by setting values for image.repository and image.tag.
Add the options --set image.repository=<repository>
and/or --set image.tag=<tag>
to the helm install command.
Note that the alternate repository will also need to be set for the cluster in CloudCasa so that all agent containers will be loaded from it. This can be done using the Private container registry for agent field under Advanced options in the Add cluster dialog. See Adding a Cluster for more information.
If the registry you are using requires authentication, you can define a Kubernetes secret with the authentication information
and reference it by setting a value for imagePullSecret. Example: --set imagePullSecret=registrySecret
.
See the Kubernetes Docs for more information.
Note that the secret must be created in the cloudcasa-io namespace, so you may need to create the namespace first.
Also note that when uninstalling the agent, you may need to delete the cloudcasa-io namespace manually after running helm uninstall with kubectl delete namespace cloudcasa-io
.
Finally, the secret name will also need to be set in CloudCasa for the cluster, so that it will be used for all agent containers. This can be done using the Image pull secret field under Advanced options in the Add cluster dialog. See Adding a Cluster for more information.
Updating the CloudCasa agent using Helm
Log in to https://home.cloudcasa.io and obtain the cluster ID for your cluster by selecting it under the Protection tab. You can also obtain the current setting for it with the command
helm get values cloudcasa
.Execute the following commands to update the agent, replacing
<Cluster ID>
with the Cluster ID obtained above:$ helm repo update $ helm upgrade cloudcasa openshift-helm-charts/cloudcasa --set clusterID=<Cluster ID>
Uninstalling the CloudCasa agent using Helm
Execute the following command to uninstall the agent:
$ helm uninstall cloudcasa
The agent creates some custom resource definitions on the cluster after installation. If you wish to remove these are well, use the command:
$ kubectl delete crds -l component=kubeagent-backup-helper
If you have questions about accessing the OpenShift Helm Charts repository or using the Helm chart, contact CloudCasa support.