A newer version of this documentation is available.

View Latest

Operator Configuration


      The Couchbase Autonomous Operator configuration is defined below. When loaded into Kubernetes, it downloads the Operator Docker image, creates the CouchbaseCluster custom resource definition (CRD), and starts listening for CouchbaseCluster events. The Operator uses a deployment so that it can restart if the pod it’s running in dies.

      Most of the fields in the Operator configuration should never be changed and it is recommended that you use the configuration as is. However, there are some exceptions noted below.
      apiVersion: apps/v1
      kind: Deployment
        name: couchbase-operator
        namespace: default
        replicas: 1
              name: couchbase-operator
            - name: couchbase-operator
              image: couchbase/operator:1.0.0
              - couchbase-operator
              - -create-crd
              - name: MY_POD_NAMESPACE
                    fieldPath: metadata.namespace
              - name: MY_POD_NAME
                    fieldPath: metadata.name
                - name: readiness-port
                  containerPort: 8080
                  path: /readyz
                  port: readiness-port
                initialDelaySeconds: 3
                periodSeconds: 3
                failureThreshold: 19
              serviceAccountName: couchbase-operator

      Changing the Namespace

      The Operator manages clusters in the namespace that it’s deployed in. If you want to deploy the Operator in a namespace other than the default namespace, then change the metadata.namespace field.

      Changing the Operator Container Image

      You shouldn’t need to change the Operator image unless you are pulling the image from somewhere other than the official Couchbase Docker repository. If you are pulling the image from somewhere else, change the spec.spec.containers[0].image field.

      Changing the Name

      By default, the name of the deployment that is created to maintain the Operator is called couchbase-operator. It is recommended that you use this name since it is used in all of the examples and tutorials in the Operator documentation. If you need to change it for some reason, ensure that you change the metadata.name, spec.template.metadata.labels.name, and spec.spec.containers[0].name fields. These fields must all have the same value.

      Changing the Service Account

      It is recommended that you use a service account named couchbase-operator, but depending on your environment you may want to use a service account with a different name. Note that this field only takes effect if your Kubernetes environment has RBAC enabled.

      Changing the Replica Count

      Normally deployments are used to create multiple instances of a pod in order to provide redundancy. However, when deploying the Operator, you should always set replicas to 1. This is because the Operator pod uses leader election to ensure that only one Operator is running in a specific namespace. If you start more than one Operator pod in the same namespace, only the first one will start successfully. The Operator uses deployments so that if the Operator dies, a new Operator pod gets created and picks up from where the old one left off.