Importante
Esta sección es solo para implementaciones de un solo clúster de Kubernetes. Para implementaciones multidistribuidas de clústeres de MongoDB, consulte la Visión general.
El operador de MongoDB Controllers para Kubernetes utiliza la API de Kubernetes y herramientas para gestionar clústeres de MongoDB que se ejecutan en su clúster de Kubernetes. El operador de Kubernetes funciona junto con MongoDB Ops Manager. Este tutorial demuestra cómo implementar MongoDB Ops Manager en Kubernetes y luego implementar y conectarse a su primer set de réplicas de MongoDB con el operador de Kubernetes. Puede usar Kind para configurar rápidamente un clúster. Para aprender más, consulta Tipo.
Requisitos previos
Este tutorial requiere:
Un clúster de Kubernetes en ejecución.
Helm instalado en su máquina local.
Nodos de Kubernetes ejecutándose en arquitecturas de hardware compatibles.
El Shell de MongoDB instalado en tu máquina local.
Si utiliza Kind con Docker Desktop, asigne al menos ** 8 GB de memoria** y 4 ** CPU** en la configuración de recursos de Docker Desktop. MongoDB Ops Manager requiere un mínimo de 5 GB de memoria para la aplicación y recursos adicionales para la base de datos de la aplicación y el operador de Kubernetes.
Procedimiento
Agrega el repositorio Helm Charts de MongoDB para Kubernetes a Helm.
helm repo add mongodb https://mongodb.github.io/helm-chartsInstala 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-namespaceCree el secreto de credenciales de administrador de MongoDB Ops Manager.
Cree un secreto que contenga las credenciales iniciales del usuario administrador de Ops Manager. El operador de Kubernetes utiliza este secreto para configurar el primer usuario administrador cuando implementa el recurso de Ops Manager.
Ejecute el siguiente comando, reemplazando los valores de marcador de posición con sus credenciales preferidas:
kubectl create secret generic ops-manager-admin-secret \ --from-literal=Username="<admin-email>" \ --from-literal=Password="<admin-password>" \ --from-literal=FirstName="<first-name>" \ --from-literal=LastName="<last-name>"Nota
Almacene estas credenciales de forma segura. Las necesita para iniciar sesión en la Interfaz de Usuario de MongoDB Ops Manager después de la implementación.
Implemente el recurso de Ops Manager.
Copie y guarde el siguiente archivo YAML como
ops-manager.yaml:apiVersion: mongodb.com/v1kind: MongoDBOpsManagermetadata: name: ops-manager namespace: mongodbspec: replicas: 1 version: "8.0.0" adminCredentials: ops-manager-admin-secret externalConnectivity: type: NodePort configuration: mms.ignoreInitialUiSetup: "true" automation.versions.source: "mongodb" mms.fromEmailAddr: admin@example.com mms.replyToEmailAddr: admin@example.com mms.adminEmailAddr: admin@example.com mms.mail.transport: smtp mms.mail.hostname: localhost mms.mail.port: "25" backup: enabled: false applicationDatabase: topology: SingleCluster members: 3 version: "8.0.0"Para obtener más información, consulte la especificación de recursos de MongoDB Ops Manager.
Ejecuta el siguiente comando:
kubectl apply -f ops-manager.yaml
Espere a que el recurso de Ops Manager alcance el estado de ejecución.
El operador de Kubernetes primero implementa el set de réplicas de la base de datos de la aplicación, luego inicia la aplicación de MongoDB Ops Manager. Este proceso puede tardar varios minutos.
Ejecute el siguiente comando para rastrear el estado de los recursos:
kubectl get om -o yaml -wEspere hasta que la salida muestre las siguientes fases:
status: applicationDatabase: phase: Running opsManager: phase: RunningCuando ambos componentes alcanzan Running, recupere la URL de MongoDB Ops Manager:
kubectl get om ops-manager -o jsonpath='{.status.opsManager.url}'Tenga en cuenta esta URL. Lo necesitará para el ConfigMap en un paso posterior.
Configure el operador de Kubernetes para MongoDB Ops Manager.
Puede utilizar la interfaz de usuario de Ops Manager para generar ConfigMap y Secret, o puede crearlos manualmente.
Primero, reenvíe el puerto de servicio de MongoDB Ops Manager a su máquina local para poder acceder a la Interfaz de Usuario en su navegador:
kubectl port-forward svc/ops-manager-svc-ext 8080:8080Luego, abra http://localhost:8080 en su navegador e inicie sesión con las credenciales que creó en el secreto de administrador.
Para utilizar la Interfaz de Usuario de Ops Manager:
Haz clic en Create New API Keys o Use Existing API Keys.
Complete el formulario. Para obtener más información, consulte Crear credenciales para el operador de Kubernetes.
Haga clic en Generate Key and YAML.
Alternativamente, puede crear el ConfigMap y el secreto manualmente en los siguientes pasos.
Crea y guarda el ConfigMap.
Si generó el ConfigMap desde la interfaz de usuario de Ops Manager, copie y guarde el archivo config-map.yaml generado. De lo contrario, cree y guarde el siguiente archivo. Establezca data.baseUrl en la URL de su instancia de MongoDB Ops Manager desde status.opsManager.url.
Ejemplo:
apiVersion: v1kind: ConfigMapmetadata: name: my-project namespace: mongodbdata: baseUrl: http://ops-manager-svc.mongodb.svc.cluster.local:8080 projectName: my-project orgId: <your-org-id>Reemplace <your-org-id> con el Identificador de la Organización de MongoDB Ops Manager. Puede encontrar este valor en la URL de la interfaz de usuario de MongoDB Ops Manager: http://<ops-manager-url>/v2#/org/<orgId>/projects.
Para obtener más información, consulte las descripciones de los parámetros.
Crear y guardar el secreto.
Si generó el secreto desde la Interfaz de Usuario de MongoDB Ops Manager, copie y guarde el archivo secret.yaml generado. De lo contrario, cree un secreto que contenga las claves de API de su organización de MongoDB Ops Manager.
Ejemplo:
apiVersion: v1kind: Secretmetadata: name: organization-secret namespace: mongodbstringData: publicKey: <public_key> privateKey: <private_key>Para crear claves de API programáticas, consulte Crear credenciales para el operador de Kubernetes.
Implemente el recurso conjunto de réplicas de MongoDB.
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"] opsManager: 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: 10GiEjecuta el siguiente comando:
kubectl apply -f <replica-set-conf>.yaml
Cree un secreto con la contraseña del usuario de base de datos.
Elija una contraseña para su usuario de base de datos de MongoDB y almacénela en un secreto. Esta contraseña puede ser cualquier valor que elija. Hará referencia a este secreto cuando cree el usuario de base de datos en el siguiente paso.
Puedes almacenar la contraseña como texto sin formato (usando stringData) o como un valor codificado en Base64(usando data).
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.keyPara 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.keyReemplace el marcador de posición con la contraseña elegida. Para obtener más información, consulte Gestionar usuarios de bases de datos utilizando autenticación SCRAM.
Cree un usuario de base de datos.
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"Ejecuta el siguiente comando:
kubectl apply -f <database-user-conf>.yaml
Conéctate al set de réplicas de MongoDB.
Realice los siguientes pasos en la aplicación MongoDB Ops Manager:
Haz clic en Deployment en la navegación izquierda.
Haga clic en para la implementación a la que desea conectarse.
Haga clic en Connect to this instance.
Ejecuta el comando de conexión en una terminal para conectar con la implementación.