Questi passaggi sono specifici per le installazioni di Istio su GKE, noto anche come "componente aggiuntivo Istio".
Prima di iniziare
Devi prima esaminare e assicurarti di soddisfare i requisiti per l'upgrade.
I comandi in questa pagina utilizzano le variabili di ambiente e lo script di migrazione del passaggio di preparazione dell'upgrade.
È importante eseguire ogni passaggio di questa procedura nell'ordine specificato.
Identificare se è in uso il modulo aggiuntivo Istio
Esistono due possibili percorsi per la migrazione, a seconda che nel cluster sia in uso il gateway in entrata o la funzionalità di inserimento di sidecar del componente aggiuntivo Istio.
In precedenza, nel passaggio di preparazione, hai già identificato se il componente aggiuntivo Istio è configurato. Puoi eseguire il seguente comando per verificare che lo spazio dei nomi
istio-system
esista:echo $INGRESS_NAMESPACE
Esegui questo comando per determinare se la funzionalità di inserimento di sidecar dell'componente aggiuntivo Istio è in uso nel tuo cluster:
kubectl get ns -l istio-injection=enabled
Se è elencato uno spazio dei nomi diverso da
knative-serving
, significa che è in uso l'inserimento di sidecar del componente aggiuntivo Istio.Ad esempio, se il comando elenca solo lo spazio dei nomi
knative-serving
, significa che non hai configurato e non utilizzi l'inserimento di sidecar del componente aggiuntivo Istio.
Risultati:
Uno o entrambi utilizzati: una o entrambe le funzionalità del componente aggiuntivo Istio sono in uso all'interno del cluster:
- Viene utilizzato il servizio di ingresso componente aggiuntivo Istio
istio-ingressgateway
. - Viene utilizzata l'iniezione di sidecar del componente aggiuntivo Istio.
Passaggi successivi: dopo aver seguito le istruzioni nella sezione successiva per disinstallare il componente aggiuntivo Istio, devi procedere alla guida Cloud Service Mesh con il piano di controllo gestito.
- Viene utilizzato il servizio di ingresso componente aggiuntivo Istio
Non utilizzato: né il gateway in entrata né l'inserimento di sidecar del componente aggiuntivo Istio sono configurati per l'utilizzo all'interno del cluster. In altre parole, l'installazione utilizza la "versione in bundle di Istio".
Passaggi successivi: dopo aver seguito le istruzioni nella sezione successiva per disinstallare il componente aggiuntivo Istio inutilizzato, puoi procedere alla guida Cloud Service Mesh con il control plane in-cluster.
Disinstallare il componente aggiuntivo Istio
In questa sezione, lo script di migrazione viene utilizzato per disinstallare il "componente aggiuntivo Istio".
Esegui questo comando per avviare lo script di migrazione:
./migration-addon.sh --command uninstall-istio-addon
Verifica che lo spazio dei nomi
istio-system
sia stato eliminato:kubectl get ns istio-system --ignore-not-found
Passaggi successivi
A seconda della configurazione del gateway in entrata che hai identificato sopra, continua con la guida all'installazione corrispondente:
Se hai identificato in precedenza che una o entrambe le funzionalità del "componente aggiuntivo Istio" sono state configurate e utilizzate all'interno del cluster, devi procedere alla guida Cloud Service Mesh con il control plane gestito.
Se in precedenza hai identificato che nel tuo cluster non sono stati utilizzati né il gateway in entrata né l'inserimento di sidecar del "componente aggiuntivo Istio", l'installazione ha effettivamente utilizzato la "versione in bundle di Istio". Ora puoi procedere all'installazione di Cloud Service Mesh con il control plane in-cluster.
Esegui il rollback
Se devi ripristinare le modifiche apportate seguendo i passaggi precedenti, puoi utilizzare lo script di migrazione per riattivare il "componente aggiuntivo Istio":
Esegui questo comando:
./migration-addon.sh --command rollback-uninstall-istio-addon
Per continuare a eseguire il rollback delle modifiche allo stato originale dell'installazione, esegui il rollback del "componente aggiuntivo GKE" di Knative serving.