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 il componente aggiuntivo Istio è in uso
Esistono due possibili percorsi per la migrazione, a seconda che la funzionalità gateway in entrata o di inserimento sidecar del componente aggiuntivo Istio sia in uso nel cluster.
In precedenza, nel passaggio di preparazione, avevi già identificato se è stato configurato il componente aggiuntivo Istio. Puoi eseguire il comando seguente per verificare che lo spazio dei nomi
istio-system
esista:echo $INGRESS_NAMESPACE
Esegui questo comando per determinare se la funzionalità di inserimento sidecar del componente aggiuntivo Istio è in uso all'interno del cluster:
kubectl get ns -l istio-injection=enabled
L'eventuale presenza di uno spazio dei nomi diverso da
knative-serving
indica che è in uso l'inserimento collaterale del componente aggiuntivo Istio.Ad esempio, se il comando elenca solo lo spazio dei nomi
knative-serving
, non hai configurato e non utilizzi l'inserimento sidecar del componente aggiuntivo Istio.
Risultati:
Una o entrambe utilizzate: una o entrambe le funzionalità del componente aggiuntivo Istio sono in uso nel cluster:
- Viene utilizzato il servizio in entrata
istio-ingressgateway
del componente aggiuntivo Istio. - Viene utilizzato l'iniezione del componente aggiuntivo Istio collaterale.
Passaggi successivi: dopo aver seguito le istruzioni nella sezione successiva per disinstallare il componente aggiuntivo Istio, devi passare alla guida Anthos Service Mesh con il piano di controllo gestito.
- Viene utilizzato il servizio in entrata
Non utilizzato: né il gateway in entrata né l'inserimento 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 passare alla guida Anthos Service Mesh con il piano di controllo nel cluster.
Disinstalla 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 identificata in precedenza, vai alla 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 tuo cluster, devi passare alla guida Anthos Service Mesh con il piano di controllo gestito.
Se in precedenza hai identificato che né il gateway in entrata né l'inserimento collaterale del "componente aggiuntivo Istio" nel cluster, la tua installazione ha effettivamente utilizzato la "versione in bundle di Istio". Ora puoi procedere con l'installazione Anthos Service Mesh con il piano di controllo nel cluster.
Esegui il rollback
Se devi eseguire il rollback delle modifiche apportate tramite 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 Cloud Run for Anthos.