Actualizar GKE on AWS

Para actualizar tu entorno de GKE en AWS, primero debes actualizar tu servicio de gestión y, a continuación, tus clústeres de usuario.

Servicio de gestión

En las siguientes secciones, actualizarás tu servicio de gestión.

Antes de empezar

Para conectarte a tus recursos de GKE en AWS, sigue estos pasos. Selecciona si tienes una VPC de AWS (o una conexión directa a tu VPC) o si has creado una VPC específica al crear tu servicio de gestión.

VPC ya creada

Si tienes una conexión directa o VPN a una VPC, omite la línea env HTTP_PROXY=http://localhost:8118 de los comandos de este tema.

VPC dedicada

Cuando creas un servicio de gestión en una VPC dedicada, GKE en AWS incluye un host bastión en una subred pública.

Importante: Si reinicias la sesión de terminal o se pierde la conexión SSH, debes volver a ejecutar la secuencia de comandos bastion-tunnel.sh.

Para conectarte a tu servicio de gestión, sigue estos pasos:

1. Cambia al directorio con tu configuración de GKE en AWS. Has creado este directorio al instalar el servicio de gestión.

   cd anthos-aws

2. Para abrir el túnel, ejecuta la secuencia de comandos bastion-tunnel.sh. El túnel reenvía a localhost:8118.

   Para abrir un túnel al host bastion, ejecuta el siguiente comando:

   ./bastion-tunnel.sh -N
   

   Los mensajes del túnel SSH aparecen en esta ventana. Cuando quieras cerrar la conexión, detén el proceso con Control+C o cierra la ventana.

3. Abre una terminal nueva y ve al directorio anthos-aws.

   cd anthos-aws

4. Comprueba que puedes conectarte al clúster con kubectl.

   env HTTPS_PROXY=http://localhost:8118 \
   kubectl cluster-info
   

   La salida incluye la URL del servidor de la API del servicio de gestión.

Actualizar el servicio de gestión

Para actualizar tu servicio de gestión, descarga una nueva versión de anthos-gke, edita tu anthos-gke.yaml y aplica los cambios.

Descargar una nueva versión de anthos-gke

La versión más reciente de la herramienta anthos-gke es la aws-1.14.1-gke.0. Para descargar una nueva versión de anthos-gke, sigue estos pasos:

La herramienta de línea de comandos anthos-gke solo es compatible con Linux y macOS.

1. Descarga el archivo binario de Cloud Storage.

   Linux

   gcloud storage cp gs://gke-multi-cloud-release/aws/aws-1.14.1-gke.0/bin/linux/amd64/anthos-gke .
   

   macOS

   gcloud storage cp gs://gke-multi-cloud-release/aws/aws-1.14.1-gke.0/bin/darwin/amd64/anthos-gke .
   

2. Actualiza los permisos de anthos-gke y cópialos en /usr/local/bin.

   chmod 755 anthos-gke
   sudo mv anthos-gke /usr/local/bin
   

3. Comprueba que la versión sea aws-1.14.1-gke.0.

   anthos-gke version
   

Actualizar el servicio de gestión

Para actualizar el clúster, sigue estos pasos:

1. Cambia al directorio con tu configuración de GKE en AWS. Has creado este directorio al instalar el servicio de gestión.

   cd anthos-aws

2. Abre el archivo anthos-gke.yaml en un editor de texto. Cambia el valor de spec.version a aws-1.14.1-gke.0.

   apiVersion: multicloud.cluster.gke.io/v1
   kind: AWSManagementService
   metadata:
    name: management
   spec:
    version: aws-1.14.1-gke.0
    region: aws-region
    ...
   

3. Ejecuta anthos-gke aws management init para validar el objeto AWSManagementService y actualizar el archivo anthos-gke.status.yaml.

   anthos-gke aws management init
   

4. Ejecuta anthos-gke aws management apply para actualizar el servicio de gestión en AWS.

   anthos-gke aws management apply
   

   El comando anthos-gke empieza a actualizar el servicio de gestión. La actualización puede tardar hasta diez minutos en completarse.

   Nota: Tu servicio de gestión experimentará un tiempo de inactividad durante la actualización. No puedes hacer ningún cambio en tus recursos de AWSCluster en este momento. Tus clústeres de usuarios seguirán ejecutando sus cargas de trabajo mientras se completa la actualización.

Nota: Si tienes un host bastion en tu entorno de GKE on AWS, es posible que se reinicie durante la actualización. Reinicia el túnel cuando se haya completado el proceso.

Clústeres de usuarios

En las siguientes secciones, actualizará sus clústeres de usuario.

Antes de empezar

Para poder completar estos pasos, debes tener un servicio de gestión y al menos un clúster de usuarios.

Versiones de Kubernetes compatibles

GKE on AWS aws-1.14.1-gke.0 admite las siguientes versiones de Kubernetes:

• 1.23.15-gke.2000
• 1.24.9-gke.2100
• 1.25.5-gke.2100

Para obtener información sobre las versiones anteriores admitidas, consulta las notas de la versión.

Nota: GKE on AWS ya no admite las versiones 1.19, 1.20 y 1.21 de Kubernetes.

Actualizaciones de componentes

En esta sección se describe cómo actualizar los AWSClusters y los AWSNodePools.

AWSCluster

Puedes actualizar un AWSCluster a una nueva versión de GKE en AWS sin actualizar tus AWSNodePools.

AWSNodePools

No puedes actualizar un AWSNodePool a una versión más reciente que tu AWSCluster. Para actualizar tus AWSNodePools, primero debes actualizar tu AWSCluster.

La versión de tus AWSNodePools no debe ser inferior a dos versiones secundarias de la versión de tu AWSCluster.

Actualizar un AWSCluster y un AWSNodePool

Para actualizar el clúster, debes actualizar el campo version de los objetos AWSCluster y AWSNodePool en el servicio de gestión.

AWSCluster

Para actualizar un AWSCluster, sigue estos pasos:

1. En tu directorio de anthos-aws, usa anthos-gke para cambiar el contexto a tu servicio de gestión.

   cd anthos-aws
   anthos-gke aws management get-credentials

   Nota: anthos-gke usa las credenciales que especificaste al ejecutar aws configure.

2. Abre el archivo YAML que creó tu AWSCluster en un editor de texto. Si no tienes el archivo YAML inicial, puedes usar kubectl edit.

   Editar YAML

   Si has seguido las instrucciones de Crear un clúster de usuario, tu archivo YAML se llama cluster-0.yaml. Abre este archivo en un editor de texto.

   kubectl edit

   Para usar kubectl edit y editar tu AWSCluster, ejecuta el siguiente comando:

   env HTTPS_PROXY=http://localhost:8118 \
     kubectl edit awscluster cluster-name
   

   Sustituye cluster-name por tu AWSCluster. Por ejemplo, para editar el clúster predeterminado, cluster-0, ejecuta el siguiente comando:

   env HTTPS_PROXY=http://localhost:8118 \
     kubectl edit awscluster cluster-0
   

3. Actualiza el campo spec.controlPlane.version a una nueva versión de GKE en AWS. La versión más reciente es la 1.25.5-gke.2100.

   apiVersion: multicloud.cluster.gke.io/v1
   kind: AWSCluster
   metadata:
     name: cluster-0
   spec:
     region: us-east-1
     controlPlane:
       version: gke_version
       instanceType: t3.medium
     ...
   

   Sustituye gke-version por la versión de Kubernetes que quieras. La versión de Kubernetes más reciente compatible es la 1.25.5-gke.2100.

   Nota: No se puede cambiar a una versión anterior de un clúster.

4. Guarda el archivo. Si usas kubectl edit, kubectl aplica los cambios automáticamente. Si estás editando el archivo YAML, aplícalo a tu servicio de gestión con el siguiente comando:

   env HTTPS_PROXY=http://localhost:8118 \
   kubectl apply -f cluster-0.yaml
   

   A continuación, el servicio de gestión actualiza tu AWSCluster.

AWSNodePool

Para actualizar un AWSNodePool, sigue estos pasos:

1. En tu directorio de anthos-aws, usa anthos-gke para cambiar el contexto a tu servicio de gestión.

   cd anthos-aws
   anthos-gke aws management get-credentials

   Nota: anthos-gke usa las credenciales que especificaste al ejecutar aws configure.

2. Abre el archivo YAML que creó tu AWSNodePool en un editor de texto. Si has seguido las instrucciones de Crear un clúster de usuarios, este archivo se llama cluster-0.yaml.

3. Actualiza el valor de spec.version en tus recursos de AWSNodePool.

   apiVersion: multicloud.cluster.gke.io/v1
   kind: AWSNodePool
   metadata:
     name: cluster-0-pool-0
   spec:
     clusterName: cluster-0
     region: us-east-1
     version: gke-version
     ...
   

   Sustituye gke-version por la versión de Kubernetes que quieras. La versión de Kubernetes más reciente compatible es la 1.25.5-gke.2100.

   Nota: No se puede cambiar a una versión anterior de AWSNodePool.

4. Aplica la nueva configuración a tu servicio de gestión con kubectl.

   env HTTPS_PROXY=http://localhost:8118 \
     kubectl apply -f cluster-0.yaml
   

   A continuación, el servicio de gestión actualiza tu AWSNodePool de un nodo en un nodo. Antes de que se cierre un nodo, los pods que se ejecutan en ese nodo reciben una señal SIGTERM. Si un pod no se cierra después de un periodo de gracia, recibe una señal SIGKILL.

   Nota: Durante una actualización, tus cargas de trabajo se reinician en nodos nuevos. Es posible que se produzca un tiempo de inactividad durante una actualización mientras se reinician las cargas de trabajo en un nuevo nodo.

Ver estado

Para obtener el estado de una actualización, ejecuta kubectl get AWSClusters en tu servicio de gestión.

env HTTPS_PROXY=http://localhost:8118 \
    kubectl get AWSClusters

La salida incluye el nombre, el estado, la antigüedad, la versión y el endpoint de cada clúster. Por ejemplo, el siguiente resultado incluye un AWSCluster llamado cluster-0.

NAME        STATE          AGE     VERSION         ENDPOINT
cluster-0   Upgrading   2m41s      1.25.5-gke.2100   gke-xyz.elb.us-east-1.amazonaws.com

La actualización del clúster de usuarios se habrá completado cuando el ESTADO de los clústeres sea Provisioned.