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: ElNodeExternalIPno está configurado en los nodos.Instalación de
cert-manager:cert-managerse instala automáticamente en los clústeres avanzados. Si instalastecert-manageren 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
gkectldebe ser la misma que la versión del clúster de destino.- Si es necesario, consulta
Descarga
gkectlpara obtener una versión compatible degkectl.
- Si es necesario, consulta
Descarga
Siempre diagnostica tu clúster antes de actualizarlo a un clúster avanzado:
- Ejecuta
gkectl diagnose clusteren 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.
- Ejecuta
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-managerse instala automáticamente en los clústeres avanzados. Cuando migras de un clúster no avanzado a uno avanzado, elcert-managerintegrado anula automáticamente cualquier versión decert-managerinstalada por el cliente. Asegúrate de no tener configuraciones o funciones personalizadas críticas aplicadas a tucert-managerexistente antes de actualizar a clústeres avanzados.
Actualiza el clúster de administrador al clúster avanzado
Actualizar
Diagnostica tu clúster para asegurarte de que esté en buen estado:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG- Si el comando informa algún error o advertencia, consulta Diagnostica problemas del clúster y resuélvelos antes de continuar.
Prepárate para el clúster avanzado:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterReemplaza 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.tgzADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
Establece
enableAdvancedClusteren el archivo de configuración del clúster de administrador comotrue.Actualiza el clúster de administrador al clúster avanzado:
gkectl update admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIGReemplaza 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
Actualiza tu estación de trabajo de administrador si es necesario.
Diagnostica tu clúster para asegurarte de que esté en buen estado:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG- Si el comando informa algún error o advertencia, consulta Diagnostica problemas del clúster y resuélvelos antes de continuar.
Prepárate para el clúster avanzado:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterReemplaza 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.tgzADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
Establece
enableAdvancedClusteren el archivo de configuración del clúster de administrador comotrue.Asegúrate de que el campo
bundlepathdel archivo de configuración del clúster de administrador coincida con la ruta de acceso del paquete al que deseas actualizar.Actualiza el clúster de administrador al clúster avanzado:
gkectl upgrade admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIGReemplaza 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
Diagnostica tu clúster para asegurarte de que esté en buen estado:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --cluster-name USER_CLUSTER_NAME- Si el comando informa algún error o advertencia, consulta Diagnostica problemas del clúster y resuélvelos antes de continuar.
Si el plano de control del clúster de usuario no tiene alta disponibilidad (HA), haz lo siguiente:
Cambia
masterNode.replicasde 1 a 3.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.
Prepárate para el clúster avanzado:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterReemplaza 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.tgzADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
Configura
enableAdvancedClusteren el archivo de configuración del clúster de usuario comotrue.Actualiza el clúster de usuario al clúster avanzado:
gkectl update cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIGReemplaza 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
Diagnostica tu clúster para asegurarte de que esté en buen estado:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --cluster-name USER_CLUSTER_NAME- Si el comando informa algún error o advertencia, consulta Diagnostica problemas del clúster y resuélvelos antes de continuar.
Si el plano de control del clúster de usuario no tiene alta disponibilidad (HA), haz lo siguiente:
Cambia
masterNode.replicasde 1 a 3.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.
Prepárate para el clúster avanzado:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterReemplaza 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.tgzADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
Configura
enableAdvancedClusteren el archivo de configuración del clúster de usuario comotrue.Asegúrate de que el campo
gkeOnPremVersiondel archivo de configuración del clúster de usuario coincida con la versión de destino de la actualización.Actualiza el clúster de usuario al clúster avanzado:
gkectl upgrade cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIGReemplaza 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-manageres 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-managerexistente antes de la actualización. - Revierte las personalizaciones: Si administras
cert-managercon GitOps o aplicaste parámetros de configuración personalizados a la implementación decert-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
IssueryClusterIssuer - 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
deploymentohelm. - 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-managerse 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 |