Puoi convertire un cluster della versione 1.32 in un cluster avanzato aggiornandolo in loco alla versione 1.32 o eseguendo l'upgrade alla versione 1.33. La conversione a un cluster avanzato prepara l'ambiente per la versione 1.33 e successive, in cui i cluster avanzati sono l'architettura predefinita o richiesta.
Differenze principali dopo il passaggio ai cluster avanzati
L'upgrade o l'aggiornamento del cluster a un cluster avanzato introduce diverse differenze chiave rispetto ai cluster standard. Ecco le principali modifiche nei cluster avanzati:
Località delle risorse: le risorse del cluster e della macchina non si trovano più nei cluster utente. Queste risorse si trovano esclusivamente all'interno del cluster di amministrazione.
NodeExternalIP:NodeExternalIPnon è impostato sui nodi.Installazione di
cert-manager:cert-managerviene installato automaticamente sui cluster avanzati. Se hai installatocert-managernel tuo cluster, l'aggiornamento o l'upgrade al cluster avanzato lo sovrascrive con la versione del cluster avanzato.
Differenze di funzionalità tra cluster avanzati e non avanzati
Quando attivi i cluster avanzati, alcune funzionalità non funzionano allo stesso modo dei cluster non avanzati. Alcune di queste modifiche si applicano solo alla versione di anteprima dei cluster avanzati nella versione 1.31. Le differenze sono indicate nella documentazione.
La tabella seguente elenca le funzionalità supportate per il software Google Distributed Cloud solo per VMware, il relativo stato di disponibilità quando i cluster avanzati sono abilitati e le eventuali differenze di comportamento o utilizzo:
| Funzionalità/capacità | 1.31 Cluster avanzati (anteprima) | 1.32 Non abilitata | Cluster Advanced 1.32 (GA) | Cluster avanzati 1.33 (GA) | Differenze |
|---|---|---|---|---|---|
| Cluster avanzati | Anteprima | GA | GA | GA | Non supportata |
| Domini di topologia | Anteprima | Anteprima | Anteprima | Le modifiche vengono applicate. Per saperne di più, consulta Configura i domini di topologia e i riferimenti alla configurazione del cluster correlati. | |
| Appartenenza al parco risorse regionale | GA | GA | GA | GA | Nessuna differenza. |
| Disallineamento delle versioni n+2 tra cluster di amministrazione e cluster utente | GA | GA | GA | Sconsigliato: poiché la gestione di un cluster utente di anteprima con una versione precedente non è supportata, non utilizzare questa funzionalità. | |
| Disallineamento delle versioni n+2 del pool di nodi - cluster utente | GA | GA | GA | Sconsigliato: poiché la gestione di un cluster utente di anteprima con una versione precedente non è supportata, non utilizzare questa funzionalità. | |
| Impostazione di sovraccarico massimo per gli pool di nodi pool | Anteprima | Anteprima | Anteprima | Anteprima | Nessuna differenza. |
| cgroup v2 per i nodi | GA | GA | GA | GA | Nessuna differenza. |
| Modalità DSR per Dataplane V2 | GA | GA | GA | GA | Nessuna differenza. |
| Autorizzazione binaria per i cluster utente Controlplane V2 | GA | GA | GA | GA | Nessuna differenza. |
| Workstation di amministrazione gestita dall'utente | GA | GA | GA | GA | Nessuna differenza. |
| Strumento di migrazione CSI di StatefulSet | GA | GA | GA | GA | Nessuna differenza. |
| Migrazione da Seesaw a MetalLB | GA | GA | GA | GA | Nessuna differenza. |
| Disattiva traffico in entrata in bundle | GA | GA | GA | GA | Nessuna differenza. |
| Credenziali preparate del cluster di amministrazione | GA | GA | GA | Nessuna differenza. | |
| Policy di archiviazione per un cluster utente | GA | GA | GA | GA | Nessuna differenza. |
| Policy di archiviazione per un cluster di amministrazione | GA | GA | GA | GA | Nessuna differenza. |
| Riparazione automatica dei nodi | GA | GA | GA | GA | Modifiche applicate: se il cluster avanzato è abilitato, i controlli di integrità periodici non vengono eseguiti nell'ambito della riparazione automatica. Per informazioni e altre differenze, consulta Riparazione automatica dei nodi e controllo di integrità. |
| Cluster di amministrazione ad alta affidabilità | GA | GA | GA | GA | Nessuna differenza. |
| Affinità host VM | GA | GA | GA | Supportato su cluster avanzati nella versione 1.32.200 e 1.33 e successive. Quando utilizzi i domini di topologia, configura i gruppi di host in topologyDomains[i].compute.hostGroups nel file di configurazione dell'infrastruttura vSphere anziché nodePools[i].vsphere.hostgroups nel file di configurazione del cluster utente. |
|
| Genera file di configurazione da un cluster esistente | GA | GA | GA | GA | Le modifiche vengono applicate. I cluster che utilizzano domini di topologia non sono supportati. |
| Raccolta delle metriche di sistema di Google Cloud Managed Service per Prometheus | GA | GA | GA | GA | Nessuna differenza. |
| Upgrade e rollback dei node pool | GA | GA | GA | Nessuna differenza. | |
| Aggiorna le credenziali del registry privato | GA | GA | GA | GA | Nessuna differenza. |
| Backup e ripristino del cluster di amministrazione con gkectl | Anteprima | Anteprima | GA | Le modifiche vengono applicate. Aggiornato il comando gkectl per migliorare il ripristino dei cluster di amministrazione e supportare il backup e il ripristino dei cluster utente. Per maggiori informazioni, consulta
Esegui il backup e il ripristino dei cluster avanzati con gkectl. |
|
| Autoscaling del pool di nodi del cluster utente | GA | GA | GA | GA | Nessuna differenza. |
| Ridimensionamento automatico dei nodi del cluster | GA | GA | Nessuna differenza. | ||
| Supporto per cluster vSphere multipli | GA | GA | GA | GA | Nessuna differenza. |
| Supporto di più data center vSphere | GA | GA | GA | GA | Nessuna differenza. |
| Supporto di OpenID Connect (OIDC) per l'autenticazione ai cluster | GA | GA | GA | GA | Nessuna differenza. |
| Rotazione dei certificati CA | GA | GA | GA | Nessuna differenza. | |
| Supporto della federazione delle identità per i workload | GA | GA | GA | GA | Nessuna differenza. |
| GKE Identity Service con supporto dell'autenticazione LDAP | GA | GA | GA | GA | Nessuna differenza. |
| Crittografia dei secret sempre attiva senza modulo di sicurezza hardware (HSM) | GA | GA | GA | Nessuna differenza. | |
| Aggiorna i certificati CA vCenter con gkectl | GA | GA | GA | GA | Nessuna differenza. |
| Gateway NAT in uscita | GA | GA | GA | GA | Nessuna differenza. |
| Registrazione del cluster di amministrazione nel parco risorse | GA | GA | GA | GA | Nessuna differenza. |
| Supporto pool di nodi Windows | GA | Non supportati. | |||
Runtime containerd per il node pool Windows |
GA | Non supportati. | |||
| Supporto dei pool di nodi Container-Optimized OS | GA | GA | GA | Nessuna differenza. | |
| CoreDNS come provider DNS del cluster | GA | GA | GA | GA | Nessuna differenza. |
| Ciclo di vita del cluster utente nella console Google Cloud | GA | Supporto parziale | GA | Le modifiche vengono applicate. Per saperne di più, consulta Limitazioni dei cluster avanzati. | |
| Creazione dei nodi del cluster di amministrazione con Container-Optimized OS | GA | GA | GA | Nessuna differenza. | |
| Funzionalità multi-NIC per i pod | GA | GA | GA | GA | Nessuna differenza. |
| Opzione del bilanciatore del carico MetalLB | GA | GA | GA | GA | Le modifiche vengono applicate. Per maggiori dettagli, consulta Bilanciamento del carico in bundle con MetalLB. |
Supporto di gkectl update admin per l'abilitazione e la disabilitazione di Cloud Logging e Cloud Monitoring |
GA | GA | GA | GA | Nessuna differenza. |
| Supporto di Windows Dataplane V2 | GA | Non supportati. | |||
| Metriche API di riepilogo | GA | GA | GA | GA | Nessuna differenza. |
Supporto di gkectl update credentials per l'aggiornamento della chiave del account di servizio di accesso ai componenti |
Supporto parziale | GA | Supporto parziale | Supporto parziale | Le modifiche vengono applicate. Per informazioni dettagliate su ciò che è supportato o meno per l'aggiornamento delle credenziali per i cluster avanzati, consulta Differenze dei cluster avanzati per la rotazione delle chiavi dei account di servizio account. |
| Credenziali preparate per il cluster utente | GA | GA | GA | Nessuna differenza. | |
| Esegui il dry run dell'upgrade del cluster utente | GA | GA | GA | GA | Nessuna differenza. |
| Upgrade asincrono del cluster utente | GA | GA | GA | GA | Nessuna differenza. |
| Esegui il dry run dell'upgrade del cluster di amministrazione | GA | GA | Nessuna differenza. | ||
| Upgrade asincrono del cluster di amministrazione | GA | GA | GA | GA | Nessuna differenza. |
| Aggiornamento sequenziale dei node pool | GA | GA | GA | Nessuna differenza. | |
| Crea uno snapshot del volume con il driver CSI vSphere | Anteprima | Anteprima | Anteprima | Anteprima | Nessuna differenza. |
| Crea un cluster utente con Controlplane V2 abilitato | GA | GA | GA | GA | Nessuna differenza. |
| Migrazione dello spazio di archiviazione con SPBM | GA | GA | GA | GA | Nessuna differenza. |
| Esegui la migrazione di un datastore a un criterio SPBM | GA | GA | GA | GA | Nessuna differenza. |
| Esegui la migrazione di un cluster utente a Controlplane V2 | GA | GA | GA | GA | Nessuna differenza. |
| Esegui la migrazione a un cluster di amministrazione ad alta affidabilità | GA | GA | GA | GA | Nessuna differenza. |
| Esegui la migrazione delle impostazioni di configurazione per F5 BIG-IP | GA | GA | GA | GA | Nessuna differenza. |
| Bilanciatore del carico | Supporto parziale | GA | GA | GA | Le modifiche vengono applicate. Per saperne di più, consulta la documentazione di riferimento pertinente per la configurazione del bilanciatore del carico e del cluster. |
| Controlli preflight | Supporto parziale | GA | GA | GA | Nessuna differenza. |
| Requisiti hardware | GA | GA | GA | GA | Le modifiche vengono applicate. Per maggiori dettagli, vedi Requisiti di CPU, RAM e spazio di archiviazione. |
| Snapshot | GA | GA | GA | GA | Nessuna differenza. |
| Registro privato | GA | GA | GA | GA | Le modifiche vengono applicate. Per informazioni dettagliate sull'utilizzo di un registry privato su un cluster avanzato, consulta Limitazioni con i cluster avanzati e il bundle completo. |
| IPAM, DNS, NTP e multi-NIC | GA | GA | GA | GA | Nessuna differenza. |
| Creazione/upgrade/eliminazione del cluster | GA | GA | GA | GA | Le modifiche vengono applicate. Per saperne di più, consulta la documentazione relativa alle operazioni sui cluster e la sezione Limitazioni dei cluster avanzati. |
| Proxy | GA | GA | GA | GA | Nessuna differenza. |
| Policy di aggiornamento del pool di nodi | GA | GA | GA | Nessuna differenza. | |
| Diagnostica | GA | GA | GA | Le modifiche vengono applicate. I controlli relativi a vCenter non sono disponibili per i cluster avanzati. Poiché non esiste più un controller onprem-user-cluster-controller, la guida Diagnostica i problemi del cluster è obsoleta per i cluster avanzati. Per i cluster avanzati della versione 1.32, il comando gkectl diagnose cluster esegue i controlli di integrità per il cluster specificato. |
|
| Tag vSphere e monitoraggio delle VM | GA | GA | Nessuna differenza. | ||
| Gruppo di host vSphere | GA | GA | Nessuna differenza. | ||
| Logging e monitoraggio | GA | GA | GA | GA | Nessuna differenza. |
| Gruppi anti-affinità | GA | GA | GA | Nessuna differenza. | |
| Control plane del cluster utente non ad alta disponibilità | GA | Non supportati. | |||
gkectl check-config |
GA | GA | GA | Le modifiche vengono applicate. Il supporto del comando sui cluster utente avanzati è stato aggiunto nelle seguenti versioni: 1.32.700+, 1.33.300+ e 1.34.0 e successive. |
Prerequisiti
La versione di
gkectldeve essere la stessa della versione del cluster di destinazione.- Se necessario, consulta Scarica
gkectlper ottenere una versione supportata digkectl.
- Se necessario, consulta Scarica
Diagnostica sempre il cluster prima di eseguire l'aggiornamento o l'upgrade a un cluster Advanced:
- Esegui
gkectl diagnose clustersui cluster di amministrazione e utente per assicurarti che siano integri. - Se il comando segnala errori o avvisi, risolvili prima di avviare l'aggiornamento o l'upgrade a un cluster avanzato.
- Esegui
Assicurati che i cluster utilizzino solo le funzionalità consigliate.
Prima di iniziare l'aggiornamento o l'upgrade, verifica che i tuoi cluster non utilizzino funzionalità non supportate dai cluster avanzati. Se sono attive funzionalità non supportate, disattivale utilizzando prima update.
- Sebbene i cluster utente ad alta affidabilità (HA) siano obbligatori nei cluster avanzati, puoi comunque aggiornare o eseguire l'upgrade di un cluster utente non HA a un cluster avanzato HA seguendo questa guida.
Devi aggiornare o eseguire l'upgrade del cluster di amministrazione a un cluster avanzato prima di aggiornare o eseguire l'upgrade di qualsiasi cluster utente.
Informazioni sull'installazione di
cert-manager:cert-managerviene installato automaticamente sui cluster avanzati. Quando esegui la migrazione da un cluster non avanzato a un cluster avanzato,cert-managerintegrato sostituisce automaticamente qualsiasi versione dicert-managerinstallata dal cliente. Assicurati di non avere configurazioni o funzionalità personalizzate critiche applicate al tuocert-manageresistente prima di eseguire l'aggiornamento o l'upgrade ai cluster avanzati.
Aggiorna o esegui l'upgrade del cluster di amministrazione al cluster Advanced
Aggiorna
Esegui la diagnostica del cluster per assicurarti che sia integro:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG- Se il comando segnala errori o avvisi, consulta Diagnostica i problemi del cluster e risolvili prima di procedere.
Preparati per il cluster avanzato:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterSostituisci quanto segue:
BUNDLE_PATH: il percorso del file del bundle. Questo file si trova sulla tua workstation di amministrazione in/var/lib/gke/bundles/. Ad esempio:/var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgzADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.
Imposta
enableAdvancedClusternel file di configurazione del cluster di amministrazione sutrue.Aggiorna il cluster di amministrazione al cluster avanzato:
gkectl update admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIGSostituisci quanto segue:
ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.ADMIN_CLUSTER_CONFIG: il percorso del file di configurazione del cluster di amministrazione.
Il comando ricreerà tutti i nodi nel cluster di amministrazione.
Esegui l'upgrade
Esegui l'upgrade della workstation di amministrazione, se necessario.
Esegui la diagnostica del cluster per assicurarti che sia integro:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG- Se il comando segnala errori o avvisi, consulta Diagnostica i problemi del cluster e risolvili prima di procedere.
Preparati per il cluster avanzato:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterSostituisci quanto segue:
BUNDLE_PATH: il percorso del file del bundle. Questo file si trova sulla tua workstation di amministrazione in/var/lib/gke/bundles/. Ad esempio:/var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgzADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.
Imposta
enableAdvancedClusternel file di configurazione del cluster di amministrazione sutrue.Assicurati che il campo
bundlepathnel file di configurazione del cluster di amministrazione corrisponda al percorso del bundle di cui vuoi eseguire l'upgrade.Esegui l'upgrade del cluster di amministrazione al cluster avanzato:
gkectl upgrade admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIGSostituisci quanto segue:
ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.ADMIN_CLUSTER_CONFIG: il percorso del file di configurazione del cluster di amministrazione.
Il comando implementerà la ricreazione di tutti i nodi nel cluster di amministrazione. Con la strategia di deployment di ricreazione dell'implementazione, l'upgrade dei nodi viene eseguito uno alla volta. Durante l'upgrade del nodo, la VM viene eliminata e poi ricreata con la nuova versione.
Dopo che il cluster di amministrazione è stato aggiornato o è stato eseguito l'upgrade a un cluster avanzato:
I cluster utente non avanzati esistenti continuano a funzionare normalmente.
Puoi creare solo cluster utente avanzati gestiti dal cluster di amministrazione avanzato.
Esegui l'upgrade di tutti i cluster utente a cluster Advanced subito dopo per mantenere un ambiente coerente e completo.
Aggiorna o esegui l'upgrade del cluster utente al cluster Advanced
Aggiorna
Esegui la diagnostica del cluster per assicurarti che sia integro:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --cluster-name USER_CLUSTER_NAME- Se il comando segnala errori o avvisi, consulta Diagnostica i problemi del cluster e risolvili prima di procedere.
Se il control plane del cluster utente non è ad alta affidabilità (HA):
Modifica
masterNode.replicasda 1 a 3.Aggiungi gli indirizzi IP statici per i nodi del control plane del cluster utente alla sezione
network.controlPlaneIPBlock.ips.
Preparati per il cluster avanzato:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterSostituisci quanto segue:
BUNDLE_PATH: il percorso del file del bundle. Questo file si trova sulla tua workstation di amministrazione in/var/lib/gke/bundles/. Ad esempio:/var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgzADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.
Imposta
enableAdvancedClusternel file di configurazione del cluster utente sutrue.Aggiorna il cluster utente al cluster avanzato:
gkectl update cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIGSostituisci quanto segue:
ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.USER_CLUSTER_CONFIG: il percorso del file di configurazione del cluster utente.
Il comando eseguirà il rollout e ricreerà tutti i nodi nel cluster utente. Con la strategia di deployment di implementazione e ricreazione, i nodi vengono aggiornati uno alla volta. Durante l'aggiornamento del nodo, la VM viene eliminata e poi ricreata con la nuova configurazione.
Esegui l'upgrade
Esegui la diagnostica del cluster per assicurarti che sia integro:
gkectl diagnose cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --cluster-name USER_CLUSTER_NAME- Se il comando segnala errori o avvisi, consulta Diagnostica i problemi del cluster e risolvili prima di procedere.
Se il control plane del cluster utente non è ad alta affidabilità (HA):
Modifica
masterNode.replicasda 1 a 3.Aggiungi gli indirizzi IP statici per i nodi del control plane del cluster utente alla sezione
network.controlPlaneIPBlock.ips.
Preparati per il cluster avanzato:
gkectl prepare \ --bundle-path BUNDLE_PATH \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --advanced-clusterSostituisci quanto segue:
BUNDLE_PATH: il percorso del file del bundle. Questo file si trova sulla tua workstation di amministrazione in/var/lib/gke/bundles/. Ad esempio:/var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgzADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.
Imposta
enableAdvancedClusternel file di configurazione del cluster utente sutrue.Assicurati che il campo
gkeOnPremVersionnel file di configurazione del cluster utente corrisponda alla versione di destinazione dell'upgrade.Esegui l'upgrade del cluster utente al cluster avanzato:
gkectl upgrade cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIGSostituisci quanto segue:
ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.USER_CLUSTER_CONFIG: il percorso del file di configurazione del cluster utente.
Il comando ricreerà tutti i nodi nel cluster utente.
cert-manager in bundle con cluster avanzati
cert-manager è un componente obbligatorio gestito dal sistema nei cluster avanzati.
Se utilizzi cert-manager senza cluster avanzati, controlla quanto segue prima di eseguire l'upgrade ai cluster avanzati:
- Non sono presenti configurazioni personalizzate o flag di funzionalità nel tuo
cert-manager. - La tua versione di
cert-managerè la stessa o una versione precedente rispetto alla versione in bundle.
Compatibilità con Apigee hybrid
Il pacchetto cert-manager è completamente compatibile con i workload di Apigee Hybrid. Quando esegui l'upgrade a un cluster avanzato, il programma di installazione potrebbe avvisarti che l'installazione di cert-manager esistente verrà sostituita. Si tratta di un comportamento previsto che il sistema gestisce automaticamente.
Per garantire una transizione senza problemi per i tuoi workload Apigee:
- Non disinstallare manualmente l'istanza
cert-manageresistente prima dell'upgrade. - Ripristina le personalizzazioni: se gestisci
cert-managerutilizzando GitOps o hai applicato configurazioni personalizzate al deployment dicert-manager, devi ripristinare queste personalizzazioni o sospendere la sincronizzazione prima dell'upgrade per evitare deviazioni della configurazione e potenziali pause dell'upgrade.
Funzionalità e limitazioni
Con cert-manager in bundle puoi:
- Creare e modificare le risorse
IssuereClusterIssuer. - Creare e modificare risorse di certificati che fanno riferimento a emittenti e tipi di emittenti standard.
- Creare e modificare le risorse Kubernetes standard utilizzate da
cert-manager. - Crea secret Kubernetes contenenti chiavi API e fai riferimento a questi secret negli emittenti.
- Configura gli emittenti in modo che utilizzino resolver HTTP-01 o DNS-01 specifici.
Non puoi personalizzare i seguenti elementi nel bundle cert-manager:
- Imposta i valori
deploymentohelm. - Aggiungi argomenti o flag della riga di comando al file binario
cert-manager. - Modifica i limiti delle risorse o i selettori dei nodi per i pod
cert-manager. - Modifica la logica di installazione del software
cert-manager. - Attiva le funzionalità sperimentali.
- Forza l'esecuzione dei pod del control plane
cert-managersu nodi dell'infrastruttura specifici.
Se hai vincoli specifici che ti impediscono di utilizzare cert-manager in bundle, contatta l'assistenzaGoogle Cloud per ricevere aiuto con le opzioni di configurazione avanzate.
Versioni in bundle
La tabella seguente elenca le versioni di cert-manager in bundle per ogni versione di Google Distributed Cloud (solo software) per VMware.
| Google Distributed Cloud (solo software) per VMware | Versione cert-manager in bundle |
|---|---|
| 1,32 | 1,17 |
| 1,33 | 1,18 |
| 1,34 | 1,19 |