loading...

MongoDB Enterprise Operator: Deploying MongoDB in AKS

cmendibl3 profile image Carlos Mendible Originally published at carlos.mendible.com on ・3 min read

A couple of weeks ago I was trying to deploy MongoDB in AKS using the MongoDB Enterprise Operator and had trouble finding a simple tutorial to make the thing work. This post intends to fill that gap with a straight to the point approach.

Prerequisites

Be sure to deploy AKS with a set of nodes with at least 8GB of RAM. I used Standard_D3_v2

First clone the MongoDB Enterprise Kubernetes repo

git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git
cd mongodb-enterprise-kubernetes

Enter fullscreen mode Exit fullscreen mode

Create the MongoDB namespace inside your cluster

kubectl create namespace mongodb

Enter fullscreen mode Exit fullscreen mode

Deploy the Custom Resource Definitions

kubectl apply -f crds.yaml

Enter fullscreen mode Exit fullscreen mode

Deploy the MongoDB Enterprise Operator

kubectl apply -f mongodb-enterprise.yaml

Enter fullscreen mode Exit fullscreen mode

Create a secret for the Ops Manager

As part of the installation you’ll have to deploy the Ops Manager to the cluster. Be sure to set a complex password otherwise the Ops Manager wont start.

kubectl create secret generic ops-manager-admin-secret `
  --from-literal=Username="<Username>" `
  --from-literal=Password="<Password>" `
  --from-literal=FirstName="<Name>" `
  --from-literal=LastName="<Last Name>" `
  -n mongodb
Enter fullscreen mode Exit fullscreen mode

Deploy the Ops Manager

Create ops-manager.yaml with the following contents (Note that we are using 1 replica):

---
apiVersion: mongodb.com/v1
kind: MongoDBOpsManager
metadata:
  name: ops-manager
spec:
  # the number of Ops Manager instances to run. Set to value bigger
  # than 1 to get high availability and upgrades without downtime
  replicas: 1

  # the version of Ops Manager distro to use
  version: 4.2.4

  # the name of the secret containing admin user credentials.
  # Either remove the secret or change the password using Ops Manager UI after the Ops Manager
  # resource is created!
  adminCredentials: ops-manager-admin-secret

  # the Ops Manager configuration. All the values must be of type string
  configuration:
    mms.fromEmailAddr: "admin@thecompany.com"

  # the application database backing Ops Manager. Replica Set is the only supported type
  # Application database has the SCRAM-SHA authentication mode always enabled
  applicationDatabase:
    members: 3
    version: 4.2.0
    persistent: true
    podSpec:
      cpu: "0.25"
Enter fullscreen mode Exit fullscreen mode

Deploy the Ops Manager:

kubectl apply -f .\ops-manager.yaml -n mongodb

Enter fullscreen mode Exit fullscreen mode

Wait until the Ops Manager is ready

kubectl get om -n mongodb -o yaml -w

Enter fullscreen mode Exit fullscreen mode

Port Forward so you can access Ops Manager from your PC

kubectl port-forward pods/ops-manager-0 8080:8080 -n mongodb

Enter fullscreen mode Exit fullscreen mode

Setup de Ops Manager

  1. Login into the Ops Manager (http://localhost:8080) using the same user and password you deployed as a secret.

  2. Create an Organization. Copy the Organnization Id so you can use it later.

  3. Create Public & Private Key for the Organization. Copy both keys so you can use them later.

  4. White List the Operator IPs. To get the IPs run:

kubectl get po --selector=app=mongodb-enterprise-operator -n mongodb -o jsonpath='{.items[*].status.podIP}'

Enter fullscreen mode Exit fullscreen mode

Create a secret that will be used by the operator to connect with the ops manager

Use the Public and Private keys copied in previous steps to run tyhe following command:

kubectl -n mongodb `
  create secret generic my-credentials `
  --from-literal="user=<private key>" `
  --from-literal="publicApiKey=<public key>"
Enter fullscreen mode Exit fullscreen mode

Create a project

Create project.yaml with the following contents and be sure to replace the Organization Id you copied in previous steps:

----
apiVersion: v1
kind: ConfigMap
metadata:
  name: mongodb-test
data:
  projectName: mongodb-test
  baseUrl: http://ops-manager-svc.mongodb.svc.cluster.local:8080

  orgId: <Organization Id>

Enter fullscreen mode Exit fullscreen mode

Deploy the project ConfigMap definition:

kubectl apply .\project.yaml -n mongodb

Enter fullscreen mode Exit fullscreen mode

Create a standalone MongoDB instance

Create standalone.yaml with the following contents:

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: my-standalone
spec:
  version: 4.2.1
  type: Standalone
  opsManager:
    configMapRef:
      name: mongodb-test
  credentials: my-credentials

  # This flag allows the creation of pods without persistent volumes. This is for
  # testing only, and must not be used in production. 'false' will disable
  # Persistent Volume Claims. The default is 'true'
  persistent: false

Enter fullscreen mode Exit fullscreen mode

Deploy the standalone MongoDB:

kubectl apply -f .\standalone.yaml -n mongodb

Enter fullscreen mode Exit fullscreen mode

Enjoy! You have MongoDB up and running!

To learn more about the MongoDB Enterprise Operator please check here.

Discussion

pic
Editor guide