Actualiza un clúster a un clúster avanzado

En este documento, se muestra cómo actualizar un clúster a un clúster avanzado desde la versión 1.32.

Importante: Los clústeres no avanzados se actualizarán automáticamente a clústeres avanzados en la versión 1.33.

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.

• Asegúrate de que tus clústeres solo usen funciones recomendadas.

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

  • Si bien los clústeres de usuarios con alta disponibilidad (HA) son obligatorios en los clústeres avanzados, puedes actualizar un clúster de usuarios 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.

Actualiza el clúster de administrador a un clúster avanzado

Actualizar

Importante: Asegúrate de que la versión de tu clúster sea al menos la 1.32.0.

1. Prepara 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 de 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.

2. Configura enableAdvancedCluster en tu archivo de configuración del clúster de administrador como true.

3. 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 del clúster de administrador.

Actualizar

Precaución: Si tu clúster usa cos o cos_cgv2 como el tipo de imagen de SO del plano de control o el tipo de imagen de SO del grupo de nodos, asegúrate de que la versión del clúster sea al menos 1.32.0 antes de actualizarlo. De lo contrario, asegúrate de que la versión del clúster sea al menos 1.31.100.

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

2. Prepara 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 de 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. Configura enableAdvancedCluster en tu archivo de configuración del clúster de administrador como true.

4. 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.

5. 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 implementará la recreación de 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, se borra la VM y, luego, se vuelve a crear con la versión nueva.

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

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

• Solo puedes crear clústeres de usuario avanzados que estén administrados por el clúster de administrador avanzado.

Te recomendamos que actualices 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 a un clúster avanzado

Importante: Asegúrate de que el clúster de administrador ya se haya actualizado al clúster avanzado.

Actualizar

Importante: Asegúrate de que la versión de tu clúster sea al menos la 1.32.0.

1. Si el plano de control de tu clúster de usuario no tiene alta disponibilidad (HA), haz lo siguiente:

   Precaución: Debido a un problema conocido con el campo masterNode.replicas, para actualizar un clúster de usuario sin alta disponibilidad de la versión 1.32 o 1.33 a un clúster avanzado con alta disponibilidad, el clúster debe tener una versión superior a 1.32.600 o superior a 1.33.100, respectivamente.

   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.

2. Prepara 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 de 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. Configura enableAdvancedCluster en tu archivo de configuración del clúster de usuario como true.

4. 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 implementará la recreación de todos los nodos del clúster de usuario. Con la estrategia de implementación de recreación del lanzamiento, los nodos se actualizan de a uno por vez. Durante la actualización del nodo, se borra la VM y, luego, se vuelve a crear con la configuración nueva.

Actualizar

Precaución: Si tu clúster usa cos o cos_cgv2 como el tipo de imagen de SO del plano de control o el tipo de imagen de SO del grupo de nodos, asegúrate de que la versión del clúster sea al menos 1.32.0 antes de actualizarlo. De lo contrario, asegúrate de que la versión del clúster sea al menos 1.31.100.

1. Si el plano de control de tu 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.

2. Prepara 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 de 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. Configura enableAdvancedCluster en tu archivo de configuración del clúster de usuario como true.

4. 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.

5. 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.

Diferencias clave después de migrar a clústeres avanzados

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

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

• NodeExternalIP: El parámetro 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 a un clúster avanzado lo reemplazará por la versión del clúster avanzado.

Para obtener una descripción general completa de las diferencias entre las funciones, consulta la tabla de comparación de funciones.