Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /
/ / /

Migra a los controladores de MongoDB para Kubernetes operador

Sigue los pasos para tu tipo de implementación para comenzar a administrar tu MongoDB Enterprise y Implementaciones de Ops Manager con MongoDB Controllers for Kubernetes Operator en lugar del Operador Kubernetes Empresarial de MongoDB.

Sigue estos pasos para migrar en la mayoría de los escenarios de implementación. Si estás utilizando Operator Lifecycle Manager (OLM) para gestionar tus implementaciones del operador (normalmente en clústeres OpenShift), consulta estos pasos en su lugar.

1

Para ver instrucciones sobre cómo actualizar desde una versión anterior del Operador de Kubernetes a v1.33, consulta la guía de actualización.

2

Esto impide que tanto él como MongoDB Controllers for Kubernetes operador se ejecuten en paralelo.

3

Realice las dos siguientes tareas si ha implementado recursos con MCG en varios clústeres de Kubernetes:

  1. Respaldar el kubectl binario del complemento. Esto facilita revertir la migración hacia los controladores de MongoDB para el operador de Kubernetes si surgen problemas.

  2. Configura los clústeres nodos por cualquiera de los siguientes métodos siguiendo la documentación de configuración multi-cluster (asegurándose de usar el plugin kubectl de la versión de MongoDB Controllers for Kubernetes Operator) o manualmente utilizando la plantilla de Helm.

    Importante

    Los MongoDB Controllers for Kubernetes operador: permisos RBAC deben implementarse en los nodos clústeres antes de implementar MongoDB Controllers for Kubernetes operador en el paso 5. Los nuevos recursos de RBAC comienzan con mongodb-kubernetes-operator-. También debe asegurarse de que el mongodb-kubernetes-operator-member-list esté presente en su clúster de operador después de ejecutar la versión más reciente del binario del complemento kubectl.

4
kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.5.0/public/crds.yaml

Para verificar que los CRD están instalados en tu clúster de Kubernetes, busca el CRD mongodbcommunity:

Tip

Los nombres de recursos personalizados para Ops Manager y MongoDB Enterprise no han cambiado en los MongoDB Controllers para el operador Kubernetes. Aunque es posible que no tenga recursos de la comunidad de MongoDB implementados, buscar recursos personalizados mongodbcommunity es la forma más sencilla de verificar la instalación de los controladores de MongoDB para Kubernetes Operator.

kubectl get crds | grep mongodbcommunity
5

Elige uno de los siguientes métodos de instalación:

Advertencia

Si ha anulado los valores por defecto de la gráfica de Helm para su implementación del Enterprise Kubernetes Operator, no debe usar los mismos valores para su implementación del Operador de Controladores de MongoDB para Kubernetes, ya que los nombres de los recursos podrían entrar en conflicto y evitar que la migración se realice correctamente.

helm repo add mongodb https://mongodb.github.io/helm-charts && \
helm repo update && \
helm upgrade --install mongodb-kubernetes-operator mongodb/mongodb-kubernetes --namespace <your-namespace>

Advertencia

Si personalizaste la configuración YAML para tu implementación de Enterprise Kubernetes Operator, asegúrate de que tus personalizaciones sean compatibles con los Controladores de MongoDB para la implementación de Kubernetes operador para evitar conflictos en la nomenclatura de recursos que puedan impedir que la migración sea exitosa.

Ejecuta el siguiente comando kubectl para implementar la versión que elijas del operador de Kubernetes en tu clúster de Kubernetes:

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.5.0/public/mongodb-kubernetes.yaml
6

Los controladores de MongoDB para Kubernetes operador aplican imágenes actualizadas, ServiceAccounts, y otros recursos.

Si tienes configuraciones de seguridad personalizadas para las imágenes de contenedores de inicio, actualiza tus archivos YAML para utilizar el nuevo prefijo mongodb-kubernetes- en lugar de mongodb-enterprise-.

Importante

Este paso desencadena un reinicio en secuencia de los Pods desplegados, ya que los nombres de RBAC han cambiado de MongoDB Enterprise Kubernetes Operator a MongoDB Controllers for Kubernetes Operator.

7

Por defecto, los controladores de MongoDB para Kubernetes Operator no reconcilian múltiples recursos en paralelo. Para cambiar el comportamiento por defecto, consulte https://github.com/mongodb/mongodb-kubernetes/blob/master/public/mongodb-kubernetes.yaml#L358 y aumente la variable ambiente MDB_MAX_CONCURRENT_RECONCILES.

8

Ahora puedes remover la Helm gráfica para MongoDB Enterprise Kubernetes Operator, así como los RBAC en todos los clústeres de Kubernetes y cualquier binario de plugin kubectl respaldado.

Si has implementado recursos en varios clústeres de Kubernetes, ahora puedes remover de manera segura el mongodb-enterprise de los nodos miembros y borrar tu copia de seguridad binaria del complemento kubectl.

Para migrar del MongoDB Enterprise Kubernetes Operator a los MongoDB Controllers para Kubernetes Operator usando OLM (el método de implementación típico en clústeres OpenShift, pero también posible en otras plataformas de Kubernetes), se debe desinstalar el operador antiguo y luego instalar el nuevo:

Importante

Eliminar el Enterprise Kubernetes Operator no afecta a la base de datos ni a los recursos de Ops Manager que se despliegan en Kubernetes. El proceso de migración no afecta sus cargas de trabajo.

1

Reemplace <subscription-namespace> y <subscription-name> con los valores que correspondan a su recurso.

kubectl -n <subscription-namespace> delete subscription <subscription-name>
2

Por lo general, puedes encontrar el nombre del CSV listando los CSVs en el espacio de nombres del operador. Reemplaza <operator-namespace> y <csv-name> con los valores adecuados.

kubectl -n <operator-namespace> delete csv <csv-name>
3

Los controladores de MongoDB para Kubernetes operadores están disponibles en el catálogo de operadores certificados de Red Hat, así como en el operatorhub.io catálogo.

kubectl create -f <path-to-bundle>

Consulta los siguientes recursos para aprender a migrar a MongoDB Controllers for Kubernetes Operator:

Volver

Instalar

En esta página