Siga los pasos para su tipo de implementación para comenzar a administrar su MongoDB Enterprise y Implementaciones deOps Manager con controladores MongoDB para el operador de Kubernetes en lugar del operador de Kubernetes de MongoDB Enterprise.
Migrar de 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:
Realizar una copia de seguridad de
kubectlBinario del complemento. Esto facilita revertir la migración a Controladores MongoDB para el Operador de Kubernetes si surgen problemas.Configure los clústeres de miembros mediante siguiendo la documentación de configuración de múltiples clústeres (asegurándose de utilizar el complemento
kubectlde la versión MongoDB Controllers for Kubernetes Operator) o utilizando manualmente la plantilla 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.
Instale manualmente los controladores MongoDB para los CRD del operador 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 MongoDB para el operador Kubernetes.
Elija uno de los siguientes métodos de instalación:
Advertencia
Si ha anulado los valores predeterminados del gráfico de Helm para su implementación de Enterprise Kubernetes Operator, no debe usar los mismos valores para su implementación de MongoDB Controllers para Kubernetes Operator, ya que los nombres de 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.7.0/public/mongodb-kubernetes.yaml
El conciliador de operadores de controladores MongoDB para Kubernetes ejecuta y procesa los recursos personalizados existentes.
El operador de controladores MongoDB para Kubernetes aplica imágenes actualizadas, ServiceAccounts y otros recursos.
Si tiene configuraciones de seguridad personalizadas para las imágenes del contenedor de inicio, actualice sus archivos YAML para usar 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.
De forma predeterminada, el operador de Controladores MongoDB para Kubernetes no concilia varios recursos en paralelo. Para cambiar el comportamiento predeterminado, consulte https://github.com/mongodb/mongodb-kubernetes/blob/master/public/mongodb-kubernetes.yaml#L358 y aumente la MDB_MAX_CONCURRENT_RECONCILES variable de entorno.
Eliminar activos antiguos.
Ahora puede eliminar el gráfico de Helm para el operador de Kubernetes de MongoDB Enterprise, así como los RBAC en todos los clústeres de Kubernetes y cualquier binario del complemento 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 clústeres OpenShift, pero también posible en otras plataformas 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.
Eliminar el ClusterServiceVersion (CSV) del antiguo operador de Kubernetes de MongoDB Enterprise.
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>
Instale MongoDB Controllers para Kubernetes Operator desde un catálogo disponible en su clúster.
MongoDB Controllers for Kubernetes Operator está disponible en el catálogo de operadores certificados de Red Hat, así como en el catálogo de operatorhub.io.
kubectl create -f <path-to-bundle>
Migración del operador de Kubernetes comunitario al operador de controladores MongoDB para Kubernetes
Consulte los siguientes recursos para aprender a migrar a los controladores MongoDB para el operador de Kubernetes: