Cloud Service Mesh deinstallieren

Hinweis: Dieser Leitfaden unterstützt nur Cloud Service Mesh mit Istio APIs und keine Google Cloud APIs. Weitere Informationen finden Sie unter Cloud Service Mesh – Übersicht

Auf dieser Seite wird erläutert, wie Sie Cloud Service Mesh deinstallieren, wenn Sie die Istio APIs verwenden. Wenn Sie Compute Engine APIs verwenden, sind keine Maßnahmen erforderlich. Siehe Cloud Service Mesh – Übersicht um die Unterschiede zu verstehen.

Warnung: Wenn Sie dieser Anleitung zum Deinstallieren von Cloud Service Mesh folgen, werden alle Konfigurationen unabhängig vom Typ der Steuerungsebene (clusterintern oder verwaltet) entfernt.

Cloud Service Mesh deinstallieren

Deinstallieren Sie mit den folgenden Befehlen alle Cloud Service Mesh-Komponenten. Mit diesen Befehlen werden auch der istio-system-Namespace und alle benutzerdefinierten Ressourcendefinitionen (Custom Resource Definitions, CRDs) gelöscht, einschließlich aller von Ihnen angewendeten CRDs.

Warnung: Wenn Sie CRDs erstellt haben, benötigen Sie Kopien davon, bevor Sie fortfahren. führen Sie die folgenden Schritte aus.

1. So verhindern Sie eine Unterbrechung des Anwendungstraffics:

   • Führen Sie ein Downgrade aller STRICT mTLS-Richtlinien auf PERMISSIVE aus.
   • Entfernen Sie alle AuthorizationPolicy, die den Traffic blockieren können.

2. Deaktivieren Sie die automatische Verwaltung für diesen Cluster, unabhängig davon, ob Sie sie direkt oder über die Standardkonfiguration der Flotte angewendet haben:

     gcloud container fleet mesh update \
        --management manual \
        --memberships MEMBERSHIP_NAME \
        --project FLEET_PROJECT_ID \
        --location MEMBERSHIP_LOCATION
   

   Ersetzen Sie Folgendes:

   • MEMBERSHIP_NAME ist der Name der Mitgliedschaft, der aufgeführt wird, wenn Sie hat bestätigt, dass Ihr Cluster bei der Flotte registriert wurde.
   • MEMBERSHIP_LOCATION ist der Standort deiner Mitgliedschaft (entweder eine Region oder global).

3. Deaktivieren Sie die automatische Sidecar-Einfügung für Ihre Namespaces, sofern sie aktiviert ist. Führen Sie den folgenden Befehl aus, um Namespace-Labels aufzurufen:

    kubectl get namespace YOUR_NAMESPACE --show-labels
   

   Die Ausgabe sieht in etwa so aus:

    NAME   STATUS   AGE     LABELS
    demo   Active   4d17h   istio.io/rev=asm-181-5

   Wenn in der Ausgabe unter der Spalte LABELS istio.io/rev= angezeigt wird, entfernen Sie dies:

    kubectl label namespace YOUR_NAMESPACE istio.io/rev-
   

   Wenn in der Ausgabe unter der Spalte LABELS istio-injection angezeigt wird, entfernen Sie dies:

    kubectl label namespace YOUR_NAMESPACE istio-injection-
   

   Wenn Sie weder die Labels istio.io/rev noch istio-injection sehen, wurde die automatische Einfügung im Namespace nicht aktiviert.

4. Starten Sie Ihre Arbeitslasten mit eingefügten Sidecar-Dateien neu, um die Proxys zu entfernen.

5. Wenn Sie ein verwaltetes Cloud Service Mesh verwenden, prüfen Sie, Implementierung der Steuerungsebene in Ihrem Cluster haben, hilft dies dabei, relevante Ressourcen in weiteren Schritte.

6. Wenn Sie ein verwaltetes Cloud Service Mesh verwenden, entfernen Sie alle controlplanerevision-Ressourcen im Cluster:

   kubectl delete controlplanerevision asm-managed asm-managed-rapid asm-managed-stable -n istio-system --ignore-not-found=true
   

7. Löschen Sie Webhooks aus Ihrem Cluster, sofern vorhanden.

   Cloud Service Mesh im Cluster

   validatingwebhooksconfiguration und mutatingwebhookconfiguration löschen.

   kubectl delete validatingwebhookconfiguration,mutatingwebhookconfiguration -l operator.istio.io/component=Pilot
   

   Verwaltetes Cloud Service Mesh

   A. Löschen Sie die validatingwebhooksconfiguration:

   kubectl delete validatingwebhookconfiguration istiod-istio-system-mcp
   

   B. Löschen Sie alle mutatingwebhookconfiguration.

   Hinweis: Verwenden Sie RELEASE_CHANNEL gemäß der von Ihnen bereitgestellten Release-Version. Beispiel: Normal (istiod-asm-managed), schnell (istiod-asm-managed-rapid) und stabil (istiod-asm-managed-stable).

   kubectl delete mutatingwebhookconfiguration istiod-RELEASE_CHANNEL
   

