Questa documentazione riguarda la versione più recente dei cluster Anthos su Azure, rilasciata il 3 novembre. Per ulteriori informazioni, consulta le note di rilascio.

Esegui l'upgrade della versione del cluster Azure

Questa pagina spiega come eseguire l'upgrade della versione di Kubernetes dei cluster Anthos sui cluster Azure.

Prerequisiti

L'upgrade della versione di Kubernetes del cluster è un caso specifico dell'operazione di aggiornamento del cluster più generale. Puoi leggere le informazioni sulle operazioni di aggiornamento dei cluster in generale nella pagina Aggiornare 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 gkemulticloud.googleapis.com/azureClusters.update Identity and Access Management.

In che modo Cluster Anthos on Azure esegue gli aggiornamenti

Poiché l'upgrade di un cluster richiede il riavvio dei nodi del piano di controllo, Cluster Anthos on Azure esegue un "aggiornamento in sequenza" con i seguenti passaggi:

  1. Scegli un'istanza di piano di controllo da aggiornare. I cluster Anthos su Azure aggiornano le istanze in stato non integro, se presenti, prima di quelle in stato integro.
  2. Elimina l'istanza. Cluster Anthos on Azure ricrea l'istanza e l'istanza si avvia con la nuova configurazione.
  3. Esegui controlli di integrità sulla nuova istanza.
  4. Se i controlli di integrità hanno esito positivo, seleziona un'altra istanza e segui la stessa procedura. Ripeti questo ciclo fino a quando tutte le istanze non vengono riavviate o ricreate. Se il controllo di integrità non va a buon fine, Cluster Anthos on Azure mette il cluster in uno stato DEGRADED e interrompe l'aggiornamento. Per ulteriori informazioni, consulta la sezione seguente.

Quando un aggiornamento non va a buon fine

Dopo un aggiornamento, Cluster Anthos on Azure esegue un controllo di integrità sul cluster. Se il controllo di integrità ha esito negativo, il cluster è contrassegnato come DEGRADED. Puoi visualizzare lo stato del cluster con il seguente comando dellGoogle Cloud CLI:

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

Sostituisci quanto segue:

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

Esegui l'upgrade

Controlla la versione del cluster

Prima di eseguire l'upgrade della versione del cluster, utilizza 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à di 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 Anthos Multi-Cloud. Se vuoi utilizzare la console per eseguire l'upgrade di un cluster, devi prima scegliere e configurare un metodo di autenticazione per l'accesso al cluster. Per maggiori informazioni, consulta la pagina Connettirsi e autenticarsi per il cluster.

Console

  1. Nella console Google Cloud, vai alla pagina Cluster Anthos.

    Vai a Cluster Anthos di Anthos

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

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

  4. Nella scheda Dettagli, seleziona Esegui upgrade.

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

gcloud

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

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

Sostituisci quanto segue:

API

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

  1. Crea un file JSON denominato cluster_update.json con il seguente contenuto:

    {
    "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 durante l'upgrade del cluster

  2. Aggiorna queste impostazioni tramite l'API Anthos 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:

Per ulteriori informazioni, consulta la documentazione del 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, consulta Aggiornare un pool di nodi.

Passaggi successivi