Esegui l'upgrade della versione del cluster Azure
Questa pagina spiega come eseguire l'upgrade della versione Kubernetes dei tuoi cluster GKE su Azure.
Prerequisiti
L'upgrade della versione Kubernetes del tuo cluster è un caso specifico dell'operazione più generale di aggiornamento del cluster. Per ulteriori informazioni sulle operazioni di aggiornamento del cluster, consulta la pagina Aggiorna il cluster in generale. 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 dalla versione 1.20 alla versione 1.22, devi prima eseguire l'upgrade dalla versione 1.20 alla versione 1.21.
- Devi disporre dell'autorizzazione
gkemulticloud.googleapis.com/azureClusters.update
Identity and Access Management.
Come GKE su Azure esegue gli aggiornamenti
Poiché l'upgrade di un cluster richiede il riavvio dei nodi del piano di controllo, GKE su Azure esegue un "aggiornamento in sequenza" con i seguenti passaggi:
- Scegli un'istanza del piano di controllo da aggiornare. GKE su Azure aggiorna le istanze in stato non integro, se presenti, prima di quelle in stato integro.
- Elimina l'istanza. GKE su Azure ricrea l'istanza e l'istanza si avvia con la nuova configurazione.
- Esegui i controlli di integrità sulla nuova istanza.
- Se i controlli di integrità hanno esito positivo, seleziona un'altra istanza ed esegui gli stessi passaggi. Ripeti questo ciclo fino a quando tutte le istanze non vengono riavviate o ricreate.
Se il controllo di integrità non va a buon fine, GKE su Azure
mette il cluster in uno stato
DEGRADED
e interrompe l'aggiornamento. Per saperne di più, consulta la sezione seguente.
Quando un aggiornamento non va a buon fine
Dopo un aggiornamento, GKE su Azure esegue un controllo di integrità sul cluster.
Se il controllo di integrità non va a buon fine, il cluster viene contrassegnato come DEGRADED
. Puoi visualizzare lo stato del cluster con il seguente comando di Google Cloud CLI:
gcloud container azure clusters describe CLUSTER_NAME \
--location=GOOGLE_CLOUD_LOCATION
Sostituisci quanto segue:
CLUSTER_NAME
: il nome del clusterGOOGLE_CLOUD_LOCATION
: la regione Google Cloud che gestisce il cluster
Esegui l'upgrade
Controlla la versione del cluster
Prima di eseguire l'upgrade della versione del cluster, usa il comando seguente per verificare quali versioni sono disponibili nella tua regione:
gcloud container azure get-server-config \
--location=GOOGLE_CLOUD_LOCATION
Sostituisci GOOGLE_CLOUD_LOCATION
con la località Google Cloud
da cui gestisci i cluster.
Scegli 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 maggiori informazioni, consulta Connessione e autenticazione al cluster.
Console
Nella console Google Cloud, vai alla pagina della panoramica dei cluster di Google Kubernetes Engine.
Seleziona il progetto Google Cloud in cui si trova il cluster.
Nell'elenco dei cluster, seleziona il nome del cluster, quindi seleziona Visualizza dettagli nel riquadro laterale.
Nella scheda Dettagli, seleziona
Esegui l'upgrade.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 quando esegui l'upgrade del cluster devi eseguire l'upgrade tramite tutte le versioni secondarie.
gcloud
Per eseguire l'upgrade della versione Kubernetes del tuo cluster, esegui questo comando:
gcloud container azure clusters update CLUSTER_NAME \
--location=GOOGLE_CLOUD_LOCATION \
--cluster-version=CLUSTER_VERSION
Sostituisci quanto segue:
CLUSTER_NAME
: nome del clusterGOOGLE_CLOUD_LOCATION
: la regione Google Cloud supportata che gestisce il cluster, ad esempious-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.
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 tramite tutte le versioni secondarie quando esegui l'upgrade del cluster
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/azureClusters/CLUSTER_ID?update_mask=controlPlane.Version
Sostituisci quanto segue:
ENDPOINT
: il tuo endpoint di servizio Google CloudPROJECT_ID
: il tuo progetto Google CloudGOOGLE_CLOUD_LOCATION
: la regione Google Cloud supportata che gestisce il cluster, ad esempious-west1
CLUSTER_ID
: l'ID del tuo cluster
Per ulteriori informazioni, consulta la documentazione relativa al metodo projects.locations.azureClusters.patch
.
Esegui l'upgrade dei pool di nodi
Dopo aver eseguito l'upgrade della versione del cluster, esegui l'upgrade dei pool di nodi per completare il processo. Per scoprire come fare, consulta Aggiornare un pool di nodi.
Passaggi successivi
Scopri come eseguire altri aggiornamenti del cluster.
Per saperne di più sui campi aggiornabili, consulta la documentazione di riferimento di
gcloud container azure clusters update
.Consulta la documentazione dell'API REST
projects.locations.azureClusters.patch
.