8. Sobald alle Arbeitslasten gestartet und keine Proxys beobachtet wurden, können Sie die Steuerungsebene im Cluster sicher löschen, um die Abrechnung zu beenden.

   Führen Sie den folgenden Befehl aus, um die clusterinterne Steuerungsebene zu entfernen:

   istioctl uninstall --purge
   

   Wenn keine anderen Steuerungsebenen vorhanden sind, können Sie die istio-system löschen. Namespace, um alle Cloud Service Mesh-Ressourcen zu entfernen. Andernfalls löschen Sie die den Cloud Service Mesh-Versionen entsprechen. Dadurch werden freigegebene Ressourcen wie CRDs nicht gelöscht.

9. Löschen Sie die Namespaces istio-system und asm-system:

    kubectl delete namespace istio-system asm-system --ignore-not-found=true
   

10. Prüfen Sie, ob die Löschvorgänge erfolgreich waren:

     kubectl get ns
    

    Die Ausgabe sollte den Status Terminating anzeigen und wie angegeben zurückgegeben werden. Andernfalls müssen Sie möglicherweise alle verbleibenden Ressourcen im Namespace manuell löschen und es noch einmal versuchen.

     NAME                 STATUS       AGE
     istio-system         Terminating  71m
     asm-system           Terminating  71m
    

11. Wenn Sie Ihre Cluster löschen möchten oder sie bereits gelöscht haben, achten Sie darauf, dass jeder Cluster nicht für Ihre Flotte registriert sind.

12. Wenn Sie die Standardkonfiguration für verwaltetes Cloud Service Mesh für Ihre gesamte Flotte aktiviert haben und sie für zukünftige Cluster deaktivieren möchten, deaktivieren Sie sie. Du kannst diesen Schritt überspringen wenn Sie die Deinstallation nur von einem einzelnen Cluster aus durchführen.

     gcloud container hub mesh disable --fleet-default-member-config --project FLEET_PROJECT_ID
    

    Dabei ist FLEET_PROJECT_ID die ID Ihres Flotten-Hostprojekts.

13. Wenn Sie das verwaltete Cloud Service Mesh aktiviert haben, prüfen und löschen Sie verwaltete Ressourcen, sofern vorhanden:

    Hinweis: Wenn Ihr Cluster ein Autopilot-Cluster ist, können Sie keine Ressourcen aus dem kube-system-Namespace löschen. Wenn Sie das verwaltete Cloud Service Mesh deinstallieren und Ihren Cluster behalten möchten, wenden Sie sich an den Support, damit diese Ressourcen gelöscht werden.

    1. Löschen Sie das Deployment mdp-controller:

         kubectl delete deployment mdp-controller -n kube-system
       

    2. Wenn Sie die Implementierung der Steuerungsebene TRAFFIC_DIRECTOR haben, bereinigen Sie transparente Systemdiagnose-Ressourcen. Normalerweise werden diese automatisch entfernt. Sie können aber dafür sorgen, dass sie gelöscht werden:

       1. Löschen Sie das snk-Daemonset.

             kubectl delete daemonset snk -n kube-system
          

       2. Löschen Sie die Firewallregel.

             gcloud compute firewall-rules delete gke-csm-thc-FIRST_8_CHARS_OF_CLUSTER_ID
          

          Ersetzen Sie Folgendes:

          • FIRST_8_CHARS_OF_CLUSTER_ID sind die ersten 8 Zeichen des Cluster-ID für Ihren spezifischen Cluster.

    3. Prüfen Sie, ob die Configmap istio-cni-plugin-config vorhanden ist:

         kubectl get configmap istio-cni-plugin-config -n kube-system
       

       Löschen Sie gegebenenfalls die istio-cni-plugin-config-ConfigMap:

         kubectl delete configmap istio-cni-plugin-config -n kube-system
       

       Warnung: Wenn Sie diese ConfigMap nicht löschen, wird die Netzwerkzuverlässigkeit Ihres GKE-Cluster möglicherweise beeinträchtigt.

    4. Löschen Sie das Daemonset istio-cni-node:

         kubectl delete daemonset istio-cni-node -n kube-system
       

14. Wenn Sie das verwaltete Cloud Service Mesh deinstallieren, wenden Sie sich an den Support, um sicherzustellen, Google Cloud-Ressourcen werden bereinigt. Namespace und Konfiguration istio-system Karten werden möglicherweise auch weiterhin neu erstellt, wenn Sie diesen Schritt nicht befolgen.

Nach Abschluss dieser Schritte werden alle Cloud Service Mesh-Komponenten, einschließlich Proxys, In-Cluster-Zertifizierungsstellen sowie RBAC-Rollen und ‑Bindungen, systematisch aus dem Cluster entfernt. Während der Installation erhält ein Google-Dienstkonto die erforderlichen Berechtigungen zum Erstellen der Service Mesh-Ressourcen im Cluster. Diese Berechtigungen werden durch diese Deinstallationsanleitung nicht widerrufen, sodass Cloud Service Mesh in Zukunft nahtlos reaktiviert werden kann.