Aggiornare o eseguire l'upgrade di un cluster a un cluster avanzato

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: NodeExternalIP non è impostato sui nodi.

  • Installazione di cert-manager: cert-manager viene installato automaticamente sui cluster avanzati. Se hai installato cert-manager nel 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 gkectl deve essere la stessa della versione del cluster di destinazione.

    • Se necessario, consulta Scarica gkectl per ottenere una versione supportata di gkectl.
  • Diagnostica sempre il cluster prima di eseguire l'aggiornamento o l'upgrade a un cluster Advanced:

    • Esegui gkectl diagnose cluster sui 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.
  • 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-manager viene installato automaticamente sui cluster avanzati. Quando esegui la migrazione da un cluster non avanzato a un cluster avanzato, cert-manager integrato sostituisce automaticamente qualsiasi versione di cert-manager installata dal cliente. Assicurati di non avere configurazioni o funzionalità personalizzate critiche applicate al tuo cert-manager esistente prima di eseguire l'aggiornamento o l'upgrade ai cluster avanzati.

Aggiorna o esegui l'upgrade del cluster di amministrazione al cluster Advanced

Aggiorna

  1. Esegui la diagnostica del cluster per assicurarti che sia integro:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    
  2. Preparati per il cluster avanzato:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Sostituisci 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.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  3. Imposta enableAdvancedCluster nel file di configurazione del cluster di amministrazione su true.

  4. Aggiorna il cluster di amministrazione al cluster avanzato:

    gkectl update admin \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config ADMIN_CLUSTER_CONFIG
    

    Sostituisci 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

  1. Esegui l'upgrade della workstation di amministrazione, se necessario.

  2. Esegui la diagnostica del cluster per assicurarti che sia integro:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    
  3. Preparati per il cluster avanzato:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Sostituisci 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.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  4. Imposta enableAdvancedCluster nel file di configurazione del cluster di amministrazione su true.

  5. Assicurati che il campo bundlepath nel file di configurazione del cluster di amministrazione corrisponda al percorso del bundle di cui vuoi eseguire l'upgrade.

  6. Esegui l'upgrade del cluster di amministrazione al cluster avanzato:

    gkectl upgrade admin \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config ADMIN_CLUSTER_CONFIG
    

    Sostituisci 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

  1. Esegui la diagnostica del cluster per assicurarti che sia integro:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --cluster-name USER_CLUSTER_NAME
    
  2. Se il control plane del cluster utente non è ad alta affidabilità (HA):

    1. Modifica masterNode.replicas da 1 a 3.

    2. Aggiungi gli indirizzi IP statici per i nodi del control plane del cluster utente alla sezione network.controlPlaneIPBlock.ips.

  3. Preparati per il cluster avanzato:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Sostituisci 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.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  4. Imposta enableAdvancedCluster nel file di configurazione del cluster utente su true.

  5. Aggiorna il cluster utente al cluster avanzato:

    gkectl update cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config USER_CLUSTER_CONFIG
    

    Sostituisci 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

  1. Esegui la diagnostica del cluster per assicurarti che sia integro:

    gkectl diagnose cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --cluster-name USER_CLUSTER_NAME
    
  2. Se il control plane del cluster utente non è ad alta affidabilità (HA):

    1. Modifica masterNode.replicas da 1 a 3.

    2. Aggiungi gli indirizzi IP statici per i nodi del control plane del cluster utente alla sezione network.controlPlaneIPBlock.ips.

  3. Preparati per il cluster avanzato:

    gkectl prepare \
        --bundle-path BUNDLE_PATH \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --advanced-cluster
    

    Sostituisci 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.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: il percorso del file kubeconfig del cluster di amministrazione.

  4. Imposta enableAdvancedCluster nel file di configurazione del cluster utente su true.

  5. Assicurati che il campo gkeOnPremVersion nel file di configurazione del cluster utente corrisponda alla versione di destinazione dell'upgrade.

  6. Esegui l'upgrade del cluster utente al cluster avanzato:

    gkectl upgrade cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config USER_CLUSTER_CONFIG
    

    Sostituisci 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-manager esistente prima dell'upgrade.
  • Ripristina le personalizzazioni: se gestisci cert-manager utilizzando GitOps o hai applicato configurazioni personalizzate al deployment di cert-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 Issuer e ClusterIssuer.
  • 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 deployment o helm.
  • 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-manager su 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