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.
Migrar del MongoDB Enterprise Operator a MongoDB Controllers for Kubernetes Operator para la mayoría de las implementaciones
Siga estos pasos para migrar en la mayoría de los escenarios de implementación. Si utiliza Operator Lifecycle Manager (OLM) para administrar sus implementaciones de operador (normalmente en clústeres de OpenShift), consulte estos pasos.
Actualice a la versión v1.33 del operador Kubernetes de MongoDB Enterprise.
Para obtener instrucciones sobre cómo actualizar desde una versión anterior del operador de Kubernetes a v,1.33 consulte la guía de actualización.
Realice las siguientes dos tareas si ha implementado recursos en varios clústeres de Kubernetes:
Respaldar el
kubectlbinario del complemento. Esto facilita revertir la migración hacia los controladores de MongoDB para el operador de Kubernetes si surgen problemas.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
kubectlde la versión de MongoDB Controllers for Kubernetes Operator) o manualmente utilizando la plantilla de Helm.Importante
Los RBAC de los controladores MongoDB para el operador de Kubernetes deben implementarse en los clústeres miembros antes de implementar los controladores MongoDB para el operador de Kubernetes en el paso 5. Los nuevos recursos RBAC comienzan con
mongodb-kubernetes-operator-. También debe asegurarse de quemongodb-kubernetes-operator-member-listesté presente en el clúster del operador después de ejecutar la versión más reciente del binario del complementokubectl.
Instala manualmente los MongoDB Controllers para los CRD del operador de Kubernetes.
kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.0.1/public/crds.yaml
Después de migrar su implementación 1.0.1 a, le recomendamos actualizar MongoDB Controllers for Kubernetes Operator directamente a la última versión disponible, omitiendo las versiones intermedias. Puede usar el procedimiento de actualización habitual para esta y todas las actualizaciones futuras.
Para verificar que los CRD estén instalados en su clúster de Kubernetes, busque el CRD mongodbcommunity:
Tip
Los nombres de los recursos personalizados para Ops Manager y MongoDB Enterprise no han cambiado en los controladores MongoDB para el operador de Kubernetes. Aunque no tenga implementados los recursos de la comunidad MongoDB, buscar recursos personalizados mongodbcommunity es la forma más sencilla de verificar la instalación de los controladores MongoDB para el operador de Kubernetes.
kubectl get crds | grep mongodbcommunity
Instale los nuevos controladores de MongoDB para el operador de Kubernetes.
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.6.1/public/mongodb-kubernetes.yaml
El reconciliador de MongoDB Controllers para Kubernetes operador se ejecuta y procesa los recursos personalizados existentes.
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 activa un reinicio progresivo de los pods implementados, ya que los nombres de RBAC han cambiado de Operador de Kubernetes de MongoDB Enterprise a Operador de Controladores de Kubernetes de MongoDB.
Espere hasta que los recursos se reconcilien (lleguen a la Running fase) y se vuelvan saludables.
Por defecto, los MongoDB Controllers para Kubernetes operador no reconcilian múltiples recursos en paralelo. Para cambiar el comportamiento por defecto, consulta https://github.com/mongodb/mongodb-kubernetes/blob/master/public/mongodb-kubernetes.yaml#L358 y aumenta la variable de entorno MDB_MAX_CONCURRENT_RECONCILES.
Remover activos antiguos.
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.
Migrar de MongoDB Enterprise Kubernetes Operator a MongoDB Controllers for Kubernetes Operator con Operator Lifecycle Manager en OpenShift u otras plataformas
Para migrar del operador de Kubernetes de MongoDB Enterprise al operador de Kubernetes de MongoDB Controllers mediante OLM (el método de implementación típico en los clústeres de OpenShift, pero también se puede utilizar en otras plataformas de Kubernetes), desinstale el operador antiguo y luego instale el nuevo:
Importante
Eliminar el operador de Enterprise Kubernetes no afecta la base de datos ni los recursos de Ops Manager que implemente en Kubernetes. El proceso de migración no afecta sus cargas de trabajo.
Actualice a la versión v1.33 del operador Kubernetes de MongoDB Enterprise.
Para obtener instrucciones sobre cómo actualizar desde una versión anterior del operador de Kubernetes a v,1.33 consulte la guía de actualización.
Borrar el ClusterServiceVersion (CSV) del antiguo MongoDB Enterprise Kubernetes Operator.
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>
Instala los controladores MongoDB para el operador Kubernetes desde un catálogo disponible en tu clúster.
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>
Migrar del Community Kubernetes Operator a los MongoDB Controllers for Kubernetes operador
Consulta los siguientes recursos para aprender a migrar a MongoDB Controllers for Kubernetes Operator: