Questa pagina spiega come utilizzare la console Google Cloud o Google Cloud CLI per eseguire l'upgrade di un cluster utente o amministratore di Google Distributed Cloud registrato nell'API GKE On-Prem. Se hai creato il cluster utente utilizzando Terraform, puoi utilizzare Terraform per eseguire l'upgrade del cluster utente. Per i requisiti di upgrade, le best practice e altre informazioni sulla procedura 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 su Google Cloud che ti consente di gestire il ciclo di vita dei tuoi cluster on-premise utilizzando Terraform e strumentiGoogle Cloud standard. L'API GKE On-Prem viene eseguita nell'infrastruttura di Google Cloud. Terraform, la console Google Cloud e Google Cloud CLI sono clienti dell'API e la utilizzano per creare, aggiornare, eseguire l'upgrade ed 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
Configurare l'interfaccia a riga di comando gcloud
Per utilizzare gcloud CLI o Terraform per eseguire l'upgrade di un cluster:
Assicurati di avere la versione più recente della CLI gcloud. Aggiorna i componenti dell'interfaccia a riga di comando gcloud, se necessario:
gcloud components update
Requisiti IAM
Se non sei un proprietario del progetto, devi disporre del ruolo Identity and Access Managementroles/gkeonprem.admin
nel Google Cloud progetto in cui è stato creato il cluster. 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 disporre almeno di quanto segue:
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 nella console. 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-14 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.31.100 a 1.31.200 o da 1.30.100 a 1.31.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 utilizzano la stessa versione secondaria o una precedente. I cluster utente gestiti non possono essere meno di una versione secondaria rispetto al 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
Nella console, vai alla pagina Panoramica dei cluster Google Kubernetes Engine.
Seleziona il progetto Google Cloud e poi il cluster di cui vuoi eseguire l'upgrade.
Nel riquadro Dettagli, fai clic su Più dettagli.
Nella sezione Impostazioni di base del cluster, fai clic su
Esegui upgrade.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.
Fai clic su Esegui 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 di amministrazione. L'upgrade richiede almeno 30 minuti, a seconda delle dimensioni del cluster.
Per visualizzare lo stato dell'upgrade, fai clic su Mostra dettagli nella scheda Dettagli cluster.
Interfaccia a riga di comando gcloud
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 del progetto di hosting del parco risorse di cui il cluster è membro. Se hai creato il cluster utilizzandobmctl
, questo è l'ID progetto nel campogkeConnect.projectID
del file di configurazione del cluster.Se imposti
--location=-
, vengono elencati tutti i cluster in tutte le regioni. Se devi restringere l'elenco, imposta--location
su una regione specifica.
Se viene visualizzato un errore
PERMISSION_DENIED
, verifica l'ID progetto inserito. Se l'ID progetto è corretto, eseguigcloud auth login
per accedere all'interfaccia a Google Cloud CLI#39;account che ha accesso al progetto.Per 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 dell'host del parco risorse di cui il cluster è membro.REGION
: la Google Cloud regione in cui viene eseguita l'API GKE On-Prem e vengono archiviati i metadati del cluster.
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 del 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
è ilOPERATION_ID
dell'operazione a lunga esecuzione.Per conoscere lo stato dell'operazione, copia il valore
OPERATION_ID
dall'output nel seguente comando. 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.
Al termine dell'upgrade, nella finestra del terminale in cui hai eseguito il comando gcloud ... update
viene visualizzato un messaggio simile al seguente:
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.31.0-gke.889 abm-admin-cluster RUNNING
Per ulteriori informazioni sui campi e sui flag, consulta la documentazione di riferimento di gcloud container bare-metal admin-clusters.
Eseguire l'upgrade di un cluster utente
Console
Nella console, vai alla pagina Panoramica dei cluster Google Kubernetes Engine.
Seleziona il progetto Google Cloud e poi il cluster di cui vuoi eseguire l'upgrade.
Nel riquadro Dettagli, fai clic su Più dettagli.
Nella sezione Impostazioni di base del cluster, fai clic su
Esegui upgrade.Nell'elenco Scegli la versione di destinazione, seleziona la versione a cui vuoi eseguire l'upgrade.
Fai clic su Esegui 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. L'upgrade richiede almeno 30 minuti, a seconda delle dimensioni del cluster.
Per visualizzare lo stato dell'upgrade, fai clic su Mostra dettagli nella scheda Dettagli cluster.
Interfaccia a riga di comando gcloud
Se vuoi, elenca tutti i cluster di utenti registrati nel progetto per confermarne il nome e la regione:
gcloud container bare-metal clusters list \ --project=PROJECT_ID \ --location=-
Sostituisci
PROJECT_ID
con l'ID del progetto di hosting del parco risorse di cui il cluster è membro. Se hai creato il cluster utilizzandobmctl
, questo è l'ID progetto nel campogkeConnect.projectID
del file di configurazione del cluster.Se imposti
--location=-
, vengono elencati tutti i cluster in tutte le regioni. Se devi restringere l'elenco, imposta--location
su una regione specifica.
L'output del comando è simile al seguente:
NAME LOCATION VERSION ADMIN_CLUSTER STATE abm-user-cluster us-central1 1.31.0-gke.889 abm-admin-cluster RUNNING
Se viene visualizzato un errore
PERMISSION_DENIED
, verifica l'ID progetto inserito. Se l'ID progetto è corretto, eseguigcloud auth login
per accedere all'interfaccia a Google Cloud CLI#39;account che ha accesso al progetto.Per 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 da eseguire l'upgrade.PROJECT_ID
: l'ID del progetto dell'host del parco risorse di cui il cluster è membro.REGION
: la Google Cloud regione in cui viene eseguita l'API GKE On-Prem e in cui vengono archiviati 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 a cui puoi eseguire l'upgrade del cluster di utenti è1.14.6
.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 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
è ilOPERATION_ID
dell'operazione a lunga esecuzione.Per conoscere lo stato dell'operazione, copia il valore
OPERATION_ID
dall'output nel seguente comando. 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 container gcloud.
Terraform
Per eseguire l'upgrade di un cluster utilizzando Terraform, utilizza la stessa configurazione Terraform impiegata per creare il cluster.
Vai alla directory in cui si trova il file di configurazione Terraform.
Per 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 da eseguire l'upgrade.PROJECT_ID
: l'ID del progetto dell'host del parco risorse di cui fa parte il cluster utente.REGION
: la Google Cloud regione in cui viene eseguita l'API GKE On-Prem e in cui vengono archiviati i relativi metadati.
Se viene visualizzato un errore
PERMISSION_DENIED
, verifica l'ID progetto inserito. Se l'ID progetto è corretto, eseguigcloud auth login
per accedere all'interfaccia a Google Cloud CLI#39;account che ha accesso al progetto.Nella configurazione di Terraform, sostituisci
bare_metal_version
con la versione di Google Distributed Cloud a cui vuoi eseguire l'upgrade. Specifica una versione dall'output del comando precedente. Ti consigliamo di eseguire l'upgrade alla versione di patch più recente.Inizializza e crea il piano Terraform:
terraform init
Terraform installa le librerie necessarie, ad esempio il provider Google Cloud.
Esamina la configurazione e apporta le modifiche necessarie:
terraform plan
Applica il piano Terraform per creare il cluster utente:
terraform apply
Per informazioni sulla risorsa google_gkeonprem_bare_metal_cluster
, consulta la documentazione di riferimento.