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
/ /

Notas de versión de MongoDB Controllers for Kubernetes operador

Publicado 04 de septiembre de 2025

  • Soporte multiarquitectura

    • Agrega soporte integral de múltiples arquitecturas para el operador de Kubernetes.

    • Soporta implementación en arquitecturas IBM Power (ppc64le) e IBM Z (s390x) junto con soporte existente x86_64.

    • Las imágenes principales (operador, agente, contenedores de inicialización, base de datos, sonda de preparación) ahora admiten múltiples arquitecturas. Sin embargo, esta versión no incluye compatibilidad con IBM y ARM para Ops Manager y... mongodb-kubernetes-init-ops-manager imágenes.

      Nota

      Esta versión migra las imágenes de MongoDB Agent a un nuevo repositorio de contenedores, quay.io/mongodb/mongodb-agent.

      • Los agentes en el nuevo repositorio son compatibles con las arquitecturas x86-64, ARM64, s390x y ppc64le. Para obtener más información, consulte Imágenes de contenedores.

      • El Operador de Kubernetes que ejecuta la versión igual o superior a 1.3.0 y que es estático no puede usar las imágenes de agente del repositorio antiguo de contenedores, quay.io/mongodb/mongodb-agent-ubi.

      No utilice quay.io/mongodb/mongodb-agent-ubi ya que está disponible únicamente por motivos de compatibilidad con versiones anteriores.

  • Corrige la arquitectura actual para los contenedores de sets con estado, que depende de una "matriz de agentes" para mapear versiones de operadores y agentes. El nuevo diseño elimina la matriz operator-version/agent-version, pero agrega un contenedor adicional que contiene todos los binarios requeridos. Esta arquitectura mapea al contenedor mongodb-database.

  • Corrige un problema en el que la sonda de preparación indicaba que el nodo estaba listo incluso cuando su mecanismo de autenticación no estaba sincronizado con los otros nodos, lo que a veces provocaba reinicios prematuros.

  • Corrige un problema en el que los agentes de MongoDB no seguían la variable de entorno NO_PROXY configurada en el Operador.

  • Cambian los nombres por defecto del webhook ClusterRole y ClusterRoleBinding para que incluyan el namespace, de modo que múltiples instalaciones de operadores en diferentes namespaces no entren en conflicto entre sí.

  • Mueve los permisos opcionales para PersistentVolumeClaim a un rol separado.

    Cuando gestionas al operador con Helm, podías deshabilitar los permisos para los PersistentVolumeClaim recursos operator.enablePVCResize estableciendo false el valor en, que es true por defecto. Si estaban habilitados, estos permisos formaban parte del rol de operador principal. Con este cambio, los permisos tienen un rol independiente.

  • Elimina el subresourceEnabled valor de Helm.

    Esta configuración se true por defecto. Podrías excluir permisos de subrecursos del rol de operador especificando false como valor. Esta configuración se introdujo como una solución temporal para el problema de OpenShift (Error 1803171). El problema ya se ha resuelto y la configuración ya no es necesaria. Por lo tanto, este cambio remueve esta opción de configuración, haciendo que los roles de operador siempre tengan permisos de subrecurso.

  • No incluye imágenes de contenedor para las versiones de Ops Manager 7.0.16, 8.0.8, 8.0.9 y 8.0.10 debido a un error en Ops Manager que impide a los usuarios del Operador de Kubernetes actualizar sus implementaciones de Ops Manager de estas versiones.

