You are looking at the documentation of a prior release. To read the documentation of the latest release, please visit here.

New to KubeDB? Please start here.

Using private Docker registry

KubeDB operator supports using private Docker registry. This tutorial will show you how to use KubeDB to run MongoDB database using private Docker images.

Before You Begin

  • Read concept of MongoDB Version Catalog to learn detail concepts of MongoDBVersion object.

  • you need to have a Kubernetes cluster, and the kubectl command-line tool must be configured to communicate with your cluster. If you do not already have a cluster, you can create one by using kind.

  • You will also need a docker private registry or private repository. In this tutorial we will use private repository of docker hub.

  • You have to push the required images from KubeDB’s Docker hub account into your private registry. For mongodb, push DB_IMAGE, TOOLS_IMAGE, EXPORTER_IMAGE of following MongoDBVersions, where deprecated is not true, to your private registry.

    $ kubectl get mongodbversions -n kube-system,VERSION:.spec.version,INITCONTAINER_IMAGE:.spec.initContainer.image,DB_IMAGE:.spec.db.image,EXPORTER_IMAGE:.spec.exporter.image
    NAME             VERSION   INITCONTAINER_IMAGE         DB_IMAGE                                 EXPORTER_IMAGE
    3.4.17-v1        3.4.17    kubedb/mongodb-init:4.1     kubedb/mongo:3.4.17-v1                   kubedb/percona-mongodb-exporter:v0.8.0
    3.4.22-v1        3.4.22    kubedb/mongodb-init:4.1     kubedb/mongo:3.4.22-v1                   kubedb/percona-mongodb-exporter:v0.8.0
    3.6.13-v1        3.6.13    kubedb/mongodb-init:4.1     kubedb/mongo:3.6.13-v1                   kubedb/percona-mongodb-exporter:v0.8.0
    3.6.18-percona   3.6.18    kubedb/mongodb-init:4.1     percona/percona-server-mongodb:3.6.18    kubedb/percona-mongodb-exporter:v0.8.0
    3.6.8-v1         3.6.8     kubedb/mongodb-init:4.1     kubedb/mongo:3.6.8-v1                    kubedb/percona-mongodb-exporter:v0.8.0
    4.0.10-percona   4.0.10    kubedb/mongodb-init:4.1     percona/percona-server-mongodb:4.0.10    kubedb/percona-mongodb-exporter:v0.8.0
    4.0.11-v1        4.0.11    kubedb/mongodb-init:4.1     kubedb/mongo:4.0.11-v1                   kubedb/percona-mongodb-exporter:v0.8.0
    4.0.3-v1         4.0.3     kubedb/mongodb-init:4.1     kubedb/mongo:4.0.3-v1                    kubedb/percona-mongodb-exporter:v0.8.0
    4.0.5-v3         4.0.5     kubedb/mongodb-init:4.1     kubedb/mongo:4.0.5-v3                    kubedb/percona-mongodb-exporter:v0.8.0
    4.1.13-v1        4.1.13    kubedb/mongodb-init:4.2     kubedb/mongo:4.1.13-v1                   kubedb/percona-mongodb-exporter:v0.8.0
    4.1.4-v1         4.1.4     kubedb/mongodb-init:4.1.4   kubedb/mongo:4.1.4-v1                    kubedb/percona-mongodb-exporter:v0.8.0
    4.1.7-v3         4.1.7     kubedb/mongodb-init:4.2     kubedb/mongo:4.1.7-v3                    kubedb/percona-mongodb-exporter:v0.8.0
    4.2.3            4.2.3     kubedb/mongodb-init:4.2     kubedb/mongo:4.2.3                       kubedb/percona-mongodb-exporter:v0.8.0
    4.2.7-percona    4.2.7     kubedb/mongodb-init:4.2     percona/percona-server-mongodb:4.2.7-7   kubedb/percona-mongodb-exporter:v0.8.0

    Docker hub repositories:

  • Update KubeDB catalog for private Docker registry. Ex:

kind: MongoDBVersion
  name: "4.2.3"
    app: kubedb
  version: "4.2.3"
    image: "PRIVATE_DOCKER_REGISTRY/mongo:4.2.3"
    image: "PRIVATE_DOCKER_REGISTRY/percona-mongodb-exporter:v0.8.0"
    image: "PRIVATE_DOCKER_REGISTRY/mongodb-init:4.2"
    databasePolicyName: mongodb-db
    image: "PRIVATE_DOCKER_REGISTRY/replication-mode-detector:v0.3.2"

Create ImagePullSecret

ImagePullSecrets is a type of a Kubernete Secret whose sole purpose is to pull private images from a Docker registry. It allows you to specify the url of the docker registry, credentials for logging in and the image name of your private docker image.

Run the following command, substituting the appropriate uppercase values to create an image pull secret for your private Docker registry:

$ kubectl create secret docker-registry -n demo myregistrykey \
  --docker-server=DOCKER_REGISTRY_SERVER \
  --docker-username=DOCKER_USER \
  --docker-email=DOCKER_EMAIL \
secret/myregistrykey created

If you wish to follow other ways to pull private images see official docs of kubernetes.

NB: If you are using kubectl 1.9.0, update to 1.9.1 or later to avoid this issue.

Install KubeDB operator

When installing KubeDB operator, set the flags --docker-registry and --image-pull-secret to appropriate value. Follow the steps to install KubeDB operator properly in cluster so that to points to the DOCKER_REGISTRY you wish to pull images from.

Create Demo namespace

To keep things isolated, this tutorial uses a separate namespace called demo throughout this tutorial. Run the following command to prepare your cluster for this tutorial:

$ kubectl create ns demo
namespace/demo created

Deploy MongoDB database from Private Registry

While deploying MongoDB from private repository, you have to add myregistrykey secret in MongoDB spec.imagePullSecrets. Below is the MongoDB CRD object we will create.

kind: MongoDB
  name: mgo-pvt-reg
  namespace: demo
  version: 4.2.3
    storageClassName: "standard"
    - ReadWriteOnce
        storage: 1Gi
      - name: myregistrykey

Now run the command to deploy this MongoDB object:

$ kubectl create -f created

To check if the images pulled successfully from the repository, see if the MongoDB is in running state:

$ kubectl get pods -n demo -w
NAME            READY     STATUS              RESTARTS   AGE
mgo-pvt-reg-0   0/1       Pending             0          0s
mgo-pvt-reg-0   0/1       Pending             0          0s
mgo-pvt-reg-0   0/1       ContainerCreating   0          0s
mgo-pvt-reg-0   1/1       Running             0          5m

$ kubectl get mg -n demo
mgo-pvt-reg   4.2.3     Ready     38s


You can specify imagePullSecret for Snapshot objects in spec.podTemplate.spec.imagePullSecrets field of Snapshot object. If you are using scheduled backup, you can also provide imagePullSecret in backupSchedule.podTemplate.spec.imagePullSecrets field of MongoDB crd. KubeDB also reuses imagePullSecret for Snapshot object from spec.podTemplate.spec.imagePullSecrets field of MongoDB crd.

Cleaning up

To cleanup the Kubernetes resources created by this tutorial, run:

kubectl patch -n demo mg/mgo-pvt-reg -p '{"spec":{"terminationPolicy":"WipeOut"}}' --type="merge"
kubectl delete -n demo mg/mgo-pvt-reg

kubectl delete ns demo

Next Steps