Questa pagina è stata tradotta dall'API Cloud Translation.

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.

Prerequisiti

Diagnostica sempre il cluster prima di eseguire l'aggiornamento o l'upgrade.
Assicurati che i tuoi cluster utilizzino solo funzionalità consigliate.
Verifica che i tuoi cluster non utilizzino funzionalità non supportate dai cluster avanzati prima di iniziare l'aggiornamento o l'upgrade. Se sono attive funzionalità non supportate, disabilitale innanzitutto utilizzando update.
- Sebbene i cluster utente ad alta disponibilità (HA) siano obbligatori per i 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 dei cluster utente.

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 pacchetto. 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.
Imposta enableAdvancedCluster nel file di configurazione del cluster di amministrazione su true.
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 ricrea tutti i nodi del cluster di amministrazione.

Esegui l'upgrade della workstation di amministrazione, se necessario.
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 pacchetto. 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.
Imposta enableAdvancedCluster nel file di configurazione del cluster di amministrazione su true.
Assicurati che il campo bundlepath nel 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_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 e ricreerà tutti i nodi del cluster di amministrazione.

Dopo aver aggiornato il cluster di amministrazione o aver eseguito l'upgrade a un cluster avanzato:

I cluster utente non avanzati esistenti continueranno 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.

Se il control plane del cluster utente non è ad alta disponibilità (HA):
1. Modifica masterNode.replicas da 1 a 3.
2. Aggiungi gli indirizzi IP statici per i nodi del piano di controllo del cluster utente alla sezione network.controlPlaneIPBlock.ips.
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 pacchetto. 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.
Imposta enableAdvancedCluster nel file di configurazione del cluster utente su true.
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 dell'utente.

Se il control plane del cluster utente non è ad alta disponibilità (HA):
1. Modifica masterNode.replicas da 1 a 3.
2. Aggiungi gli indirizzi IP statici per i nodi del piano di controllo del cluster utente alla sezione network.controlPlaneIPBlock.ips.
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 pacchetto. 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.
Imposta enableAdvancedCluster nel file di configurazione del cluster utente su true.
Assicurati che il campo gkeOnPremVersion nel 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_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 dell'utente.