Actualizar un clúster

En este documento se explica cómo actualizar la versión de Kubernetes de un clúster de Kubernetes aislado de Google Distributed Cloud (GDC). Debes planificar actualizaciones rutinarias de tus clústeres para asegurarte de que incorporan las funciones y correcciones de Kubernetes más recientes.

Este documento está dirigido a audiencias como administradores de TI, ingenieros de seguridad y administradores de red del grupo de administradores de plataformas, que son responsables de gestionar los recursos de Kubernetes en su organización. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Antes de empezar

Para completar las tareas de este documento, debes solicitar los permisos necesarios y preparar tu entorno.

Solicitar roles de gestión de identidades y accesos

Debes tener roles específicos para obtener los permisos que necesitas para actualizar tu clúster de Kubernetes. Debes solicitar roles que se apliquen a tu proyecto y a tu organización.

Roles de la organización

Para ver las versiones de actualización disponibles de un clúster de Kubernetes, pide al administrador de la organización de gestión de identidades y accesos que te asigne el rol Administrador de clústeres de usuarios (user-cluster-admin). Este rol no está vinculado a un espacio de nombres.

Si gestionas un clúster estándar y no puedes obtener el rol de administrador de clústeres de usuarios de tu grupo de administradores de la plataforma, debes solicitar que te proporcionen la lista de versiones de actualización de Kubernetes disponibles.

Roles de proyecto

Para crear, eliminar, editar o ver actualizaciones de clústeres, pide al administrador de proyectos de gestión de identidades y accesos que te conceda el rol de administrador de clústeres estándar (standard-cluster-admin). Este rol está vinculado al espacio de nombres de tu proyecto.

Prepara tu entorno

Para ejecutar comandos en un clúster de Kubernetes mediante la API, asegúrate de que tienes los siguientes recursos:

  • Descarga e instala la CLI gdcloud.

  • Instala la CLI de kubectl.

  • Busca el nombre del clúster de Kubernetes o pregunta a un miembro del grupo de administradores de la plataforma cuál es.

  • Usa el nombre del clúster de Kubernetes para sustituir CLUSTER_NAME en estas instrucciones.

  • Inicia sesión y genera el archivo kubeconfig para el servidor de la API de gestión.

  • Usa la ruta de kubeconfig del servidor de la API Management para sustituir MANAGEMENT_API_SERVER en estas instrucciones.

Actualizar un clúster de Kubernetes

Usa la API UserClusterUpgradeRequest para actualizar un clúster de Kubernetes.

Para actualizar un clúster de Kubernetes con la API, sigue estos pasos:

  1. Muestra las versiones de actualización de Kubernetes disponibles imprimiendo el valor kubernetesVersion de los objetos UserClusterMetadata:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
        get userclustermetadata -o=custom-columns='TARGET_VERSION:.spec.kubernetesVersion'
    

    Sustituye MANAGEMENT_API_SERVER por la ruta al archivo kubeconfig del servidor de la API de gestión.

    El comando devuelve una lista de las versiones de Kubernetes disponibles:

    TARGET_VERSION
    1.30.1000-gke.85
    
  2. Anota la versión de Kubernetes del resultado anterior a la que quieras actualizar tu clúster. La targetVersion que especifiques en la solicitud de actualización del siguiente paso debe ser una de estas versiones disponibles.

  3. Solicita la actualización del clúster creando un recurso UserClusterUpgradeRequest:

      kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
      apiVersion: cluster.gdc.goog/v1
      kind: UserClusterUpgradeRequest
      metadata:
        name: CLUSTER_NAME
        namespace: CLUSTER_NAMESPACE
      spec:
        clusterRef:
          name: CLUSTER_NAME
        targetVersion: TARGET_VERSION
      EOF
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: la ruta al archivo kubeconfig del servidor de la API de gestión.
    • CLUSTER_NAME: el nombre del clúster de Kubernetes que se va a actualizar, como user-vm-2.
    • CLUSTER_NAMESPACE: el espacio de nombres del clúster de Kubernetes. En el caso de los clústeres compartidos, usa el espacio de nombres platform. En el caso de los clústeres estándar, usa el espacio de nombres del proyecto del clúster.
    • TARGET_VERSION: la versión de destino de la actualización identificada en el paso anterior, como 1.30.1000-gke.85.

    La actualización de un clúster de Kubernetes suele tardar unos 20 minutos.

  4. Verifica la actualización del clúster monitorizando el recurso UserClusterUpgradeRequest:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
        describe userclusterupgraderequest CLUSTER_NAME \
        -n CLUSTER_NAMESPACE
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: la ruta al archivo kubeconfig del servidor de la API de gestión.
    • CLUSTER_NAME: el nombre del clúster de Kubernetes que se va a actualizar, como user-vm-2.
    • CLUSTER_NAMESPACE: el espacio de nombres del clúster de Kubernetes. En el caso de los clústeres compartidos, usa el espacio de nombres platform. En el caso de los clústeres estándar, usa el espacio de nombres del proyecto del clúster.

    Inspecciona la sección Spec del resultado. Contiene Current Version y Target Version. La actualización sigue en curso si el Current Version y el Target Version son diferentes.

    Spec:
      ...
      Current Version: 1.29.500-gke.60
      Target Version: 1.30.1000-gke.85
    Status:
      Conditions:
      - Message: Upgrade is in progress
        Reason: UpgradeInProgress
        Status: "False"
        Type: Succeeded
    

    La actualización se habrá completado correctamente cuando la condición Succeeded tenga el estado True y el valor de Current Version coincida con el de Target Version.

    Si la condición Succeeded tiene el estado False, significa que la actualización no se ha podido realizar. Si se producen errores relacionados con la actualización del clúster de Kubernetes, ponte en contacto con el grupo de operadores de infraestructura para obtener más ayuda.

Verificar el estado del clúster después de la actualización

Una vez que se haya actualizado tu clúster de Kubernetes, confirma que el clúster y sus componentes estén en buen estado inspeccionando el estado del recurso Cluster:

  1. Consulta los campos status.conditions y status.componentsConditions del recurso Cluster:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
        get cluster CLUSTER_NAME \
        -n CLUSTER_NAMESPACE -o yaml
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: la ruta al archivo kubeconfig del servidor de la API de gestión.
    • CLUSTER_NAME: el nombre del clúster de Kubernetes, como user-vm-2.
    • CLUSTER_NAMESPACE: el espacio de nombres del clúster de Kubernetes. En el caso de los clústeres compartidos, usa el espacio de nombres platform. En el caso de los clústeres estándar, usa el espacio de nombres del proyecto del clúster.
  2. En el resultado, verifica lo siguiente en la sección status:

    • En status.conditions, verifica que la condición Ready tenga un status de True y que la condición Reconciling tenga un status de False.
    • En status.componentsConditions, comprueba que la condición Ready tenga un status de True, que la condición Reconciling tenga un status de False y que ninguna condición muestre un reason de ReconciliationError o Reconciling.

    En el caso de los clústeres de Kubernetes con tres nodos de plano de control y tres nodos de trabajador, la actualización tarda aproximadamente 20 minutos. Si el clúster o sus componentes siguen en estado Reconciling después de 20 minutos, o si alguna condición muestra ReconciliationError, ponte en contacto con tu grupo de operadores de infraestructura para obtener más ayuda.

Siguientes pasos