Esegui l'upgrade di un cluster di amministrazione o utente utilizzando i client dell'API GKE On-Prem

Questa pagina spiega come utilizzare la console Google Cloud o Google Cloud CLI per eseguire l'upgrade di un amministratore o di un cluster utente Google Distributed Cloud che sia registrato nella l'API GKE On-Prem. Se hai creato il cluster utente con Terraform, puoi utilizzare a Terraform per eseguire l'upgrade del cluster utente. Per i requisiti di upgrade, le best practice e ulteriori informazioni sul processo di upgrade, consulta Best practice per l'upgrade e Ciclo di vita e fasi degli upgrade dei cluster prima di procedere.

Che cos'è l'API GKE On-Prem?

L'API GKE On-Prem è un'API ospitata da Google Cloud che consente di gestire del ciclo di vita dei cluster on-premise utilizzando Terraform e gli strumenti di Google Cloud. L'API GKE On-Prem viene eseguita dell'infrastruttura. Terraform, la console Google Cloud e Google Cloud CLI che utilizzano l'API per creare, aggiornare, eseguire l'upgrade eliminare i cluster nel tuo data center. Se hai creato il cluster utilizzando un client standard, il cluster è registrato nell'API GKE On-Prem, il che significa che puoi utilizzare i client standard per gestire il ciclo di vita del cluster (con alcune eccezioni). Se hai creato il cluster utilizzando bmctl, puoi registrarlo nell' API GKE On-Prem, che ti consente di utilizzare i client standard.

Prima di iniziare

Configura gcloud CLI

Per utilizzare gcloud CLI o Terraform per eseguire l'upgrade di un cluster:

  1. Assicurati di avere la versione più recente della CLI gcloud. Aggiorna i componenti della gcloud CLI, se necessario:

    gcloud components update

Requisiti IAM

Se non sei un proprietario del progetto, devi disporre di Identity and Access Management. il ruolo roles/gkeonprem.admin nel progetto Google Cloud che il cluster in cui è stato creato. Per informazioni dettagliate sulle autorizzazioni incluse in questo ruolo, consulta Ruoli GKE on-premise nella documentazione IAM.

Per utilizzare la console per eseguire l'upgrade del cluster, devi avere le seguenti:

  • roles/container.viewer. Questo ruolo consente agli utenti di visualizzare la pagina GKE Clusters e altre risorse dei contenitori nella console. Per dettagli sulle autorizzazioni incluse in questo ruolo o per concedere un ruolo con autorizzazioni di lettura/scrittura, consulta Ruoli Kubernetes Engine nella documentazione IAM.

  • roles/gkehub.viewer. Questo ruolo consente agli utenti di visualizzare i cluster Google Cloud. Per informazioni dettagliate sulle autorizzazioni incluse in questo ruolo o per concedere un ruolo con autorizzazioni di lettura/scrittura, consulta Ruoli GKE Hub nella documentazione IAM.

Requisiti della versione

Sono necessari circa 7-10 giorni dopo una release di Google Distributed Cloud affinché la versione sia disponibile nell'API GKE On-Prem.

Puoi eseguire l'upgrade direttamente a una versione della stessa release secondaria o alla successiva release secondaria. Ad esempio, puoi eseguire l'upgrade da 1.30.100 a 1.30.200, oppure da 1.29.100 a 1.30.200. Non è consentito eseguire l'upgrade a una versione successiva alla versione installata di più di una release minore.

Un cluster di amministrazione può gestire i cluster utente che si trovano sullo stesso elemento o su una precedente completamente gestita. I cluster utente gestiti non possono avere una versione secondaria inferiore di più di una versione del cluster di amministrazione, quindi prima di eseguire l'upgrade di un cluster di amministrazione a una nuova versione secondaria, assicurati che tutti i cluster utente gestiti siano alla stessa versione secondaria del cluster di amministrazione.

Esegui l'upgrade di un cluster di amministrazione

Console

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

    Vai ai cluster GKE

  2. Seleziona il progetto Google Cloud, quindi seleziona il cluster che vuoi eseguire l'upgrade.

  3. Nel riquadro Dettagli, fai clic su Altri dettagli.

  4. Nella sezione Impostazioni di base del cluster, fai clic su Esegui upgrade.

  5. Nell'elenco Scegli la versione di destinazione, seleziona la versione a cui vuoi eseguire l'upgrade. Ti consigliamo di eseguire l'upgrade alla versione più recente della patch.

  6. Fai clic su Esegui l'upgrade.

Prima dell'upgrade del cluster, vengono eseguiti controlli preflight per convalidare il cluster e l'integrità del nodo. Se i controlli preflight vengono superati, viene eseguito l'upgrade del cluster di amministrazione. Il completamento dell'upgrade richiede almeno 30 minuti, a seconda in base alla dimensione del cluster.

Per visualizzare lo stato dell'upgrade, fai clic su Mostra dettagli nella finestra di dialogo Cluster Dettagli.

Interfaccia a riga di comando gcloud

  1. Se vuoi, elenca tutti i cluster amministrativi registrati nel progetto per confermare il nome e la regione del cluster:

    gcloud container bare-metal admin-clusters list \
  --project=PROJECT_ID \
  --location=-

    • Sostituisci PROJECT_ID con l'ID dell'host del parco risorse progetto di cui il cluster è membro. Se hai creato il cluster utilizzando bmctl, questo è l'ID progetto in gkeConnect.projectID nel file di configurazione del cluster.

    • Se imposti --location=-, vengono elencati tutti i cluster in tutte le regioni. Se devi restringere l'ambito dell'elenco, imposta --location su una regione specifica.

    Se viene visualizzato un errore PERMISSION_DENIED, controlla l'ID progetto inserito. Se l'ID progetto è corretto, esegui gcloud auth login per accedere all'interfaccia a riga di comando Google Cloud con l'account che ha accesso al progetto.

  2. Ottieni un elenco delle versioni disponibili a cui eseguire l'upgrade:

    gcloud container bare-metal admin-clusters query-version-config \
  --admin-cluster=ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION

    Sostituisci quanto segue:

    • ADMIN_CLUSTER_NAME: il nome del cluster di amministrazione.

    • PROJECT_ID: l'ID del progetto host del parco risorse di cui fa parte il cluster.

    • REGION: la regione Google Cloud in cui L'API GKE On-Prem esegue e archivia i metadati del cluster.

  3. Esegui l'upgrade del cluster di amministrazione:

    gcloud container bare-metal admin-clusters update ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --version=VERSION

    Sostituisci VERSION con la versione di Google Distributed Cloud di cui vuoi eseguire l'upgrade. Specifica una versione dall'output di il comando precedente. Ti consigliamo di eseguire l'upgrade alla versione con le patch più recenti.

    L'output del comando è simile al seguente:

    Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.

    Nell'output di esempio, la stringa operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 è il OPERATION_ID dell'operazione a lunga esecuzione.

    Per scoprire lo stato dell'operazione, copia OPERATION_ID dal tuo output nel seguente . Apri un'altra finestra del terminale ed esegui il comando.

    gcloud container bare-metal operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=REGION

L'upgrade richiede almeno 30 minuti, a seconda delle dimensioni del cluster. Durante l'upgrade del cluster, puoi eseguire la versione per ottenere lo stato attuale.

Una volta completato l'upgrade, vedrai qualcosa di simile al seguente nella la finestra del terminale dove hai eseguito il comando gcloud ... update:

