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

Questo documento mostra come aggiornare o eseguire l'upgrade di un cluster a un cluster avanzato dalla versione 1.32.

Importante: i cluster non avanzati verranno aggiornati automaticamente a cluster avanzati nella versione 1.33.

Prerequisiti

• La versione di gkectl deve corrispondere a quella del cluster di destinazione.

  • Se necessario, consulta Scaricare gkectl per ottenere una versione supportata di gkectl.

• Esegui sempre la diagnostica del cluster prima di eseguire l'aggiornamento.

• 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 update.

  • Sebbene i cluster utente ad alta disponibilità (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.

• Prima di aggiornare o eseguire l'upgrade di qualsiasi cluster utente, devi aggiornare o eseguire l'upgrade del cluster di amministrazione a un cluster avanzato.

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

Aggiorna

Importante :assicurati che la versione del cluster sia almeno 1.32.0.

1. 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 bundle. Questo file si trova nella 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.

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

3. 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

Attenzione: se il tuo cluster utilizza cos o cos_cgv2 come tipo di immagine del sistema operativo del control plane o tipo di immagine del sistema operativo del node pool, assicurati che la versione del cluster sia almeno 1.32.0 prima di eseguire l'upgrade. In caso contrario, assicurati che la versione del cluster sia almeno 1.31.100.

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

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 bundle. Questo file si trova nella 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. Assicurati che il campo bundlepath nel file di configurazione del cluster di amministrazione corrisponda al percorso del bundle a cui vuoi eseguire l'upgrade.

5. 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 eseguirà il rollout della ricreazione di tutti i nodi nel cluster di amministrazione. Con la strategia di deployment di ricreazione dell'implementazione, i nodi vengono aggiornati 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.

Ti consigliamo di eseguire l'upgrade di tutti i cluster di utenti a cluster avanzati subito dopo per mantenere un ambiente coerente e completo.

Aggiornare o eseguire l'upgrade del cluster utente al cluster avanzato

Importante: assicurati che il cluster amministrativo sia già stato aggiornato o di cui sia stato eseguito l'upgrade al cluster avanzato.

Aggiorna

Importante :assicurati che la versione del cluster sia almeno 1.32.0.

1. Se il control plane del cluster utente non è ad alta disponibilità:

   Attenzione: a causa di un problema noto con il campo masterNode.replicas, per aggiornare un cluster utente non HA versione 1.32 o 1.33 a un cluster avanzato HA, il cluster deve avere una versione superiore alla 1.32.600 o alla 1.33.100, rispettivamente.

   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.

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 bundle. Questo file si trova nella 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 utente su true.

4. 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 della ricreazione di tutti i nodi nel cluster utente. Con la strategia di deployment di ricreazione dell'implementazione, 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

Attenzione: se il tuo cluster utilizza cos o cos_cgv2 come tipo di immagine del sistema operativo del control plane o tipo di immagine del sistema operativo del node pool, assicurati che la versione del cluster sia almeno 1.32.0 prima di eseguire l'upgrade. In caso contrario, assicurati che la versione del cluster sia almeno 1.31.100.

1. Se il control plane del cluster utente non è ad alta disponibilità:

   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.

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 bundle. Questo file si trova nella 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 utente su true.

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

5. 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 ricrea tutti i nodi nel cluster utente.

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à della risorsa: 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 cluster, l'aggiornamento o l'upgrade al cluster avanzato lo sovrascrive con la versione del cluster avanzato.

Per una panoramica completa delle differenze tra le funzionalità, consulta la tabella di confronto delle funzionalità.