Installation & Upgrades

Learn how to install and upgrade the Doppler Kubernetes Operator

Installing

You can install the operator using Helm or kubectl. Both installation methods will use your locally-configured kubectl to:

  • Create a doppler-operator-system namespace
  • Create the resource definition for a DopplerSecret
  • Setup a service account and RBAC role for the operator
  • Create a deployment for the operator inside of the cluster

Using Helm

Add the Doppler helm repository:

helm repo add doppler https://helm.doppler.com

If you've added it previously, make sure it's up-to-date by running helm repo update.

Next, install the helm chart:

helm install --generate-name doppler/doppler-kubernetes-operator

If you'd like, you can include the Operator in your own custom Helm chart by making it a dependency like this:

dependencies:
- name: doppler-kubernetes-operator
  version: 1.5.7
  repository: https://helm.doppler.com

Using kubectl

You can also deploy the operator manually using kubectl by applying the latest installation YAML directly from the Doppler Kubernetes GitHub repository:

kubectl apply -f https://github.com/DopplerHQ/kubernetes-operator/releases/latest/download/recommended.yaml

Upgrading

You can upgrade the operator using Helm or kubectl. Use the method that matches what was used during installation.

Using Helm

You can upgrade using the latest helm chart. It's important to note that the CRD is not automatically updated if you just perform a simple helm upgrade. As such, be sure you follow this process:

# Update doppler Helm repo
helm repo update 

# Update the DopplerSecrets CRD, which is not automatically upgraded by Helm
helm pull doppler/doppler-kubernetes-operator --untar
kubectl apply -f doppler-kubernetes-operator/crds/all.yaml

# Update the chart
helm upgrade <release_name> doppler/doppler-kubernetes-operator

Using kubectl

If you deployed the Operator with kubectl you can upgrade by applying the latest installation YAML directly from the Doppler Kubernetes GitHub repository:

# This operation will also update the DopplerSecrets CRD
kubectl apply -f https://github.com/DopplerHQ/kubernetes-operator/releases/latest/download/recommended.yaml

What’s Next