Questi passaggi sono specifici per le installazioni di Istio su GKE, noto anche come "componente aggiuntivo Istio".
Prima di iniziare
Devi prima rivedere 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.
Identifica se il modulo aggiuntivo Istio è in uso
Esistono due possibili percorsi per la migrazione, a seconda che nel cluster sia in uso la funzionalità di gateway di ingresso o di inserimento di sidecar del componente aggiuntivo Istio.
In precedenza, nel passaggio di preparazione, hai già identificato se il plug-in Istio è configurato. Puoi eseguire il seguente comando per verificare che lo spazio dei nomi
istio-system
esista:echo $INGRESS_NAMESPACE
Esegui il seguente comando per determinare se la funzionalità di inserimento di sidecar del 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'iniezione 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'iniezione sidecar del componente aggiuntivo Istio.
Risultati:
Uno o entrambi utilizzati: una o entrambe le funzionalità del componente aggiuntivo Istio sono in uso nel tuo cluster:
- Viene utilizzato il servizio di ingresso
istio-ingressgateway
del componente aggiuntivo Istio. - 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 passare alla guida su Cloud Service Mesh con il piano di controllo gestito.
- Viene utilizzato il servizio di ingresso
Non utilizzato: né il gateway di ingresso né l'iniezione sidecar del componente aggiuntivo Istio sono configurati per l'utilizzo all'interno del cluster. In altre parole, la tua installazione utilizza la "versione di Istio in bundle".
Passaggi successivi: dopo aver seguito le istruzioni nella sezione successiva per disinstallare il componente aggiuntivo Istio inutilizzato, puoi procedere con la guida Cloud Service Mesh con il piano di controllo in-cluster.
Disinstalla il componente aggiuntivo Istio
In questa sezione, lo script di migrazione viene utilizzato per disinstallare il "componente aggiuntivo Istio".
Esegui il comando seguente 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 di ingresso identificata sopra, passa alla guida all'installazione corrispondente:
Se hai identificato in precedenza che una o entrambe le funzionalità "Componente aggiuntivo Istio" sono state configurate e utilizzate all'interno del tuo cluster, devi procedere con la guida Cloud Service Mesh con il control plane gestito.
Se hai identificato in precedenza che né il gateway di ingresso né l'iniezione di sidecar del "componente aggiuntivo Istio" sono stati utilizzati nel tuo cluster, la tua installazione ha effettivamente utilizzato la "versione in bundle di Istio". Ora puoi procedere con l'installazione di Cloud Service Mesh con il piano di controllo interno al 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" Knative serving.