Aggiornamento di un cluster

Version 1.16 

• Versione più recente
• Versione 1.16
• Versioni precedenti (non supportate)

In questa pagina vengono descritte le impostazioni che puoi aggiornare nel cluster di amministrazione e nei cluster utente.

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

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

• gkectl update credentials: utilizza questa impostazione per aggiornare le credenziali del cluster.

• gkectl update admin: esegui questo comando dopo aver apportato una modifica al file di configurazione del cluster di amministrazione per aggiornare il cluster di amministrazione.

• gkectl update cluster: esegui questo comando dopo aver apportato una modifica al file di configurazione del cluster utente per aggiornare il cluster utente.

Elementi che possono e non possono essere aggiornati nei cluster

Molte funzionalità sia nel cluster di amministrazione che nei 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 varie funzionalità del 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 da utilizzare Ubuntu o COS.

Alloca indirizzi IP statici aggiuntivi

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

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

Puoi enable o disabilitare 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 abilitare il backup del cluster o disabilitare 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 è cambiato, aggiorna il riferimento del certificato vCenter. Devi aggiornare sia il cluster di amministrazione sia tutti i cluster utente.

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

Puoi enable o disabilitare il ridimensionamento automatico dei nodi dei componenti aggiuntivi per il cluster di amministrazione.

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

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

• Abilita la riparazione dei nodi e il controllo di integrità per un cluster di amministrazione esistente

• Disabilita la riparazione dei nodi e il controllo di integrità per un cluster di amministrazione esistente

Attiva o disattiva i gruppi anti-affinità (anteprima)

Se modifichi il valore di 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: il 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 e ha il nome admin-cluster.yaml.

Nota: la modifica delle impostazioni di antiAffinityGroups attiva la ricreazione dei nodi dei componenti aggiuntivi dei cluster di amministrazione e dei nodi del piano di controllo dei cluster utente nel cluster di amministrazione tramite un aggiornamento in sequenza, in modo che le regole di antiaffinità della macchina virtuale corrispondenti e le etichette dei nodi possano essere aggiornate di conseguenza. Questo processo potrebbe causare un'interruzione temporanea dei carichi di lavoro di sistema in esecuzione su questi nodi. Presta attenzione se apporti modifiche di questo tipo.

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 per la prima volta un cluster di amministrazione, puoi registrarlo compilando la sezione gkeConnect nel file di configurazione del cluster di amministrazione prima di crearlo. Se non hai registrato il cluster al momento della creazione, puoi registrarlo in un secondo momento modificando il file di configurazione per aggiungere la sezione gkeConnect, quindi eseguire 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 di registrazione della connessione per il cluster di amministrazione

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

Aggiornamenti del cluster utente

Puoi aggiornare i cluster utente modificando l'impostazione nel file di configurazione utente ed eseguendo gkectl update cluster con i parametri appropriati. Di seguito sono riportate le modifiche che puoi apportare ai cluster utente.

Alloca indirizzi IP statici aggiuntivi

Se la tua configurazione utilizza indirizzi IP statici, devi verificarne il numero e, se necessario, aggiungerne altri quando apporti una di queste modifiche:

• Ridimensiona un cluster utente.

• Crea o aggiorna un pool di nodi.

• Esegui l'upgrade di un cluster utente.

Ridimensiona un cluster utente aggiornando le impostazioni di nodePool

Per ridimensionare un cluster utente, puoi aggiornare il valore replicas nella sezione nodePools ed eseguire 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 è cambiato, 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 crearlo. Se non hai registrato il cluster al momento della creazione, puoi successivamente registrare un cluster utente esistente modificando il file di configurazione per aggiungere la sezione gkeConnect ed eseguire 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

Abilita o disabilita la riparazione automatica dei nodi per i cluster utente

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

• Abilita la riparazione dei nodi e il controllo di integrità per un cluster utente esistente

• Disabilita la riparazione dei nodi e il controllo di integrità per un cluster utente esistente

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 disabilitare l'audit logging di Cloud.

Disabilita il driver CSI vSphere

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

Ruota una chiave dell'account di servizio di registrazione della connessione per un cluster utente

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

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

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

Per eseguire questo aggiornamento:

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

   Nota: durante l'upgrade del cluster da Flannel a Windows Dataplane V2, i pod in esecuzione sui nodi che utilizzano Flannel non possono comunicare con i pod in esecuzione sui nodi appena creati.

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 abilitare o disabilitare MetalLB in qualsiasi pool di nodi aggiornando il valore enableLoadBalancer nella sezione nodePools. Apporta le modifiche applicabili nel file di configurazione, quindi 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.

Aggiorna gruppo host del pool di nodi

Puoi aggiornare il gruppo host associato al pool di nodi modificando il campo vsphere.hostgroups nella configurazione del pool di nodi del cluster utente, che include le seguenti operazioni:

• Crea un nuovo pool di nodi con il gruppo host specificato.
• Fornisci un gruppo host a un pool di nodi esistente che non ha un gruppo host.
• Aggiorna un pool di nodi esistente da un gruppo host a un altro.
• Rimuovi il gruppo host esistente dal pool di nodi.

Dopo aver modificato il campo vsphere.hostgroups, esegui il comando gkectl update cluster per aggiornare il pool di nodi.