Diese Schritte gelten speziell für die Installation von Istio on GKE, das auch als Istio-Add-on bezeichnet wird.
Hinweise
Sie müssen zuerst prüfen, ob die Anforderungen für das Upgrade erfüllt sind.
In den Befehlen auf dieser Seite werden die Umgebungsvariablen und das Migrationsskript aus dem Vorbereitungsschritt für das Upgrade verwendet.
Es ist wichtig, dass Sie jeden Schritt dieses Prozesses in der angegebenen Reihenfolge ausführen.
Prüfen, ob das Istio-Add-on verwendet wird
Es gibt zwei mögliche Pfade für die Migration, je nachdem, ob das Ingress-Gateway oder das Sidecar-Injektionsfeature des Istio-Add-ons in Ihrem Cluster verwendet wird.
Sie haben bereits im Vorbereitungsschritt festgestellt, ob das Istio-Add-on konfiguriert ist. Sie können den folgenden Befehl ausführen, um zu prüfen, ob der Namespace
istio-system
vorhanden ist:echo $INGRESS_NAMESPACE
Führen Sie den folgenden Befehl aus, um festzustellen, ob das Sidecar-Injektionsfeature des Istio-Add-ons in Ihrem Cluster verwendet wird:
kubectl get ns -l istio-injection=enabled
Wenn ein anderer Namespace als
knative-serving
aufgeführt ist, bedeutet dies, dass die Sidecar-Injektion des Istio-Add-ons verwendet wird.Wenn der Befehl beispielsweise nur den Namespace
knative-serving
auflistet, ist die Sidecar-Injektion des Istio-Add-ons nicht konfiguriert und wird nicht verwendet.
Ergebnisse:
Ein oder beide Features verwendet – Ein oder beide Istio-Add-on-Features werden in Ihrem Cluster verwendet:
- Istio-Add-on-Ingress-Dienst
istio-ingressgateway
wird verwendet. - Istio-Add-on-Sidecar-Injektion wird verwendet.
Nächste Schritte: Nachdem Sie der Anleitung im nächsten Abschnitt gefolgt sind, deinstallieren Sie das Istio-Add-on. Fahren Sie dazu mit dem Leitfaden Cloud Service Mesh mit verwalteter Steuerungsebene fort.
- Istio-Add-on-Ingress-Dienst
Nicht verwendet – Weder das Ingress-Gateway noch die Sidecar-Injektion des Istio-Add-ons sind für die Verwendung in Ihrem Cluster konfiguriert. Mit anderen Worten: Ihre Installation verwendet die "gebündelte Version von Istio".
Nächste Schritte: Nachdem Sie der Anleitung im nächsten Abschnitt gefolgt sind, deinstallieren Sie das nicht verwendete Istio-Add-on. Fahren Sie dazu mit dem Leitfaden Cloud Service Mesh mit der clusterinternen Steuerungsebene fort.
Istio-Add-on deinstallieren
In diesem Abschnitt wird das Migrationsskript verwendet, um das Istio-Add-on zu deinstallieren.
Starten Sie das Migrationsskript mit dem folgenden Befehl:
./migration-addon.sh --command uninstall-istio-addon
Prüfen Sie, ob der Namespace
istio-system
gelöscht wurde:kubectl get ns istio-system --ignore-not-found
Nächste Schritte
Fahren Sie je nach der oben ermittelten Konfiguration des Ingress-Gateways mit der entsprechenden Installationsanleitung fort:
Wenn Sie zuvor festgestellt haben, dass ein oder beide Istio-Add-on-Features in Ihrem Cluster konfiguriert waren und verwendet wurden, müssen Sie mit der Anleitung Cloud Service Mesh mit verwalteter Steuerungsebene fortfahren.
Wenn Sie zuvor festgestellt haben, dass weder das Ingress-Gateway noch die Sidecar-Injektion des Istio-Add-ons in Ihrem Cluster verwendet wurden, hat Ihre Installation die "gebündelte Version von Istio" verwendet. Sie können jetzt mit der Installation von Cloud Service Mesh mit der clusterinternen Steuerungsebene fortfahren.
Rollback
Wenn Sie ein Rollback der oben beschriebenen Schritte durchführen müssen, können Sie das Istio-Add-on mit dem Migrationsskript wieder aktivieren:
Führen Sie dazu diesen Befehl aus:
./migration-addon.sh --command rollback-uninstall-istio-addon
Wenn Sie die Änderungen der ursprünglichen Installation weiterhin rückgängig machen möchten, führen Sie ein Rollback des Knative Serving-GKE-Add-ons durch.