Guía de inicio rápido para el Operador de Kubernetes

Agrega el repositorio Helm Charts de MongoDB para Kubernetes a Helm.

helm repo add mongodb https://mongodb.github.io/helm-charts

Instala el operador de los controladores de MongoDB para Kubernetes

Para instalar el operador de Kubernetes con Helm, consulte las instrucciones en el repositorio.

Ejemplo

El siguiente comando instala los Controladores de MongoDB para el operador de Kubernetes en el mongodb namespace con la opción opcional --create-namespace. De forma predeterminada, Kubernetes Operator utiliza el namespace default.

helm install kubernetes-operator mongodb/mongodb-kubernetes --namespace mongodb --create-namespace

Configura kubectl para que se ajuste por defecto a tu espacio de nombres.

Si aún no lo has hecho, ejecuta el siguiente comando para ejecutar todos los comandos kubectl en el namespace que creaste:

kubectl config set-context $(kubectl config current-context) --namespace=mongodb

Configura el operador de Kubernetes

1. Ve a la Página de configuración de Kubernetes en la Interfaz de usuario de Cloud Manager.

2. Haga clic Create New API Keys o Use Existing API Keys.

3. Completa el formulario. Para obtener más información, consulta Acceso programático a Cloud Manager.

4. Haga clic en Generate Key and YAML.

Haz una copia y guarda el ConfigMap.

Copia y guarda el archivo config-map.yaml generado.

Ejemplo:

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-project
  namespace: mongodb
data:
  baseUrl: https://cloud.mongodb.com
  projectName: my-project # this is an optional parameter
  orgId: 5ecd252f8c1a75033c74106c # this is a required parameter

Para obtener más información, consulte las descripciones de los parámetros.

Copiar y guardar el secreto.

Copia y guarda el archivo secret.yaml generado.

Ejemplo:

apiVersion: v1
kind: Secret
metadata:
  name: organization-secret
  namespace: mongodb
stringData:
  publicKey: <public_key>
  privateKey: <private_key>

Por motivos de seguridad, MongoDB Cloud Manager muestra este archivo una sola vez.

Aplica el ConfigMap y el Secret.

Ejecuta el siguiente comando:

kubectl apply -f secret.yaml -f config-map.yaml

Implementar el recurso del conjunto de réplicas de MongoDB.

1. Copie y guarde el siguiente archivo YAML:

   apiVersion: mongodb.com/v1
   kind: MongoDB
   metadata:
     name: demo-mongodb-cluster-1
     namespace: mongodb
   spec:
     members: 3
     version: 8.0.0
     type: ReplicaSet
     security:
       authentication:
         enabled: true
         modes: ["SCRAM"]
     cloudManager:
       configMapRef:
         name: my-project
     credentials: organization-secret
     persistent: true
     podSpec:
       podTemplate:
         spec:
          containers:
           - name: mongodb-enterprise-database
             resources:
               limits:
                 cpu: 2
                 memory: 1.5G
               requests:
                 cpu: 1
                 memory: 1G
               persistence:
                 single:
                   storage: 10Gi

2. Ejecuta el siguiente comando:

   kubectl apply -f <replica-set-conf>.yaml

Crear un secreto con la contraseña del usuario de tu base de datos

Puedes elegir usar una contraseña en texto claro o una contraseña codificada en Base64. Las contraseñas en texto claro usan stringData.password y las contraseñas codificadas en Base64 usan data.password.

Para obtener una contraseña de texto sin formato, cree y guarde el siguiente archivo YAML:

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
stringData:
  password: <my-plain-text-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

Para una contraseña codificada en Base64, cree y guarde el siguiente archivo YAML:

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
data:
  password: <base-64-encoded-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

Cree un usuario de base de datos.

1. Copia y guarda el siguiente archivo Especificación de recursos de usuario de MongoDB:

   apiVersion: mongodb.com/v1
   kind: MongoDBUser
   metadata:
     name: mms-scram-user-1
   spec:
     passwordSecretKeyRef:
       name: mms-user-1-password
       # Match to metadata.name of the User Secret
       key: password
     username: "mms-scram-user-1"
     db: "admin" #
     mongodbResourceRef:
       name: "demo-mongodb-cluster-1"
       # Match to MongoDB resource using authentication
     roles:
     - db: "admin"
       name: "clusterAdmin"
     - db: "admin"
       name: "userAdminAnyDatabase"
     - db: "admin"
       name: "readWrite"

2. Ejecuta el siguiente comando:

   kubectl apply -f <database-user-conf>.yaml

Opcional: Ver el usuarios recién creado en Cloud Manager u Ops Manager.

Puede ver el usuario recién creado en Cloud Manager u Ops Manager:

1. Desde la vista Deployment del Proyecto, haga clic en la pestaña Security.

2. Haz clic en la pestaña anidada MongoDB Users.

Conéctate al set de réplicas de MongoDB.

Realice los siguientes pasos en la aplicación Cloud Manager:

1. Haz clic en Deployment en la navegación izquierda.

2. Haga clic en para la implementación a la que desea conectarse.

3. Haga clic en Connect to this instance.

4. Ejecuta el comando de conexión en una terminal para conectar con la implementación.