Lanzado el 10 de julio 2025

  • Autenticación de usuario OpenID Connect (OIDC)
  • Nuevo CRD ClusterMongoDBRole
    • Agrega un nuevo ClusterMongoDBRole CRD para admitir roles reutilizables en varios clústeres de MongoDB. Esto permite a los usuarios definir roles una vez y reutilizarlos en múltiples recursos de MongoDB o MongoDBMultiCluster.

    • Puedes hacer referencia a este rol utilizando el campo spec.security.roleRefs. Se debe tener en cuenta que solo uno de spec.security.roles y spec.security.roleRefs puede usarse al mismo tiempo.

    • El operador trata los recursos ClusterMongoDBRole como plantillas de rol personalizadas que sólo se utilizan cuando los recursos de bases de datos hacen referencia a ellos.

    • El operador supervisa el nuevo recurso por defecto. Esto significa que el operador requiere que crees un nuevo ClusterRole y ClusterRoleBinding. La gráfica de Helm o el plugin kubectl de MongoDB crea estos ClusterRole y ClusterRoleBinding por defecto. Debe crearlos manualmente si utiliza un método de instalación diferente.

    • Para desactivar este comportamiento en el gráfico de Helm, establezca el valor operator.enableClusterMongoDBRoles en false. Esto desactiva la creación de los recursos RBAC necesarios para el recurso ClusterMongoDBRole, así como su vigilancia.

    • Para omitir la instalación de ClusterRole y ClusterRoleBinding necesarios con el complemento mongodb de kubectl, configure --create-mongodb-roles-cluster-role en false.

    • El nuevo recurso ClusterMongoDBRole está diseñado para ser de solo lectura, lo que significa que puede ser utilizado por implementaciones de MongoDB gestionadas por diferentes operadores.

    • Puede eliminar el recurso ClusterMongoDBRole en cualquier momento, pero el operador no borrará ningún rol que se haya creado utilizando este recurso. Para remover correctamente el acceso, se debe remover manualmente la referencia al ClusterMongoDBRole en los recursos MongoDB o MongoDBMultiCluster.

    • La documentación de referencia de este recurso puede encontrarse en la Especificación de recursos de ClusterMongoDBRole.

  • Soluciona un problema en el que mover un recurso MongoDBMultiCluster a un nuevo proyecto (o una nueva Instancia de Ops Manager) podría dejar la implementación en un estado fallido.

Liberado el 23 de mayo 2025

  • MongoDBSearch (Vista previa privada Community)
    • Agrega soporte para implementar MongoDB Search (Community Private Preview Edition).

    • Permite capacidades de búsqueda vectorial y full-text para implementaciones de MongoDBCommunity.

    • Agrega un nuevo CRD de MongoDB, que es monitoreado por defecto por el Operador de Kubernetes. Para obtener más información, consulta la Guía rápida.

    • La fase de vista previa privada de MongoDBSearch viene con las siguientes limitaciones
      • Versión mínima de MongoDB Community: 8.0.

      • TLS debe estar deshabilitado en MongoDB (la comunicación entre mongot y mongod es en texto simple por ahora).

Liberado el 13 de mayo 2025

  • Agrega las imágenes que faltan de MongoDB Agent en el paquete de Kubernetes operador en el catálogo de OpenShift y en el operatorhub.io catálogo.

  • Agrega el mongodbcommunity CRD faltante de la lista observada en el Helm chart.

Liberado el 9 de mayo 2025

MongoDB está unificando sus ofertas de Kubernetes con la introducción del Operador de Kubernetes. Este nuevo operador es un proyecto de código abierto y representa una fusión del anterior MongoDB Community Operator y el MongoDB Enterprise Kubernetes Operator. Esto facilita la administración, escalado y actualización de tus implementaciones. Los cambios futuros se basarán en esto para alinear más estrechamente la gestión de Community y Enterprise en Kubernetes, y así ofrecer una experiencia aún más sin interrupciones y eficiente.

Como un Proyecto de código abierto, ahora permite contribuciones de la Community, ayudando a impulsar la solución más rápida de errores y la innovación continua.

Los usuarios con contratos que permitían el uso de Enterprise Operator aún pueden aprovechar el nuevo reemplazo, lo que permite a los clientes adoptarlo sin modificar sus contratos. Kubernetes Operator cuenta con la 2.0 licencia Apache, y un archivo de licencia incluido en el repositorio ofrece más detalles.

Los derechos de licencia para todos los demás productos y herramientas de MongoDB, como MongoDB Enterprise Server y Ops Manager, permanecen sin cambios. Si tienes preguntas sobre la concesión de licencias de estos productos o herramientas, comunícate con tu equipo de cuentas de MongoDB.

La migración del Community Kubernetes Operator y el Enterprise Kubernetes Operator al Kubernetes Operator es sin interrupciones: tus implementaciones de MongoDB no se ven afectadas por la actualización y no requieren cambios. Simplemente sigue las instrucciones en la guía de migración.

Continuaremos brindando soporte de mejor esfuerzo para Community Kubernetes Operator durante 6 meses, hasta noviembre de 2025. Cada versión de Enterprise Kubernetes Operator seguirá siendo compatible según la orientaciónactual.

Todas las futuras correcciones de errores y mejoras se lanzarán en nuevas versiones de Kubernetes operador. Animamos a todos los usuarios a planear su migración a Kubernetes operador dentro de estos plazos.

Para ver las notas de versiones anteriores del Operador de Kubernetes, consulta la Documentación heredada.

En esta página