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 namespace mongodb con la opción opcional --create-namespace. Por defecto, el Operador de Kubernetes utiliza el namespace default.

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

Configura kubectl para que sea por defecto en tu namespace.

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. Haz clic en 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: v1kind: ConfigMapmetadata:  name: my-project  namespace: mongodbdata:  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: v1kind: Secretmetadata:  name: organization-secret  namespace: mongodbstringData:  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

Implemente el recurso conjunto de réplicas de MongoDB.

1. Copie y guarde el siguiente archivo YAML:

   apiVersion: mongodb.com/v1kind: MongoDBmetadata:  name: demo-mongodb-cluster-1  namespace: mongodbspec:  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 una contraseña de texto sin formato, crea y guarda el siguiente archivo YAML:

apiVersion: v1kind: Secretmetadata:  name: mms-user-1-password  # corresponds to user.spec.passwordSecretKeyRef.nametype: OpaquestringData:  password: <my-plain-text-password>  # corresponds to user.spec.passwordSecretKeyRef.key

Para una contraseña codificada en Base64, crear y guardar el siguiente archivo YAML:

apiVersion: v1kind: Secretmetadata:  name: mms-user-1-password  # corresponds to user.spec.passwordSecretKeyRef.nametype: Opaquedata:  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/v1kind: MongoDBUsermetadata:  name: mms-scram-user-1spec:  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, haz clic en la pestaña Security.

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

Conéctese al conjunto de réplicas de MongoDB.

Realiza 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.