Nota
Este tutorial presupone cierto conocimiento de Kubernetes. Si no está familiarizado con Kubernetes, consulte la documentación sobre objetos y recursos personalizados antes de comenzar. El operador de Kubernetes representa las implementaciones de Ops Manager y MongoDB como recursos personalizados. Puede crearlos y gestionarlos con kubectl del mismo modo que gestiona cualquier otro objeto de Kubernetes. Para obtener más información sobre la relación entre estos recursos personalizados, consulte la descripción general de la arquitectura de los controladores de MongoDB para el operador de Kubernetes.
Requisitos previos
Complete los siguientes requisitos previos antes de instalar el operador de Kubernetes:
Contar con una solución de Kubernetes disponible para su uso y verificar el soporte de la arquitectura del hardware.
Si necesitas una solución de Kubernetes, consulta la documentación de Kubernetes para elegir la solución adecuada. Revisar arquitecturas de hardware compatibles.
Clona el repositorio de MongoDB Controllers for Kubernetes Operator y selecciona la etiqueta de la versión actual.
git clone https://github.com/mongodb/mongodb-kubernetes.git cd mongodb-kubernetes git checkout 1.10.0
Nota
Puede utilizar Helm para instalar el Operador de Kubernetes. Para aprender cómo instalar Helm, consulta su documentación en GitHub.
Crea un namespace para tu implementación de Kubernetes.
Por defecto, el operador Kubernetes utiliza el namespace mongodb. Para simplificar su instalación, considere crear un namespace etiquetado como mongodb usando el siguiente comando kubectl:
kubectl create namespace mongodb
Si no deseas usar el espacio de nombres mongodb, puedes etiquetar tu espacio de nombres como quieras:
kubectl create namespace <namespaceName>
Opcional: Tener un Ops Manager en funcionamiento.
Si no implementas un recurso de Ops Manager con el Operador de Kubernetes, debes tener un Ops Manager funcionando fuera de tu clúster de Kubernetes. Si vas a implementar un recurso de Ops Manager en Kubernetes con el Operador de Kubernetes, omite este requisito previo.
Importante
Tu instalación de Ops Manager debe ejecutar un servicio NTP activo. Si el reloj del host de Ops Manager se desincroniza, ese host no puede comunicarse con el operador de Kubernetes.
Para aprender cómo verificar tu servicio NTP para tu host de Ops Manager, consulta la documentación para RHEL.
Considerations
Revise los siguientes temas de planificación. Para obtener más información, consulte Planifique la instalación de su operador de Kubernetes.
Decida si desea instalar en un solo clúster de Kubernetes o en varios clústeres de Kubernetes. Consulte Elija el modo de instalación de clúster único o múltiple.
Confirme que sus versiones de Kubernetes, OpenShift, MongoDB y MongoDB Ops Manager son compatibles. Consulte Controladores de MongoDB para la compatibilidad con el operador de Kubernetes.
Establezca el ámbito de la implementación del operador Kubernetes, que determina los namespace que supervisa el operador Kubernetes. Consulte Establecer el ámbito de los controladores de MongoDB para la implementación del operador Kubernetes.
Aplique las recomendaciones de producción para el almacenamiento, la persistencia y los límites de CPU y memoria. See mejores prácticas.
Instala con Kubernetes
El procedimiento de instalación varía según cómo desees configurar tu entorno:
Nota
Se puede usar el mismo namespace siempre
Por defecto, el operador de Kubernetes implementa todos los recursos de tu clúster de Kubernetes en el namespace mongodb. Puedes implementar recursos de operador de Kubernetes en otro namespace diferente editando todos los valores para metadata.namespace en mongodb-kubernetes.yaml. También debe actualizar el valor subjects[0].namespace en cada RoleBinding y ClusterRoleBinding en el mismo archivo. Si omite este valor, los enlaces buscan el ServiceAccount en el namespace mongodb por defecto y no lo encuentran:
apiVersion: v1 kind: ServiceAccount metadata: name: mongodb-kubernetes-operator namespace: production apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: name: mongodb-kubernetes-operator namespace: production roleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-operator subjects: - kind: ServiceAccount name: mongodb-kubernetes-operator namespace: production apiVersion: apps/v1 kind: Deployment metadata: name: mongodb-kubernetes-operator namespace: production # Example truncated ...
Opcional: Personalizar YAML del operador de Kubernetes antes de instalarlo.
Para aprender sobre la configuración opcional de instalación de Kubernetes Operator, se puede consultar Configuración de instalación de kubectl y oc del operador.
Nota
Para habilitar la vista previa pública de contenedores estáticos, que mejoran y simplifican la seguridad, consulta Contenedores estáticos (vista previa pública). No recomendamos usar esta funcionalidad en producción mientras está en vista previa pública. Para aprender más, consultar Funcionalidades de la vista previa.
Utiliza los MongoDB Helm Charts para Kubernetes.
Nota
Desuso del repositorio de gráficos Helm
La instalación del operador de Kubernetes desde el repositorio de gráficos Helm de MongoDB para Kubernetes está obsoleta y se eliminará en la versión MCK 2.0. Para instalar el gráfico Helm desde el registro compatible con OCI, consulte la pestaña "Uso de Helm (registro compatible con OCI)".
Añada los Helm Charts de MongoDB para Kubernetes.
Puedes añadir la gráfica Helm del operador de Kubernetes localmente ejecutando:
helm repo add mongodb https://mongodb.github.io/helm-charts
Personaliza tu gráfica de Helm antes de implementarla.
Para aprender más sobre las configuraciones opcionales de instalación del operador de Kubernetes, consulta Configuración de instalación del operador de Helm.
Implementa el operador de Kubernetes.
Ejecuta el siguiente comando helm para implementar el operador de Kubernetes en el namespace por defecto de tu clúster de Kubernetes:
helm upgrade --install mongodb-kubernetes-operator mongodb/mongodb-kubernetes
Puedes pasar las banderas --namespace y --create-namespace para implementar el operador de Kubernetes en un namespace que no esté establecido por defecto, de la siguiente manera:
helm upgrade --install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \ --namespace mongodb \ --create-namespace
Instala una compilación diaria específica con Helm
MongoDB reconstruye las imágenes del operador de Kubernetes todos los días para integrar las últimas actualizaciones de seguridad y del sistema operativo.
Por defecto, helm instala la última compilación para la versión del operador de Kubernetes que especifiques.
Para instalar una versión anterior, especifica el ID de compilación como un parámetro con --set build=<build-id>. Los IDs de compilación siempre están en el formato -b<YYYYMMDD>T000000Z, donde <YYYYMMDD> es la fecha en que se creó la compilación que quieres utilizar.
Ejemplo
Este ejemplo muestra cómo instalar el Operador de Kubernetes con la imagen más reciente:
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes
Este ejemplo muestra cómo instalar el operador de Kubernetes con la imagen creada en la medianoche del 5 de febrero de 2021:
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \ --set build=-b20210205T000000Z
Nota
MongoDB recomienda usar el compilado por defecto (más reciente).
MongoDB también publica la gráfica Helm del operador de Kubernetes en un registro de contenedores compatible con OCI en quay.io/mongodb/helm-charts. Cuando instale desde este registro, referencia la gráfica directamente en lugar de agregar el repositorio de gráficas de Helm.
Personaliza tu gráfica de Helm antes de implementarla.
Para aprender más sobre las configuraciones opcionales de instalación del operador de Kubernetes, consulta Configuración de instalación del operador de Helm.
Implementa el operador de Kubernetes.
Ejecuta el siguiente comando helm para implementar el operador de Kubernetes en el namespace por defecto de tu clúster de Kubernetes:
helm upgrade --install mongodb-kubernetes-operator \ oci://quay.io/mongodb/helm-charts/mongodb-kubernetes
Para implementar el operador de Kubernetes en un namespace no por defecto, pase las banderas --namespace y --create-namespace:
helm upgrade --install mongodb-kubernetes-operator \ oci://quay.io/mongodb/helm-charts/mongodb-kubernetes \ --namespace mongodb \ --create-namespace
Instala con OpenShift
Antes de comenzar, asegúrate de que el indicador MANAGED_SECURITY_CONTEXT esté configurado en true cuando implementes el operador de Kubernetes en OpenShift. Este valor está predefinido en el archivo values-openshift.yaml.
El procedimiento de instalación varía según cómo desees configurar tu entorno:
Nota
Se puede usar el mismo namespace siempre
Por defecto, el operador de Kubernetes implementa todos los recursos de tu clúster de Kubernetes en el namespace mongodb. Puedes implementar recursos de operador de Kubernetes en otro namespace diferente editando todos los valores para metadata.namespace en mongodb-kubernetes-openshift.yaml. También debe actualizar el valor subjects[0].namespace en cada RoleBinding y ClusterRoleBinding en el mismo archivo. Si omite este valor, los enlaces buscan el ServiceAccount en el namespace mongodb por defecto y no lo encuentran:
apiVersion: v1 kind: ServiceAccount metadata: name: mongodb-kubernetes-operator namespace: production apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: name: mongodb-kubernetes-operator namespace: production roleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-operator subjects: - kind: ServiceAccount name: mongodb-kubernetes-operator namespace: production apiVersion: apps/v1 kind: Deployment metadata: name: mongodb-kubernetes-operator namespace: production # Example truncated ...
Clona el repositorio de MongoDB Controllers for Kubernetes Operator y selecciona la etiqueta de la versión actual.
Invoca los siguientes comandos git:
git clone https://github.com/mongodb/mongodb-kubernetes.git cd mongodb-kubernetes git checkout 1.10.0
Ir hasta el directorio en el que se clonó el repositorio de los controladores de MongoDB para el operador de Kubernetes.
Por ejemplo, si se ha clonado el repositorio en el directorio principal, se debe ejecutar:
cd ~/mongodb-kubernetes
Instale CustomResourceDefinitions para implementaciones de MongoDB.
Invoca el siguiente comando oc:
oc apply -f crds.yaml
Opcional: Personalizar YAML del operador de Kubernetes antes de instalarlo.
Para aprender sobre la configuración opcional de instalación de Kubernetes Operator, se puede consultar Configuración de instalación de kubectl y oc del operador.
Nota
Para habilitar la vista previa pública de contenedores estáticos, que mejoran y simplifican la seguridad, consulta Contenedores estáticos (vista previa pública). No recomendamos usar esta funcionalidad en producción mientras está en vista previa pública. Para aprender más, consultar Funcionalidades de la vista previa.
Añada <openshift-pull-secret> a las definiciones ServiceAccount en YAML del operador de Kubernetes antes de instalarlo.
apiVersion: v1 kind: ServiceAccount metadata: name: enterprise-operator namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret> apiVersion: v1 kind: ServiceAccount metadata: name: mongodb-kubernetes-appdb namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret> apiVersion: v1 kind: ServiceAccount metadata: name: mongodb-kubernetes-database-pods namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret>
Para obtener más información, se puede consultar la configuración registry.imagePullSecrets en la configuración de instalación de Helm.
Utiliza los MongoDB Helm Charts para Kubernetes.
Nota
Desuso del repositorio de gráficos Helm
La instalación del operador de Kubernetes desde el repositorio de gráficos Helm de MongoDB para Kubernetes está obsoleta y se eliminará en la versión MCK 2.0. En su lugar, instale el gráfico Helm desde el registro compatible con OCI en quay.io/mongodb/helm-charts.
Puedes instalar el operador de Kubernetes con Helm 3.
Agrega el repositorio Helm Charts de MongoDB para Kubernetes a Helm.
helm repo add mongodb https://mongodb.github.io/helm-charts
Instale el operador Kubernetes utilizando helm.
Instala los Helm Charts de MongoDB para Kubernetes:
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \ --values https://raw.githubusercontent.com/mongodb/helm-charts/main/charts/mongodb-kubernetes/values-openshift.yaml
Usa la configuración del archivo values-openshift.yaml. Para aprender sobre la configuración de instalación opcional del operador de Kubernetes, consulta Configuración de instalación del operador de Helm.
Nota
Para habilitar la vista previa pública de contenedores estáticos, que mejoran y simplifican la seguridad, consulta Contenedores estáticos (vista previa pública). No recomendamos usar esta funcionalidad en producción mientras está en vista previa pública. Para aprender más, consultar Funcionalidades de la vista previa.
Instala una compilación diaria específica con Helm
MongoDB reconstruye las imágenes del operador de Kubernetes todos los días para integrar las últimas actualizaciones de seguridad y del sistema operativo.
Por defecto, helm instala la última compilación para la versión del operador de Kubernetes que especifiques.
Para instalar una versión anterior, especifica el ID de compilación como un parámetro con --set build=<build-id>. Los IDs de compilación siempre están en el formato -b<YYYYMMDD>T000000Z, donde <YYYYMMDD> es la fecha en que se creó la compilación que quieres utilizar.
Ejemplo
Este ejemplo muestra cómo instalar el Operador de Kubernetes con la imagen más reciente:
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes
Este ejemplo muestra cómo instalar el operador de Kubernetes con la imagen creada en la medianoche del 5 de febrero de 2021:
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \ --set build=-b20210205T000000Z
Nota
MongoDB recomienda usar el compilado por defecto (más reciente).
Verifica la instalación
Para verificar que el Operador de Kubernetes se instaló correctamente, ejecuta el siguiente comando y verifica el resultado:
kubectl describe deployments mongodb-kubernetes-operator -n <metadata.namespace>
oc describe deployments mongodb-kubernetes-operator -n <metadata.namespace>
Por defecto, las implementaciones existen en el namespace mongodb. Si aparece el siguiente mensaje de error, asegúrate de utilizar el namespace correcto:
Error from server (NotFound): deployments.apps "mongodb-kubernetes-operator" not found
Para solucionar problemas de tu operador de Kubernetes, consulta Revisión de registros del operador de Kubernetes y otros temas de solución de problemas.
Importante
Si necesitas eliminar el operador Kubernetes o el namespace, primero debes eliminar los recursos de MongoDB.
Próximos pasos
Después de instalar el operador de MongoDB para los controladores de Kubernetes, puedes hacer lo siguiente: