Upgrade di GKE su AWS

Per eseguire l'upgrade di GKE in ambiente AWS, esegui prima l'upgrade del servizio di gestione, quindi esegui l'upgrade dei cluster utente.

Servizio di gestione

Nelle sezioni seguenti eseguirai l'upgrade del servizio di gestione.

Prima di iniziare

Per connetterti alle tue risorse GKE su AWS, segui questi passaggi. Seleziona se disponi già di un VPC AWS (o di una connessione diretta al tuo VPC) o hai creato un VPC dedicato durante la creazione del servizio di gestione.

VPC esistente

Se hai una connessione diretta o VPN a un VPC esistente, ometti la riga env HTTP_PROXY=http://localhost:8118 dai comandi in questo argomento.

VPC dedicato

Quando crei un servizio di gestione in un VPC dedicato, GKE su AWS include un host bastion in una subnet pubblica.

Importante: se riavvii la sessione del terminale o la connessione SSH si interrompe, devi riavviare lo script bastion-tunnel.sh.

Per connetterti al servizio di gestione, segui questi passaggi:

1. Passa alla directory con la tua configurazione GKE su AWS. Hai creato questa directory durante l'installazione del servizio di gestione.

   cd anthos-aws

2. Per aprire il tunnel, esegui lo script bastion-tunnel.sh. Il tunnel rimanda a localhost:8118.

   Per aprire un tunnel sul bastion host, esegui questo comando:

   ./bastion-tunnel.sh -N
   

   I messaggi del tunnel SSH vengono visualizzati in questa finestra. Quando è tutto pronto per chiudere la connessione, interrompi il processo utilizzando Ctrl+C o chiudendo la finestra.

3. Apri un nuovo terminale e passa alla directory anthos-aws.

   cd anthos-aws

4. Verifica di poter connetterti al cluster con kubectl.

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

   L'output include l'URL del server API del servizio di gestione.

Esegui l'upgrade del servizio di gestione

Per eseguire l'upgrade del servizio di gestione, scarica una nuova versione di anthos-gke, modifica il tuo anthos-gke.yaml, quindi applica le modifiche.

Scarica una nuova versione di anthos-gke

L'ultima versione dello strumento anthos-gke è aws-1.14.1-gke.0. Per scaricare una nuova versione di anthos-gke, svolgi i seguenti passaggi:

Lo strumento a riga di comando anthos-gke supporta solo Linux e macOS.

1. Scarica il programma binario da Cloud Storage.

   Linux

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

   macOS

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

2. Aggiorna le autorizzazioni di anthos-gke e copiale in /usr/local/bin.

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

3. Conferma che la versione sia aws-1.14.1-gke.0

   anthos-gke version
   

Esegui l'upgrade del servizio di gestione

Per eseguire l'upgrade del cluster, segui questi passaggi:

1. Passa alla directory con la tua configurazione GKE su AWS. Hai creato questa directory durante l'installazione del servizio di gestione.

   cd anthos-aws

2. Apri anthos-gke.yaml in un editor di testo. Modifica il valore di spec.version in 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. Esegui anthos-gke aws management init per convalidare l'oggetto AWSManagementService e aggiornare il file anthos-gke.status.yaml.

   anthos-gke aws management init
   

4. Esegui anthos-gke aws management apply per aggiornare il servizio di gestione su AWS.

   anthos-gke aws management apply
   

   Il comando anthos-gke avvia l'upgrade del servizio di gestione. Il completamento dell'upgrade potrebbe richiedere fino a dieci minuti.

   Nota: durante un upgrade il servizio di gestione ha un tempo di inattività. Al momento non puoi apportare modifiche alle risorse AWSCluster. I tuoi cluster utente continuano a eseguire i propri carichi di lavoro mentre viene completato l'upgrade.

Nota: se hai un bastion host nel tuo ambiente GKE in AWS, potrebbe riavviarsi durante l'upgrade. Riavvia il tunnel al termine del processo.

Cluster utenti

Nelle sezioni seguenti eseguirai l'upgrade dei cluster utente.

Prima di iniziare

Prima di poter completare questi passaggi, devi avere un servizio di gestione e almeno un cluster utente.

Versioni di Kubernetes supportate

GKE su AWS aws-1.14.1-gke.0 supporta le seguenti versioni di Kubernetes:

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

