Actualiza un clúster o actualízalo 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.

Requisitos previos

  • Siempre diagnostica tu clúster antes de actualizarlo.

  • Asegúrate de que tus clústeres usen solo 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, inhabilitalas primero con update.

    • Aunque los clústeres de usuario con alta disponibilidad (HA) son obligatorios en los clústeres avanzados, puedes actualizar un clúster de usuario que no es de HA a un clúster avanzado de 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

  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 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. Configura enableAdvancedCluster en el 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 del archivo de configuración del clúster de administrador.

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

Actualizar

  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 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. Establece enableAdvancedCluster en el 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 del archivo de configuración del clúster de administrador.

    El comando lanzará la recreación de todos los nodos del clúster de administrador.

Después de actualizar el clúster de administrador o actualizarlo 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 usuarios avanzados que administre 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

Actualizar

  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 usuarios 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 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. Configura enableAdvancedCluster en el 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 lanzará la recreación de todos los nodos del clúster de usuarios.

Actualizar

  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 usuarios 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 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. Configura enableAdvancedCluster en el 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 usuarios.