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 nell'ordine specificato.
Verificare se il componente aggiuntivo Istio è in uso
Esistono due possibili percorsi di migrazione, a seconda che all'interno del cluster sia in uso la funzionalità gateway in entrata o di inserimento tramite sidecar del componente aggiuntivo Istio.
In precedenza, nel passaggio di preparazione, hai già identificato se è configurato il componente aggiuntivo Istio. Puoi eseguire questo 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 file collaterali del componente aggiuntivo Istio è in uso nel 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
, significa che non hai eseguito la configurazione e non utilizzi l'inserimento collaterale del componente aggiuntivo Istio.
Risultati:
Utilizzate una o entrambe: una o entrambe le funzionalità del componente aggiuntivo Istio sono in uso nel cluster:
- Viene utilizzato il servizio in entrata componente aggiuntivo di Istio
istio-ingressgateway
. - Si utilizza l'iniezione di file collaterali del componente aggiuntivo Istio.
Passaggi successivi: dopo aver seguito le istruzioni nella sezione successiva per disinstallare il componente aggiuntivo Istio, devi consultare la guida di Cloud Service Mesh con il piano di controllo gestito.
- Viene utilizzato il servizio in entrata componente aggiuntivo di Istio
Non utilizzato: né il gateway in entrata né l'inserimento collaterale del componente aggiuntivo Istio non sono configurati per l'utilizzo nel 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 di Cloud Service Mesh con il piano di controllo nel cluster.
Disinstalla il componente aggiuntivo Istio
In questa sezione, lo script per la 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 sopra, passa alla guida all'installazione corrispondente:
Se in precedenza hai identificato in precedenza che una o entrambe le funzionalità del "componente aggiuntivo Istio" sono state configurate e utilizzate all'interno del cluster, devi passare alla guida di Cloud Service Mesh con il piano di controllo gestito.
Se in precedenza hai identificato che nel cluster non sono stati utilizzati né il gateway in entrata né l'inserimento collaterale del "componente aggiuntivo Istio", allora la tua installazione ha utilizzato in realtà la "versione in bundle di Istio". Ora puoi procedere con l'installazione di Cloud 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 Knative serving.