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:
kubectlgetns-listio-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.
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".
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:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[],[],null,["# Uninstall the Istio add-on\n\nThese steps are specific to installations of the\n[Istio on GKE](/istio/docs/istio-on-gke/overview), also referred\nto as the \"*Istio add-on*\".\n| **Important:** If you installed the bundled version of Istio that is included by default with the \"*GKE add-on* \", you must instead follow the steps in [migrate the bundled Istio to Cloud Service Mesh](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/uninstall-istio-addon).\n\nBefore you begin\n----------------\n\n- You must first review and ensure that you meet the\n [requirements for upgrading](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade).\n\n- The commands on this page use the environment variables and migration script\n from the [upgrade preparation step](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/prepare).\n\n- It is important that you perform each step of this process in the\n [specified order](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade#upgrading).\n\nIdentify if the *Istio add-on* is in use\n----------------------------------------\n\nThere are two possible paths for migration depending on if either the ingress\ngateway or sidecar injection feature of the *Istio add-on* is in use within your\ncluster.\n\n1. Earlier in the [preparation step](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/prepare#istioaddon), you\n already identified if the *Istio add-on* is configured. You can run the\n following command to verify that the `istio-system` namespace exists:\n\n echo $INGRESS_NAMESPACE\n\n2. Run the following command to determine if the sidecar injection feature of\n the *Istio add-on* is in use within your cluster:\n\n kubectl get ns -l istio-injection=enabled\n\n If any namespace, other than `knative-serving` is listed, it indicates that\n sidecar injection of the *Istio add-on* is in use.\n\n For example, if the command only lists the `knative-serving` namespace, then\n you have not configured and do not use sidecar injection of the\n *Istio add-on*.\n\nResults:\n\n- **One or both used** - One or both of the *Istio add-on* features are in\n use within your cluster:\n\n - *Istio add-on* ingress service `istio-ingressgateway` is used.\n - *Istio add-on* sidecar injection is used.\n\n Next steps: After you follow the instruction in the next section to\n [uninstall the *Istio add-on*](#uninstall), you must proceed to the\n [Cloud Service Mesh with the managed control plane](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/install-mesh-mcp)\n guide.\n- **Not used** - Neither the ingress gateway nor the sidecar injection of the\n *Istio add-on* are configure for use within your cluster. In other words,\n your installation uses the \"bundled version of Istio\".\n\n Next steps: After you follow the instruction in the next section to\n [uninstall the unused *Istio add-on*](#uninstall), you can proceed to the\n [Cloud Service Mesh with the in-cluster control plane](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/install-configure-mesh)\n guide.\n\nUninstall the Istio add-on\n--------------------------\n\nIn this section, the [migration script](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/prepare) is used to\nuninstall the \"*Istio add-on*\".\n\n1. Run the following command to start the migration script:\n\n ./migration-addon.sh --command uninstall-istio-addon\n\n2. Verify that the `istio-system` namespace has been deleted:\n\n kubectl get ns istio-system --ignore-not-found\n\nWhat's next\n-----------\n\nDepending on the ingress gateway configuration that you identified above,\ncontinue to the corresponding installation guide:\n\n- If you [identified earlier](#iduse) that one or both of the \"*Istio add-on* \"\n features were configured and used within your cluster, you must proceed to the\n [Cloud Service Mesh with the managed control plane](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/install-mesh-mcp)\n guide.\n\n- If you [identified earlier](#iduse) that neither the ingress gateway nor the\n sidecar injection of the \"Istio add-on\" were used in your cluster, then\n your installation actually used the \"bundled version of Istio\". You can now\n proceed to install\n [Cloud Service Mesh with the in-cluster control plane](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/install-configure-mesh).\n\nRollback\n--------\n\nIf you need to rollback the changes that you made through the steps above, you\ncan use the migration script to re-enable the \"*Istio add-on*\":\n\n1. Run the following command:\n\n ./migration-addon.sh --command rollback-uninstall-istio-addon\n\n2. To continue rolling back your changes to your installation's original state,\n [rollback the Knative serving \"GKE add-on\"](/kubernetes-engine/enterprise/knative-serving/docs/install/on-gcp/upgrade/uninstall-addon#rollbackgkeaddon)."]]
