Siga los pasos para su tipo de implementación para comenzar a gestionar sus implementaciones de MongoDB Enterprise y Ops Manager con MongoDB Controllers para Kubernetes Operator en lugar de la MongoDB Enterprise Kubernetes Operator.
Migrar del MongoDB Enterprise Operator a MongoDB Controllers for Kubernetes Operator para la mayoría de las implementaciones
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.
Actualiza a la v1.33 del MongoDB Enterprise Kubernetes Operator.
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.
Realice las dos siguientes tareas si ha implementado recursos con MCG en varios clústeres de Kubernetes:
Haz una copia de seguridad del binario del complemento
kubectl. Esto facilita revertir la migración hacia los controladores de MongoDB para el operador de Kubernetes si surgen problemas.Configura los clústeres miembro ya sea siguiendo la documentación de configuración multicuster (asegurándose de usar el plugin
kubectlde la versión de MongoDB Controllers for Kubernetes Operator) o manualmente utilizando plantillas 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 elmongodb-kubernetes-operator-member-listesté presente en su clúster de 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 tu implementación a 1.0.1, recomendamos que actualices MongoDB Controllers for Kubernetes operador directamente a la última versión disponible, omitiendo cualquier versión intermedia. Puedes utilizar el procedimiento de actualización normal para esta y todas las futuras actualizaciones.
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
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.8.0/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 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.
Espere a que los recursos se concilien (alcancen la fase de Running) y estén 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 operador a MongoDB Controllers para Kubernetes operador con el operador Lifecycle Manager en OpenShift u otras plataformas
Para migrar desde el Operador MongoDB Enterprise para Kubernetes al Operador MongoDB Controllers para Kubernetes usando OLM (el método de implementación típico en clústeres OpenShift, pero también posible en otras plataformas Kubernetes), desinstala el operador antiguo y luego instala 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.
Actualiza a la v1.33 del MongoDB Enterprise Kubernetes Operator.
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.
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: