Actualiza un clúster a un clúster avanzado

Puedes convertir un clúster de la versión 1.32 en un clúster avanzado actualizándolo in situ en la versión 1.32 o actualizándolo a la versión 1.33. La conversión a un clúster avanzado prepara tu entorno para la versión 1.33 y posteriores, en las que los clústeres avanzados son la arquitectura predeterminada o requerida.

Diferencias clave después de pasar a los clústeres avanzados

Actualizar tu clúster a uno avanzado presenta varias diferencias clave en comparación con los clústeres estándar. Estos son los cambios principales en los clústeres avanzados:

  • Ubicación de los recursos: Los recursos de clúster y de máquina ya no se encuentran en los clústeres de usuario. Estos recursos se encuentran exclusivamente dentro del clúster de administrador.

  • NodeExternalIP: El NodeExternalIP no está configurado en los nodos.

  • Instalación de cert-manager: cert-manager se instala automáticamente en los clústeres avanzados. Si instalaste cert-manager en tu clúster, la actualización al clúster avanzado lo reemplaza por la versión del clúster avanzado.

Diferencias de funciones entre los clústeres avanzados y no avanzados

Cuando habilitas los clústeres avanzados, algunas funciones o capacidades no funcionarán de la misma manera que en los clústeres no avanzados. Algunos de estos cambios solo se aplican a la versión preliminar de los clústeres avanzados en la versión 1.31. Las diferencias se indican en toda la documentación.

En la siguiente tabla, se enumeran las funciones compatibles con Google Distributed Cloud solo software para VMware, su estado de disponibilidad cuando se habilitan los clústeres avanzados y cualquier diferencia en el comportamiento o el uso:

Atributo/función Clústeres de GKE Autopilot 1.31 (versión preliminar) 1.32 No habilitada Clústeres avanzados de la versión 1.32 (DG) Clústeres avanzados de la versión 1.33 (DG) Diferencias
Clústeres avanzados Vista previa DG DG DG No compatible
Dominios de topología Vista previa Vista previa Vista previa Se aplican cambios. Para obtener más información, consulta Configura dominios de topología y las referencias relacionadas con la configuración del clúster.
Membresía de flota regional DG DG DG DG No hay diferencias.
Sesgo de versión n+2 entre el clúster de administrador y el clúster de usuario DG DG DG No se recomienda: No uses esta función, ya que no se admite la administración de un clúster de usuario de versión preliminar inferior.
Sesgo de versiones n+2 del grupo de nodos: clúster de usuario DG DG DG No se recomienda: No uses esta función, ya que no se admite la administración de un clúster de usuario de versión preliminar inferior.
Configuración de aumento máximo para las actualizaciones de grupos de nodos Vista previa Vista previa Vista previa Vista previa No hay diferencias.
cgroup v2 para nodos DG DG DG DG No hay diferencias.
Modo DSR para Dataplane V2 DG DG DG DG No hay diferencias.
Autorización Binaria para clústeres de usuario de Controlplane V2 DG DG DG DG No hay diferencias.
Estación de trabajo de administrador administrada por el usuario DG DG DG DG No hay diferencias.
Herramienta de migración de CSI de StatefulSet DG DG DG DG No hay diferencias.
Migración de Seesaw a MetalLB DG DG DG DG No hay diferencias.
Inhabilita el Ingress agrupado DG DG DG DG No hay diferencias.
Credenciales preparadas del clúster de administrador DG DG DG No hay diferencias.
Política de almacenamiento para un clúster de usuario DG DG DG DG No hay diferencias.
Política de almacenamiento para un clúster de administrador DG DG DG DG No hay diferencias.
Reparación automática de nodos DG DG DG DG Cambios que se aplican: Si el clúster avanzado está habilitado, las verificaciones de estado periódicas no se ejecutan como parte de la reparación automática. Para obtener información y conocer otras diferencias, consulta Reparación automática del nodo y verificación de estado.
Clúster de administrador con alta disponibilidad DG DG DG DG No hay diferencias.
Afinidad de host de VM DG DG DG Se admite en clústeres avanzados en las versiones 1.32.200 y 1.33, y posteriores. Cuando usas dominios de topología, configura grupos de hosts en topologyDomains[i].compute.hostGroups en el archivo de configuración de la infraestructura de vSphere en lugar de nodePools[i].vsphere.hostgroups en el archivo de configuración del clúster de usuario.
Genera archivos de configuración a partir de un clúster existente DG DG DG DG Se aplican cambios. No se admiten los clústeres que usan dominios de topología.
Recopilación de métricas del sistema de Google Cloud Managed Service para Prometheus DG DG DG DG No hay diferencias.
Actualización y reversión de grupos de nodos DG DG DG No hay diferencias.
Actualiza las credenciales del registro privado DG DG DG DG No hay diferencias.
Copia de seguridad y restablecimiento del clúster de administrador con gkectl Vista previa Vista previa DG Se aplican cambios. Se actualizó el comando gkectl para mejorar el restablecimiento de los clústeres de administrador y admitir la creación de copias de seguridad y el restablecimiento de los clústeres de usuario. Para obtener más información, consulta Crea una copia de seguridad y restablece clústeres avanzados con gkectl.
Ajuste de escala automático de grupos de nodos del clúster de usuario DG DG DG DG No hay diferencias.
Cambio automático de tamaño de nodos del clúster DG DG No hay diferencias.
Compatibilidad con varios clústeres de vSphere DG DG DG DG No hay diferencias.
Compatibilidad con varios centros de datos de vSphere DG DG DG DG No hay diferencias.
Compatibilidad de OpenID Connect (OIDC) para la autenticación en clústeres DG DG DG DG No hay diferencias.
Rotación del certificado de CA DG DG DG No hay diferencias.
Compatibilidad con la federación de identidades para cargas de trabajo DG DG DG DG No hay diferencias.
Servicio de identidad de GKE con compatibilidad con la autenticación de LDAP DG DG DG DG No hay diferencias.
Encriptación de secretos siempre activa sin módulo de seguridad de hardware (HSM) DG DG DG No hay diferencias.
Actualiza los Certificados de CA de vCenter con gkectl DG DG DG DG No hay diferencias.
Puerta de enlace NAT de salida DG DG DG DG No hay diferencias.
Registro de la flota del clúster de administrador DG DG DG DG No hay diferencias.
Compatibilidad con grupos de nodos de Windows DG No compatible.
Entorno de ejecución de containerd para el grupo de nodos de Windows DG No compatible.
Compatibilidad con el grupo de nodos de Container-Optimized OS DG DG DG No hay diferencias.
CoreDNS como el proveedor de DNS del clúster DG DG DG DG No hay diferencias.
Ciclo de vida del clúster de usuario en la consola de Google Cloud DG Compatibilidad parcial DG Se aplican cambios. Para obtener más información, consulta Limitaciones avanzadas de los clústeres.
Creación de nodos de clúster de administrador con Container-Optimized OS DG DG DG No hay diferencias.
Capacidad de varias NIC para Pods DG DG DG DG No hay diferencias.
Opción del balanceador de cargas de MetalLB DG DG DG DG Se aplican cambios. Para obtener más información, consulta Balanceo de cargas en paquetes con MetalLB.
Compatibilidad con gkectl update admin para habilitar e inhabilitar Cloud Logging y Cloud Monitoring DG DG DG DG No hay diferencias.
Compatibilidad con Windows Dataplane V2 DG No compatible.
Resumen de las métricas de la API DG DG DG DG No hay diferencias.
Compatibilidad con gkectl update credentials para actualizar la clave de la cuenta de servicio de acceso a los componentes Compatibilidad parcial DG Compatibilidad parcial Compatibilidad parcial Se aplican cambios. Para obtener detalles sobre lo que se admite o no para actualizar las credenciales de los clústeres avanzados, consulta Diferencias de clústeres avanzados para rotar claves de cuentas de servicio.
Credenciales preparadas para el clúster de usuario DG DG DG No hay diferencias.
Actualización de prueba del clúster de usuario GA DG DG DG No hay diferencias.
Actualización asíncrona del clúster de usuario DG DG DG DG No hay diferencias.
Actualización de prueba del clúster de administrador DG DG No hay diferencias.
Actualización asíncrona del clúster de administrador GA DG DG DG No hay diferencias.
Actualización secuencial de grupos de nodos DG DG DG No hay diferencias.
Crea una instantánea de volumen con el controlador de CSI de vSphere Vista previa Vista previa Vista previa Vista previa No hay diferencias.
Crea un clúster de usuario con ControlPlane V2 habilitado GA DG DG DG No hay diferencias.
Migración de almacenamiento con SPBM DG DG DG DG No hay diferencias.
Migra un almacén de datos a una SPBM DG DG DG DG No hay diferencias.
Migra un clúster de usuario a Controlplane V2 DG DG DG DG No hay diferencias.
Migra a un clúster de administrador de alta disponibilidad DG DG DG DG No hay diferencias.
Migra la configuración de F5 BIG-IP DG DG DG DG No hay diferencias.
Balanceador de cargas Compatibilidad parcial DG DG DG Se aplican cambios. Para obtener más información, consulta la documentación de referencia pertinente sobre la configuración del balanceador de cargas y del clúster.
Verificaciones previas Compatibilidad parcial DG DG DG No hay diferencias.
Requisitos de hardware DG DG DG DG Se aplican cambios. Para obtener más detalles, consulta Requisitos de CPU, RAM y almacenamiento.
Instantánea DG DG DG DG No hay diferencias.
Registro privado DG DG DG DG Se aplican cambios. Para obtener detalles sobre el uso de un registro privado en un clúster avanzado, consulta Limitaciones con clústeres avanzados y el paquete completo.
IPAM, DNS, NTP y multi-NIC DG DG DG DG No hay diferencias.
Creación, actualización y eliminación de clústeres DG DG DG DG Se aplican cambios. Para obtener más información, consulta la documentación pertinente sobre las operaciones de clústeres y las limitaciones avanzadas de los clústeres.
Proxy DG DG DG DG No hay diferencias.
Política de actualización de NodePool DG DG DG No hay diferencias.
Diagnóstico DG DG DG Se aplican los cambios. Las verificaciones relacionadas con vCenter no están disponibles para los clústeres avanzados. Dado que ya no hay un controlador onprem-user-cluster-controller, la guía Diagnostica problemas de clústeres está obsoleta para los clústeres avanzados. Para los clústeres avanzados de la versión 1.32, el comando gkectl diagnose cluster ejecuta verificaciones de estado en el clúster especificado.
Etiquetas de vSphere y VM VMs DG DG No hay diferencias.
Grupo de hosts de vSphere DG DG No hay diferencias.
Registro y supervisión DG DG DG DG No hay diferencias.
Grupos antiafinidad DG DG DG No hay diferencias.
Plano de control del clúster de usuario sin alta disponibilidad DG No compatible.
gkectl check-config DG DG DG Se aplican cambios. La compatibilidad con el comando en clústeres de usuario avanzados se agregó en las siguientes versiones: 1.32.700 y posteriores, 1.33.300 y posteriores, y 1.34.0 y posteriores.

Requisitos previos

  • La versión de gkectl debe ser la misma que la versión del clúster de destino.

    • Si es necesario, consulta Descarga gkectl para obtener una versión compatible de gkectl.
  • Siempre diagnostica tu clúster antes de actualizarlo a un clúster avanzado:

    • Ejecuta gkectl diagnose cluster en tus clústeres de administrador y de usuario para asegurarte de que estén en buen estado.
    • Si el comando informa algún error o advertencia, resuélvelos antes de iniciar la actualización o actualizar a un clúster avanzado.
  • Asegúrate de que tus clústeres usen solo las funciones recomendadas.

  • Verifica que tus clústeres no usen ninguna función que no sea compatible con los clústeres avanzados antes de iniciar la actualización. Si hay funciones no compatibles activas, inhabilítalas primero con update.

    • Aunque se requieren clústeres de usuario con alta disponibilidad (HA) en los clústeres avanzados, puedes actualizar un clúster de usuario sin HA a un clúster avanzado con HA siguiendo esta guía.
  • Debes actualizar el clúster de administrador a un clúster avanzado antes de actualizar cualquier clúster de usuario.

  • Acerca de la instalación de cert-manager: cert-manager se instala automáticamente en los clústeres avanzados. Cuando migras de un clúster no avanzado a uno avanzado, el cert-manager integrado anula automáticamente cualquier versión de cert-manager instalada por el cliente. Asegúrate de no tener configuraciones o funciones personalizadas críticas aplicadas a tu cert-manager existente antes de actualizar a clústeres avanzados.

Actualiza el clúster de administrador al clúster avanzado

Actualizar

  1. Diagnostica tu clúster para asegurarte de que esté en buen estado:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    
  2. Prepárate para el clúster avanzado:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Reemplaza lo siguiente:

    • BUNDLE_PATH: Es la ruta de acceso del archivo del paquete. Este archivo se encuentra en tu estación de trabajo de administrador en /var/lib/gke/bundles/. Por ejemplo:

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.

  3. Establece enableAdvancedCluster en el archivo de configuración del clúster de administrador como true.

  4. Actualiza el clúster de administrador al clúster avanzado:

    gkectl update admin \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config ADMIN_CLUSTER_CONFIG
    

    Reemplaza lo siguiente:

    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
    • ADMIN_CLUSTER_CONFIG: Es la ruta de acceso al archivo de configuración del clúster de administrador.

    El comando volverá a crear todos los nodos en el clúster de administrador.

Actualizar

  1. Actualiza tu estación de trabajo de administrador si es necesario.

  2. Diagnostica tu clúster para asegurarte de que esté en buen estado:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    
  3. Prepárate para el clúster avanzado:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Reemplaza lo siguiente:

    • BUNDLE_PATH: Es la ruta de acceso del archivo del paquete. Este archivo se encuentra en tu estación de trabajo de administrador en /var/lib/gke/bundles/. Por ejemplo:

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.

  4. Establece enableAdvancedCluster en el archivo de configuración del clúster de administrador como true.

  5. Asegúrate de que el campo bundlepath del archivo de configuración del clúster de administrador coincida con la ruta de acceso del paquete al que deseas actualizar.

  6. Actualiza el clúster de administrador al clúster avanzado:

    gkectl upgrade admin \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config ADMIN_CLUSTER_CONFIG
    

    Reemplaza lo siguiente:

    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
    • ADMIN_CLUSTER_CONFIG: Es la ruta de acceso al archivo de configuración del clúster de administrador.

    El comando volverá a crear todos los nodos del clúster de administrador. Con la estrategia de implementación de recreación del lanzamiento, los nodos se actualizan de a uno. Durante la actualización del nodo, la VM se borra y, luego, se vuelve a crear con la versión nueva.

Después de que el clúster de administrador se haya actualizado a un clúster avanzado, haz lo siguiente:

  • Tus clústeres de usuario no avanzados existentes seguirán funcionando con normalidad.

  • Solo puedes crear clústeres de usuario avanzados que administre el clúster de administrador avanzado.

Actualiza todos los clústeres de usuario a clústeres avanzados poco después para mantener un entorno coherente y con todas las funciones.

Actualiza el clúster de usuario al clúster avanzado

Actualizar

  1. Diagnostica tu clúster para asegurarte de que esté en buen estado:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --cluster-name USER_CLUSTER_NAME
    
  2. Si el plano de control del clúster de usuario no tiene alta disponibilidad (HA), haz lo siguiente:

    1. Cambia masterNode.replicas de 1 a 3.

    2. Agrega las direcciones IP estáticas para los nodos del plano de control del clúster de usuario a la sección network.controlPlaneIPBlock.ips.

  3. Prepárate para el clúster avanzado:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Reemplaza lo siguiente:

    • BUNDLE_PATH: Es la ruta de acceso del archivo del paquete. Este archivo se encuentra en tu estación de trabajo de administrador en /var/lib/gke/bundles/. Por ejemplo:

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.

  4. Configura enableAdvancedCluster en el archivo de configuración del clúster de usuario como true.

  5. Actualiza el clúster de usuario al clúster avanzado:

    gkectl update cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config USER_CLUSTER_CONFIG
    

    Reemplaza lo siguiente:

    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
    • USER_CLUSTER_CONFIG: la ruta del archivo de configuración de tu clúster de usuario.

    El comando volverá a crear todos los nodos en el clúster de usuario. Con la estrategia de implementación de recreación de lanzamiento, los nodos se actualizan uno por uno. Durante la actualización del nodo, la VM se borra y, luego, se vuelve a crear con la configuración nueva.

Actualizar

  1. Diagnostica tu clúster para asegurarte de que esté en buen estado:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --cluster-name USER_CLUSTER_NAME
    
  2. Si el plano de control del clúster de usuario no tiene alta disponibilidad (HA), haz lo siguiente:

    1. Cambia masterNode.replicas de 1 a 3.

    2. Agrega las direcciones IP estáticas para los nodos del plano de control del clúster de usuario a la sección network.controlPlaneIPBlock.ips.

  3. Prepárate para el clúster avanzado:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Reemplaza lo siguiente:

    • BUNDLE_PATH: Es la ruta de acceso del archivo del paquete. Este archivo se encuentra en tu estación de trabajo de administrador en /var/lib/gke/bundles/. Por ejemplo:

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.

  4. Configura enableAdvancedCluster en el archivo de configuración del clúster de usuario como true.

  5. Asegúrate de que el campo gkeOnPremVersion del archivo de configuración del clúster de usuario coincida con la versión de destino de la actualización.

  6. Actualiza el clúster de usuario al clúster avanzado:

    gkectl upgrade cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config USER_CLUSTER_CONFIG
    

    Reemplaza lo siguiente:

    • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
    • USER_CLUSTER_CONFIG: la ruta del archivo de configuración de tu clúster de usuario.

    El comando volverá a crear todos los nodos del clúster de usuario.

cert-manager incluido con clústeres avanzados

cert-manager es un componente obligatorio administrado por el sistema en los clústeres avanzados.

Si usas cert-manager sin clústeres avanzados, verifica lo siguiente antes de actualizar a clústeres avanzados:

  • No hay parámetros de configuración personalizados ni marcas de funciones en tu cert-manager.
  • Tu versión de cert-manager es la misma o una versión anterior a la versión empaquetada.

Compatibilidad con Apigee Hybrid

El cert-manager empaquetado es totalmente compatible con las cargas de trabajo de Apigee Hybrid. Cuando actualizas a un clúster avanzado, es posible que el instalador te advierta que se reemplazará la instalación de cert-manager existente. Este es el comportamiento esperado que el sistema controla automáticamente.

Para garantizar una transición sin problemas de tus cargas de trabajo de Apigee, haz lo siguiente:

  • No desinstales manualmente tu cert-manager existente antes de la actualización.
  • Revierte las personalizaciones: Si administras cert-manager con GitOps o aplicaste parámetros de configuración personalizados a la implementación de cert-manager, debes revertir estas personalizaciones o suspender la sincronización antes de la actualización para evitar el desvío de configuración y las posibles pausas de actualización.

Funcionalidades y limitaciones

Puedes hacer lo siguiente con el cert-manager incluido:

  • Crear y editar recursos Issuer y ClusterIssuer
  • Crea y edita recursos de certificados que hagan referencia a emisores y tipos de emisores estándar.
  • Crear y editar recursos estándar de Kubernetes que usa cert-manager
  • Crea Secrets de Kubernetes que contengan claves de API y haz referencia a ellos en tus emisores.
  • Configura tus emisores para que usen solucionadores HTTP-01 o DNS-01 específicos.

No puedes personalizar lo siguiente en el cert-manager empaquetado:

  • Establece los valores de deployment o helm.
  • Agrega argumentos o marcas de línea de comandos al objeto binario cert-manager.
  • Cambia los límites de recursos o los selectores de nodos para los Pods de cert-manager.
  • Modificar la lógica de instalación del software de cert-manager
  • Activar funciones experimentales
  • Forzar que los Pods del plano de control de cert-manager se ejecuten en nodos de infraestructura específicos.

Si tienes restricciones específicas que te impiden usar el cert-manager empaquetado, comunícate con el equipo de asistencia deGoogle Cloud para obtener ayuda con las opciones de configuración avanzada.

Versiones empaquetadas

En la siguiente tabla, se enumeran las versiones de cert-manager empaquetadas para cada versión de Google Distributed Cloud (solo software) para VMware.

Google Distributed Cloud (solo software) para VMware Versión de cert-manager empaquetada
1.32 1.17
1.33 1.18
1.34 1.19