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 el operador de controladores MongoDB para Kubernetes en el mongodb Espacio de nombres con la opción --create-namespace. De forma predeterminada, el operador de Kubernetes usa el espacio de nombres default.

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

Configure para kubectl que el valor predeterminado sea su espacio de nombres.

Si aún no lo ha hecho, ejecute el siguiente comando para ejecutar todos los comandos kubectl en el espacio de nombres que creó:

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

Configurar el operador de Kubernetes

1. Vaya 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.

Copie y guarde el ConfigMap.

Copie y guarde 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.

Copia y guarda el secreto.

Copie y guarde 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 solo una 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

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

Puede optar por usar una contraseña de texto simple o una contraseña codificada en Base64. Las contraseñas de texto simple usan stringData.password y las contraseñas codificadas en Base64usan 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. Copie y guarde el siguiente archivo de 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 usuario recién creado en Cloud Manager o Ops Manager.

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

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

2. Haga 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 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.