Aggiornamento di un cluster

Questa pagina illustra le impostazioni che puoi aggiornare nel cluster di amministrazione e nei cluster utente.

In genere, modifichi una singola impostazione in un file di configurazione e poi esegui il comando gkectl update con i parametri appropriati. Per aggiornare più impostazioni, modificane una alla volta ed esegui il comando più volte.

Il comando gkectl update ha uno dei seguenti formati, insieme ai parametri appropriati per la funzionalità che vuoi aggiornare:

Cosa può e non può essere aggiornato nei cluster

Molte funzionalità del cluster di amministrazione e dei cluster utente non possono essere aggiornate dopo la creazione del cluster.

Per vedere quali impostazioni possono essere aggiornate per il cluster di amministrazione, esegui:

gkectl update admin --help

Per vedere quali impostazioni possono essere aggiornate per un cluster utente, esegui:

gkectl update cluster --help

Aggiornamenti del cluster di amministrazione

Puoi aggiornare le varie funzionalità del tuo cluster di amministrazione.

Aggiorna il tipo di immagine del sistema operativo per il cluster di amministrazione

Puoi aggiornare il tipo di immagine del sistema operativo per il cluster di amministrazione in modo che utilizzi Ubuntu o COS.

Alloca indirizzi IP statici aggiuntivi

Se la tua configurazione utilizza indirizzi IP statici, devi verificarne il numero e, se necessario, aggiungerne altri quando esegui l'upgrade di una workstation o di un cluster di amministrazione.

Abilita o disabilita il ridimensionamento dei nodi per il piano di controllo di un cluster utente

Puoi attivare o disattivare il ridimensionamento automatico dei nodi del piano di controllo per il cluster utente. Questi nodi si trovano nel cluster di amministrazione.

Abilita o disabilita il backup del cluster

Per un cluster di amministrazione, puoi attivare il backup del cluster o disattivare il backup del cluster.

Abilita o disabilita le metriche delle risorse vSphere

Se modifichi il valore di stackdriver.disableVsphereResourceMetrics nel file di configurazione del cluster di amministrazione, esegui questo comando per aggiornare la configurazione:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Aggiorna il riferimento del certificato vCenter per il cluster di amministrazione

Se il certificato vCenter è stato modificato, aggiorna il riferimento del certificato vCenter. Devi aggiornare sia il cluster di amministrazione sia tutti i cluster utente.

Attiva il ridimensionamento automatico dei nodi aggiuntivi per il cluster di amministrazione (anteprima)

Puoi attivare o disattivare il ridimensionamento automatico dei nodi aggiuntivi per il cluster di amministrazione.

Abilita o disabilita la riparazione automatica dei nodi per il cluster di amministrazione (anteprima)

Puoi attivare o disattivare la riparazione automatica dei nodi per il cluster di amministrazione modificando l'impostazione appropriata nel file di configurazione del cluster di amministrazione ed eseguendo il comando gkectl update admin.

Abilita o disabilita i gruppi anti-affinità (anteprima)

Se modifichi il valore antiAffinityGroups.enabled nel file di configurazione del cluster di amministrazione, esegui questo comando per aggiornare la configurazione:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Sostituisci quanto segue:

  • ADMIN_CLUSTER_KUBECONFIG: percorso del file kubeconfig. Puoi omettere questo flag se il file si trova nella directory attuale e ha il nome kubeconfig.

  • ADMIN_CLUSTER_CONFIG_FILE: il percorso del file di configurazione del cluster di amministrazione. Puoi omettere questo flag se il file si trova nella directory attuale ed è denominato admin-cluster.yaml.

Abilita o disabilita il logging in Cloud Audit Logs per il cluster di amministrazione

Per abilitare il logging in Cloud Audit Logs, compila la sezione cloudAuditLogging nel file di configurazione del cluster di amministrazione, quindi aggiorna il cluster.

Per disabilitare il logging in Cloud Audit Logs, rimuovi la sezione cloudAuditLogging dal file di configurazione del cluster di amministrazione, quindi aggiorna il cluster.

Questa sezione è obbligatoria nel cluster di amministrazione se vuoi gestire il ciclo di vita dei cluster utente nella console Google Cloud.

Per aggiornare il cluster:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Sostituisci quanto segue:

  • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  • ADMIN_CLUSTER_CONFIG_FILE: il percorso del file di configurazione del cluster di amministrazione.

Abilita o disabilita il logging e il monitoraggio per il cluster di amministrazione

Per abilitare Cloud Logging e Cloud Monitoring, compila la sezione stackdriver nel file di configurazione del cluster di amministrazione, quindi aggiorna il cluster:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Sostituisci quanto segue:

  • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  • ADMIN_CLUSTER_CONFIG_FILE: il percorso del file di configurazione del cluster di amministrazione.

Per disabilitare Cloud Logging e Cloud Monitoring, rimuovi la sezione stackdriver dal file di configurazione del cluster di amministrazione, quindi aggiorna il cluster.

La sezione stackdriver è obbligatoria per impostazione predefinita, quindi per rimuoverla devi includere il flag --skip-validation-stackdriver:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config ADMIN_CLUSTER_CONFIG_FILE
    --skip-validation-stackdriver

La sezione stackdriver è obbligatoria nel cluster di amministrazione se vuoi gestire il ciclo di vita dei cluster utente nella console Google Cloud.

Registra un cluster di amministrazione

Quando crei un cluster di amministrazione, puoi registrarlo compilando la sezione gkeConnect nel file di configurazione del cluster. Se non hai registrato il cluster al momento della sua creazione, puoi registrarlo in seguito modificando il file di configurazione per aggiungere la sezione gkeConnect, quindi esegui il comando gkectl update admin.

Questa sezione è obbligatoria nel cluster di amministrazione se vuoi gestire il ciclo di vita dei cluster utente nella console Google Cloud.

Ruota una chiave dell'account di servizio connect-register per il cluster di amministrazione

Per ruotare una chiave dell'account di servizio connettiti, utilizza il comando gkectl update credentials come descritto in Rotazione delle chiavi dell'account di servizio.

Aggiornamenti dei cluster utente

Puoi aggiornare i tuoi cluster utente modificando l'impostazione nel file di configurazione degli utenti, quindi eseguendo gkectl update cluster con i parametri appropriati. Ecco le modifiche che puoi apportare ai tuoi cluster utente.

Alloca indirizzi IP statici aggiuntivi

Se la tua configurazione utilizza indirizzi IP statici, devi verificare quanti sono in uso e, se necessario, aggiungerne altri quando apporti una di queste modifiche:

Ridimensiona un cluster utente aggiornando le impostazioni di nodePool

Puoi ridimensionare un cluster utente aggiornando il valore replicas nella sezione nodePools e quindi eseguendo il comando gkectl update cluster.

Abilita o disabilita le metriche delle risorse vSphere

Puoi abilitare o disabilitare le metriche delle risorse vSphere nel file di configurazione del cluster utente, quindi eseguire il comando gkectl update cluster.

Aggiorna il riferimento del certificato vCenter per i cluster utente

Se il certificato vCenter è stato modificato, aggiorna il riferimento del certificato vCenter. Devi aggiornare sia il cluster di amministrazione sia tutti i cluster utente.

Registra un cluster utente

Quando crei un cluster, puoi registrarlo compilando la sezione gkeConnect nel file di configurazione del cluster utente prima di poterlo creare. Se non hai registrato il cluster al momento della sua creazione, puoi quindi registrare un cluster utente esistente modificando il file di configurazione per aggiungere la sezione gkeConnect, quindi esegui il comando gkectl update cluster.

Abilita o disabilita il logging e il monitoraggio per un cluster utente (anteprima)

Per abilitare il logging e il monitoraggio, compila la sezione stackdriver nel file di configurazione del cluster utente, quindi aggiorna il cluster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

Sostituisci quanto segue:

  • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  • USER_CLUSTER_CONFIG_FILE: il percorso del file di configurazione del cluster utente.

Per disabilitare il logging e il monitoraggio, rimuovi la sezione stackdriver dal file di configurazione del cluster utente, quindi aggiorna il cluster.

La sezione stackdriver è obbligatoria per impostazione predefinita, quindi per rimuoverla devi includere il flag --skip-validation-stackdriver:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config USER_CLUSTER_CONFIG_FILE
    --skip-validation-stackdriver

Attiva o disattiva la riparazione automatica dei nodi per i cluster utente

Puoi attivare o disattivare la riparazione automatica dei nodi per l'utente modificando l'impostazione appropriata nel file di configurazione del cluster utente ed eseguendo il comando gkectl update cluster.

Ridimensionamento automatico di un nodo in un cluster utente

Per abilitare il ridimensionamento automatico di un nodo in un cluster utente, modifica il file di configurazione del cluster utente ed esegui il comando gkectl update.

Abilita o disabilita l'audit logging di Cloud su un cluster utente

Puoi abilitare l'audit logging di Cloud o disabilitarlo.

Disattiva driver vSphere CSI

Per impostazione predefinita, il driver vSphere CSI è abilitato. Puoi disabilitare il driver vSphere CSI.

Ruota una chiave dell'account di servizio connect-register per un cluster utente

Per ruotare una chiave dell'account di servizio connettiti, utilizza il comando gkectl update credentials come descritto in Rotazione delle chiavi dell'account di servizio.

Aggiorna la configurazione di Windows Server per utilizzare containerd e Windows Dataplane V2

Se la configurazione include un pool di nodi di nodi di sistema operativo Windows Server, tieni presente che Docker e Flannel verranno ritirati in una release futura. Ti consigliamo di aggiornare ora i tuoi cluster utente per utilizzare containerd e Windows Dataplane V2.

Per eseguire questo aggiornamento:

  1. Imposta enableWindowsDataplaneV2 su true nel file di configurazione del cluster utente.

  2. Esegui il comando gkectl update cluster.

Aggiorna configurazione MetalLB

Puoi aggiornare i pool di indirizzi MetalLB nel file di configurazione del cluster utente. Puoi anche attivare o disattivare MetalLB in qualsiasi pool di nodi aggiornando il valore enableLoadBalancer nella sezione nodePools. Apporta le modifiche necessarie nel file di configurazione e chiama gkectl update cluster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONIFG --config USER_CLUSTER_CONFIG

Sostituisci quanto segue:

  • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  • USER_CLUSTER_CONFIG_FILE: il percorso del file di configurazione del cluster utente.