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:
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_NAMEen 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_SERVERen 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:
Muestra las versiones de actualización de Kubernetes disponibles imprimiendo el valor
kubernetesVersionde los objetosUserClusterMetadata:kubectl --kubeconfig MANAGEMENT_API_SERVER \ get userclustermetadata -o=custom-columns='TARGET_VERSION:.spec.kubernetesVersion'Sustituye
MANAGEMENT_API_SERVERpor 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.85Anota la versión de Kubernetes del resultado anterior a la que quieras actualizar tu clúster. La
targetVersionque especifiques en la solicitud de actualización del siguiente paso debe ser una de estas versiones disponibles.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 EOFHaz 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, comouser-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 nombresplatform. 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, como1.30.1000-gke.85.
La actualización de un clúster de Kubernetes suele tardar unos 20 minutos.
Verifica la actualización del clúster monitorizando el recurso
UserClusterUpgradeRequest:kubectl --kubeconfig MANAGEMENT_API_SERVER \ describe userclusterupgraderequest CLUSTER_NAME \ -n CLUSTER_NAMESPACEHaz 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, comouser-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 nombresplatform. En el caso de los clústeres estándar, usa el espacio de nombres del proyecto del clúster.
Inspecciona la sección
Specdel resultado. ContieneCurrent VersionyTarget Version. La actualización sigue en curso si elCurrent Versiony elTarget Versionson 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: SucceededLa actualización se habrá completado correctamente cuando la condición
Succeededtenga el estadoTruey el valor deCurrent Versioncoincida con el deTarget Version.Si la condición
Succeededtiene el estadoFalse, 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:
Consulta los campos
status.conditionsystatus.componentsConditionsdel recursoCluster:kubectl --kubeconfig MANAGEMENT_API_SERVER \ get cluster CLUSTER_NAME \ -n CLUSTER_NAMESPACE -o yamlHaz 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, comouser-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 nombresplatform. En el caso de los clústeres estándar, usa el espacio de nombres del proyecto del clúster.
En el resultado, verifica lo siguiente en la sección
status:- En
status.conditions, verifica que la condiciónReadytenga unstatusdeTruey que la condiciónReconcilingtenga unstatusdeFalse. - En
status.componentsConditions, comprueba que la condiciónReadytenga unstatusdeTrue, que la condiciónReconcilingtenga unstatusdeFalsey que ninguna condición muestre unreasondeReconciliationErroroReconciling.
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
Reconcilingdespués de 20 minutos, o si alguna condición muestraReconciliationError, ponte en contacto con tu grupo de operadores de infraestructura para obtener más ayuda.- En
Siguientes pasos
- Diseñar la separación de las cargas de trabajo
- Mantener clústeres de Kubernetes
- Gestionar pools de nodos