Esegui l'upgrade della versione del cluster AWS

Questa pagina spiega come eseguire l'upgrade della versione di Kubernetes dei cluster GKE su AWS.

Prerequisiti

L'upgrade della versione di Kubernetes del cluster è un caso specifico dell'operazione di aggiornamento del cluster più generale. Puoi leggere informazioni generali sulle operazioni di aggiornamento dei cluster nella pagina Aggiorna il cluster. Per eseguire l'upgrade della versione del cluster:

  • Devi eseguire l'upgrade di ogni versione secondaria tra la versione attuale e quella di destinazione. Ad esempio, per eseguire l'upgrade da 1.20 a 1.22, devi prima eseguire l'upgrade da 1.20 a 1.21, quindi eseguire l'upgrade da 1.21 a 1.22.
  • Devi disporre dell'autorizzazione Identity and Access Management gkemulticloud.googleapis.com/awsClusters.update.

Modalità di esecuzione degli aggiornamenti di GKE su AWS

Poiché l'upgrade di un cluster richiede il riavvio dei nodi del control plane, GKE su AWS esegue un "aggiornamento in sequenza" con i seguenti passaggi:

  1. Scegli un'istanza del control plane da aggiornare. GKE su AWS aggiorna le istanze non integre, se presenti, prima di quelle integre.
  2. Crea un nuovo modello di avvio per l'istanza.
  3. Aggiorna il modello di avvio del gruppo di scalabilità automatica.
  4. Elimina l'istanza. AWS ricrea l'istanza e l'istanza si avvia con la nuova configurazione.
  5. Esegui controlli di integrità sulla nuova istanza.
  6. Se i controlli di integrità hanno esito positivo, seleziona un'altra istanza ed esegui gli stessi passaggi. Ripeti questo ciclo finché tutte le istanze non vengono riavviate o ricreate. Se il controllo di integrità non riesce, GKE su AWS imposta il cluster sullo stato DEGRADED e interrompe l'aggiornamento. Per ulteriori informazioni, consulta la sezione seguente.
  7. Elimina il modello di avvio originale.

Quando un aggiornamento non riesce

Dopo un aggiornamento, GKE su AWS esegue un controllo di integrità sul cluster. Se il controllo di integrità non riesce, il cluster viene contrassegnato come DEGRADED. Puoi visualizzare lo stato del cluster con il seguente comando Google Cloud CLI:

gcloud container aws clusters describe CLUSTER_NAME \
  --location=GOOGLE_CLOUD_LOCATION

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del tuo cluster
  • GOOGLE_CLOUD_LOCATION: la Google Cloud regione che gestisce il tuo cluster

Esegui l'upgrade

Controllare la versione del cluster

Prima di eseguire l'upgrade della versione del cluster, utilizza il seguente comando per verificare quali versioni sono disponibili nella tua regione:

gcloud container aws get-server-config \
    --location=GOOGLE_CLOUD_LOCATION

Sostituisci GOOGLE_CLOUD_LOCATION con la posizione Google Cloud da cui gestisci i cluster.

Scegliere un metodo di upgrade

Puoi eseguire l'upgrade della versione del cluster tramite la console Google Cloud , Google Cloud CLI o l'API GKE Multi-Cloud. Se vuoi utilizzare la console per eseguire l'upgrade di un cluster, devi prima scegliere e configurare un metodo di autenticazione per accedere al cluster. Per saperne di più, vedi Connettersi al cluster e autenticarsi.

Console

  1. Nella console Google Cloud , vai alla pagina Panoramica dei cluster Google Kubernetes Engine.

    Vai ai cluster GKE

  2. Seleziona il progetto Google Cloud in cui si trova il cluster.

  3. Nell'elenco dei cluster, seleziona il nome del cluster, poi seleziona Visualizza dettagli nel riquadro laterale.

  4. Nella scheda Dettagli, seleziona Esegui l'upgrade.

  5. Nella finestra di dialogo Esegui l'upgrade della versione di Kubernetes per il cluster, seleziona la versione a cui vuoi eseguire l'upgrade e fai clic su Fine. Tieni presente che devi eseguire l'upgrade di tutte le versioni secondarie quando esegui l'upgrade del cluster.

gcloud

Per eseguire l'upgrade della versione di Kubernetes del cluster, esegui il comando seguente:

gcloud container aws clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --cluster-version=CLUSTER_VERSION

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del cluster
  • GOOGLE_CLOUD_LOCATION: la regione Google Cloud supportata che gestisce il cluster, ad esempio us-west1
  • CLUSTER_VERSION: la nuova versione del cluster supportata

API

Per aggiornare il cluster tramite l'API, utilizza un'operazione PATCH sull'API GKE Multi-Cloud.

  1. Crea un file JSON denominato cluster_update.json con i seguenti contenuti:

    {
    "controlPlane": {
       "version": "CLUSTER_VERSION",
    },
}

    Sostituisci quanto segue:

    • CLUSTER_VERSION: la nuova versione del cluster supportata. Tieni presente che devi eseguire l'upgrade di tutte le versioni secondarie quando esegui l'upgrade del cluster

  2. Aggiorna queste impostazioni tramite l'API GKE Multi-Cloud con il seguente comando.

    curl -d @cluster_update.json -X PATCH \
   ENDPOINT/projects/PROJECT_ID/locations/GOOGLE_CLOUD_LOCATION/awsClusters/CLUSTER_ID?update_mask=controlPlane.Version

Sostituisci quanto segue:

  • ENDPOINT: il tuo Google Cloud endpoint di servizio
  • PROJECT_ID: il tuo Google Cloud progetto
  • GOOGLE_CLOUD_LOCATION: la regione Google Cloud supportata che gestisce il cluster, ad esempio us-west1
  • CLUSTER_ID: l'ID cluster

Per saperne di più, consulta la documentazione del metodo projects.locations.awsClusters.patch.

Esegui l'upgrade dei node pool

Dopo aver eseguito l'upgrade della versione del cluster, esegui l'upgrade dei node pool per completare la procedura. Per scoprire come fare, consulta Aggiornare un node pool.

Passaggi successivi