Actualizar o cambiar a un clúster avanzado

En este documento se explica cómo actualizar o cambiar 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 Descargar gkectl para obtener una versión compatible de gkectl.

• Diagnostica siempre tu clúster antes de actualizarlo.

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

• Comprueba que tus clústeres no usen ninguna función no compatible con los clústeres avanzados antes de iniciar la actualización. Si hay alguna función no admitida activa, inhabilítela primero con update.

  • Aunque los clústeres de usuarios de alta disponibilidad (HA) son obligatorios en los clústeres avanzados, puedes actualizar o migrar un clúster de usuarios que no sea de alta disponibilidad a un clúster avanzado de alta disponibilidad siguiendo esta guía.

• Debes actualizar el clúster de administrador a un clúster avanzado antes de actualizar cualquier clúster de usuario.

Actualizar 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. Prepárate para el clúster avanzado:

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

   Haz los cambios siguientes:

   • BUNDLE_PATH: la ruta del archivo del paquete. Este archivo se encuentra en la 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. Asigna el valor enableAdvancedCluster a true en el archivo de configuración del clúster de administrador.

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

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

   Haz los cambios siguientes:

   • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
   • ADMIN_CLUSTER_CONFIG: la ruta del 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 tipo de imagen de SO del plano de control o 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 de tu clúster sea al menos 1.31.100.

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

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

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

   Haz los cambios siguientes:

   • BUNDLE_PATH: la ruta del archivo del paquete. Este archivo se encuentra en la 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. Asigna el valor enableAdvancedCluster a true en el archivo de configuración del clúster de administradores.

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

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

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

   Haz los cambios siguientes:

   • ADMIN_CLUSTER_KUBECONFIG: la ruta del archivo kubeconfig del clúster de administrador.
   • ADMIN_CLUSTER_CONFIG: la ruta del 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 de lanzamiento, los nodos se actualizan de uno en uno. Durante la actualización del nodo, la VM se elimina y, a continuación, se vuelve a crear con la nueva versión.

Una vez que el clúster de administrador se haya actualizado o cambiado a un clúster avanzado:

• Los clústeres de usuarios no avanzados que ya tengas seguirán funcionando con normalidad.

• Solo puede crear clústeres de usuarios avanzados que estén gestionados por el clúster de administrador avanzado.

Te recomendamos que actualices todos los clústeres de usuarios a clústeres avanzados poco después para mantener un entorno coherente y con todas las funciones.

Actualizar o cambiar a la versión avanzada del clúster de usuarios

Importante: Asegúrate de que el clúster de administrador ya se haya actualizado o cambiado a la versión avanzada.

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 usuarios no es de alta disponibilidad:

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

   1. Cambia masterNode.replicas de 1 a 3.

   2. Añade las direcciones IP estáticas de los nodos de plano de control del clúster de usuarios a la sección network.controlPlaneIPBlock.ips.

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

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

   Haz los cambios siguientes:

   • BUNDLE_PATH: la ruta del archivo del paquete. Este archivo se encuentra en la 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. Asigna el valor enableAdvancedCluster a true en el archivo de configuración del clúster de usuarios.

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

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

   Haz los cambios siguientes:

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

   El comando implementará la recreación de todos los nodos del clúster de usuario. Con la estrategia de despliegue de recreación progresiva, los nodos se actualizan de uno en uno. Durante la actualización del nodo, la VM se elimina y, a continuación, se vuelve a crear con la nueva configuración.

Actualizar

Precaución: Si tu clúster usa cos o cos_cgv2 como tipo de imagen de SO del plano de control o 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 de tu clúster sea al menos 1.31.100.

1. Si el plano de control de tu clúster de usuarios no es de alta disponibilidad:

   1. Cambia masterNode.replicas de 1 a 3.

   2. Añade las direcciones IP estáticas de los nodos de plano de control del clúster de usuarios a la sección network.controlPlaneIPBlock.ips.

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

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

   Haz los cambios siguientes:

   • BUNDLE_PATH: la ruta del archivo del paquete. Este archivo se encuentra en la 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. Asigna el valor enableAdvancedCluster a true en el archivo de configuración del clúster de usuarios.

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

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

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

   Haz los cambios siguientes:

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

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

Principales diferencias tras cambiar a clústeres avanzados

Si actualizas tu clúster a un clúster avanzado, se producirán varios cambios importantes 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ústeres y máquinas ya no se encuentran en los clústeres de usuarios. Estos recursos se encuentran exclusivamente en el clúster de administrador.

• NodeExternalIP: el parámetro NodeExternalIP no se ha definido en los nodos.

• Instalación de cert-manager: cert-manager se instala automáticamente en los clústeres avanzados. Si has instalado cert-manager en tu clúster, al actualizarlo o pasarte a la versión avanzada, se sobrescribirá con la versión avanzada del clúster.

Para ver un resumen completo de las diferencias entre funciones, consulta la tabla de comparación de funciones.