Updated Anthos on bare metal Admin Cluster [https://gkeonprem.googleapis.com/v1/projects/example-project-1234/locations/us-central1/bareMetalAdminClusters/abm-admin-cluster].
NAME               LOCATION     VERSION     MEMBERSHIP         STATE
abm-admin-cluster  us-central1  1.30.200-gke.101      abm-admin-cluster  RUNNING

Per ulteriori informazioni su campi e flag, vedi Riferimento gcloud container bare-metal admin-clusters.

Esegui l'upgrade di un cluster utente

Console

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

    Vai ai cluster GKE

  2. Seleziona il progetto Google Cloud e poi il cluster di cui vuoi eseguire l'upgrade.

  3. Nel riquadro Dettagli, fai clic su Altri dettagli.

  4. Nella sezione Impostazioni di base del cluster, fai clic su Esegui upgrade.

  5. Nell'elenco Scegli la versione di destinazione, seleziona la versione che vuoi eseguire l'upgrade.

  6. Fai clic su Esegui l'upgrade.

Prima dell'upgrade del cluster, vengono eseguiti controlli preflight per convalidare lo stato del cluster e l'integrità del nodo. Se i controlli preflight vengono superati, viene eseguito l'upgrade del cluster utente. Il completamento dell'upgrade richiede almeno 30 minuti, a seconda in base alla dimensione del cluster.

Per visualizzare lo stato dell'upgrade, fai clic su Mostra dettagli nella finestra di dialogo Cluster Dettagli.

Interfaccia a riga di comando gcloud

  1. Facoltativamente, elenca tutti i cluster utente registrati nel progetto per confermare il nome e la regione del cluster:

    gcloud container bare-metal clusters list \
  --project=PROJECT_ID \
  --location=-

    • Sostituisci PROJECT_ID con l'ID dell'host del parco risorse progetto di cui il cluster è membro. Se hai creato il cluster utilizzando bmctl, questo è l'ID progetto nel campo gkeConnect.projectID del file di configurazione del cluster.

    • Se imposti --location=-, vengono elencati tutti i cluster in tutte le regioni. Se devi restringere l'ambito dell'elenco, imposta --location su un una regione specifica.

    L'output del comando è simile al seguente:

    NAME              LOCATION     VERSION  ADMIN_CLUSTER      STATE
abm-user-cluster  us-central1  1.30.200-gke.101   abm-admin-cluster  RUNNING

    Se viene visualizzato un errore PERMISSION_DENIED, verifica l'ID progetto inserito. Se l'ID progetto è corretto, esegui gcloud auth login per accedere all'interfaccia a riga di comando Google Cloud con l'account che ha accesso al progetto.

  2. Ottieni un elenco delle versioni disponibili a cui eseguire l'upgrade:

    gcloud container bare-metal clusters query-version-config \
  --cluster=USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION

    Sostituisci quanto segue:

    • USER_CLUSTER_NAME: il nome del cluster di utenti di cui eseguire l'upgrade.

    • PROJECT_ID: l'ID del progetto host del parco risorse di cui il cluster è membro.

    • REGION: la regione Google Cloud in cui L'API GKE On-Prem esegue e archivia i metadati del cluster.

    L'output del comando è simile al seguente

    versions:
- hasDependencies: true
version: 1.15.2
- hasDependencies: true
version: 1.15.1
- hasDependencies: true
version: 1.15.0
- version: 1.14.6

    Scegli una versione non indicata in - hasDependencies: true. In questo esempio, l'unica versione disponibile di cui puoi eseguire l'upgrade il cluster utente è 1.14.6.

  3. Esegui l'upgrade del cluster utente:

    gcloud container bare-metal clusters update USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --version=VERSION

    Sostituisci VERSION con la versione di Google Distributed Cloud di cui vuoi eseguire l'upgrade. Specifica una versione dall'output del comando precedente. Ti consigliamo di eseguire l'upgrade alla patch più recente completamente gestita.

    L'output del comando è simile al seguente:

    Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.

    Nell'output di esempio, la stringa operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 è il OPERATION_ID dell'operazione a lunga esecuzione.

    Per scoprire lo stato dell'operazione, copia OPERATION_ID dal tuo output nel seguente . Apri un'altra finestra del terminale ed esegui il comando.

    gcloud container bare-metal operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=REGION

L'upgrade richiede almeno 30 minuti, a seconda delle dimensioni del cluster. Durante l'upgrade del cluster, puoi eseguire il comando precedente di tanto in tanto per ottenere lo stato corrente.

Per ulteriori informazioni sui campi e sui flag, consulta la documentazione di riferimento dei cluster bare metal di gcloud container.

Terraform

Per eseguire l'upgrade di un cluster utilizzando Terraform, devi utilizzare la stessa configurazione Terraform utilizzato per creare il cluster.

  1. Vai alla directory in cui si trova il file di configurazione Terraform.

  2. Per un elenco delle versioni a cui puoi eseguire l'upgrade:

    gcloud container bare-metal clusters query-version-config \
  --cluster=USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION

    Sostituisci quanto segue:

    • USER_CLUSTER_NAME: il nome del cluster utente da upgrade.

    • PROJECT_ID: l'ID del progetto host del parco risorse di cui fa parte il cluster utente.

    • REGION: la regione Google Cloud in cui L'API GKE On-Prem esegue e archivia i relativi metadati.

    Se viene visualizzato un errore PERMISSION_DENIED, verifica l'ID progetto inserito. Se l'ID progetto è corretto, esegui gcloud auth login per accedere all'interfaccia a riga di comando Google Cloud con l'account che ha accesso al progetto.

  3. Nella configurazione di Terraform, cambia bare_metal_version in Versione Google Distributed Cloud a cui vuoi eseguire l'upgrade. Specifica un valore la versione precedente dall'output del comando precedente. Ti consigliamo di eseguire l'upgrade alla versione di patch più recente.

  4. Inizializza e crea il piano Terraform:

    terraform init

    Terraform installa le librerie necessarie, ad esempio il fornitore Google Cloud.

  5. Esamina la configurazione e apporta le modifiche necessarie:

    terraform plan

  6. Applica il piano Terraform per creare il cluster utente:

    terraform apply

Per informazioni sulla risorsa google_gkeonprem_bare_metal_cluster, consulta documentazione di riferimento.