Per informazioni sulle versioni precedenti supportate, consulta le note di rilascio.

Nota: Kubernetes 1.19, 1.20 e 1.21 non sono più supportati da GKE su AWS.

Upgrade dei componenti

Questa sezione descrive l'upgrade di AWSCluster e AWSNodePools.

AWSCluster

Puoi aggiornare un AWSCluster a una nuova versione di GKE su AWS senza aggiornare i pool AWSNode.

AWSNodePools

Non puoi aggiornare un AWSNodePool a una versione più recente del tuo AWSCluster. Per aggiornare AWSNodePools, devi prima aggiornare AWSCluster.

La versione di AWSNodePools non deve essere inferiore a due versioni secondarie rispetto alla versione di AWSCluster.

Esegui l'upgrade di un AWSCluster e di AWSNodePool esistenti

Per eseguire l'upgrade del cluster, aggiorna il campo version degli oggetti AWSCluster e AWSNodePool nel servizio di gestione.

AWSCluster

Per eseguire l'upgrade di un AWSCluster, esegui questi passaggi:

1. Dalla directory anthos-aws, utilizza anthos-gke per cambiare contesto al servizio di gestione.

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

   Nota: anthos-gke utilizza le credenziali che hai specificato quando hai eseguito aws configure.

2. Apri il file YAML che ha creato il tuo AWSCluster in un editor di testo. Se non disponi del file YAML iniziale, puoi usare kubectl edit.

   Modifica YAML

   Se hai seguito le istruzioni riportate in Creazione di un cluster utente, il file YAML sarà denominato cluster-0.yaml. Apri il file in un editor di testo.

   Modifica kubectl

   Per utilizzare kubectl edit per modificare il cluster AWS, esegui questo comando:

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

   Sostituisci cluster-name con il tuo AWSCluster. Ad esempio, per modificare il cluster predefinito, cluster-0, esegui questo comando:

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

3. Aggiorna il campo spec.controlPlane.version a una nuova versione di GKE su AWS. La versione più recente è 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
     ...
   

   Sostituisci gke-version con la versione di Kubernetes che preferisci. La versione di Kubernetes supportata più recente è 1.25.5-gke.2100.

   Nota: il downgrade di un cluster a una versione precedente non è supportato.

4. Salva il file. Se utilizzi kubectl edit, kubectl applica le modifiche automaticamente. Se stai modificando il file YAML, applicalo al tuo servizio di gestione con il seguente comando:

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

   Il servizio di gestione aggiorna quindi AWSCluster.

AWSNodePool

Per eseguire l'upgrade di un AWSNodePool, segui questi passaggi:

1. Dalla directory anthos-aws, utilizza anthos-gke per cambiare contesto al servizio di gestione.

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

   Nota: anthos-gke utilizza le credenziali che hai specificato quando hai eseguito aws configure.

2. Apri il file YAML che ha creato il tuo AWSNodePool in un editor di testo. Se hai seguito le istruzioni riportate in Creazione di un cluster utente, questo file sarà denominato cluster-0.yaml.

3. Aggiorna il valore di spec.version nelle risorse 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
     ...
   

   Sostituisci gke-version con la versione di Kubernetes che preferisci. La versione di Kubernetes supportata più recente è 1.25.5-gke.2100.

   Nota: il downgrade di un AWSNodePool a una versione precedente non è supportato.

4. Applica la nuova configurazione al servizio di gestione con kubectl.

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

   Il servizio di gestione aggiorna quindi AWSNodePool un nodo alla volta. Prima dell'arresto di un nodo, i pod in esecuzione su quel nodo ricevono un SIGTERM. Se un pod non viene arrestato dopo un periodo di tolleranza, riceve un SIGKILL.

   Nota: durante un upgrade, i carichi di lavoro vengono riavviati su nuovi nodi. Potresti riscontrare tempi di inattività durante un upgrade durante il riavvio dei carichi di lavoro su un nuovo nodo.

Visualizza stato

Per ottenere lo stato di un upgrade, esegui kubectl get AWSClusters sul tuo servizio di gestione.

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

L'output include il nome, lo stato, l'età, la versione e l'endpoint di ogni cluster. Ad esempio, il seguente output include un elemento AWSCluster denominato cluster-0.

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

L'upgrade del cluster utente è completo quando lo STATE dei cluster è impostato su Provisioning effettuato.