Vom Istio-Add-on zu Cloud Service Mesh migrieren

Diese Schritte gelten für Installationen, die festgestellt haben, dass das Ingress-Gateway von Istio on GKE in ihrem Cluster konfiguriert wurde. In diesem Prozess wird Cloud Service Mesh Version 1.18 mit der verwalteten Steuerungsebene installiert.

Hinweise

Übersicht

Im Allgemeinen umfasst der Prozess zur Migration vom „Istio-Add-on“ zu Cloud Service Mesh mit der verwalteten Steuerungsebene Folgendes:

  1. Von Cloud Service Mesh verwaltete Steuerungsebene installieren
  2. Mit dem Migrationsskript das Cloud Service Mesh-Ingress-Gateway konfigurieren

Zu Cloud Service Mesh Version 1.18 migrieren

Folgen Sie der detaillierten Anleitung im Cloud Service Mesh-Dokument "Von Istio on GKE zu Cloud Service Mesh migrieren". Nachdem Sie die Installation abgeschlossen und Ihre Arbeitslasten migriert haben, kehren Sie zu dieser Seite zurück, um die verbleibenden Konfigurationsschritte auszuführen.

  1. Verwenden Sie die „Anleitung zum Istio-Add-on-Migration“, um Ihre Installation mit der von Google verwalteten Steuerungsebene zu Cloud Service Mesh zu migrieren.

    Beachten Sie dabei die folgenden Punkte:

    • Wenn angezeigt wird, dass die custom envoy filters are not supported, wählen Sie einfach "Ja" aus, um die Migration fortzusetzen. Beispiel:

      Detected custom envoy filters are not supported by Cloud Service Mesh.
      Please remove these if possible
      NAMESPACE    NAME                                 AGE
      gke-system   allowconnect-cluster-local-gateway   26m
      Continue anyways? [y/N] Y
      
    • Die Migrationsanleitung enthält den Abschnitt Erfolgreiche Migration abschließen mit Schritten zum Abschließen der Cloud Service Mesh-Installation. Wichtig: Nachdem Sie diese Schritte ausgeführt haben, können Sie kein Rollback Ihrer Änderungen mehr ausführen.

    Anleitung zum Istio-Add-On-Migration: Migration von Istio on GKE zu Cloud Service Mesh

  2. Nachdem Sie die Migrationsschritte abgeschlossen und Ihre Arbeitslast zu Cloud Service Mesh migriert haben, führen Sie die folgenden Befehle aus, um Ihre Ingress-Pods im Namespace knative-serving neu zu starten und mit einem Label zu versehen:

    1. Starten Sie Ihre Ingress-Pods neu:

      kubectl rollout restart deployment autoscaler activator webhook -n knative-serving
      
    2. Fügen Sie das Label istio: ingressgateway hinzu:

      kubectl patch deployment ${INGRESS_NAME} --namespace ${INGRESS_NAMESPACE} --patch  '{"spec": {"template": {"metadata": {"labels": {"istio": "ingressgateway"}}}}}'
      

Eingehenden Cloud Service Mesh-Traffic konfigurieren

In diesem Abschnitt wird das Migrationsskript verwendet, um den Release-Kanal auf asm-managed-rapid für die von Cloud Service Mesh verwaltete Steuerungsebene festzulegen.

Starten Sie das Migrationsskript mit dem folgenden Befehl:

 ./migration-addon.sh \
 --asm-revision asm-managed-rapid \
 --command set-up-asm-ingress

Nächste Schritte

Flottenkomponente installieren

Rollback

Wenn Sie ein Rollback der oben vorgenommenen Änderungen durchführen müssen, können Sie:

  • Das Migrationsskript verwenden, um den Cloud Service Mesh-Ingress zu löschen.
  • Ein Rollback der Installation von Cloud Service Mesh durchführen.

So führen Sie ein Rollback der Installation und Konfiguration von Cloud Service Mesh mit der von Google verwalteten Steuerungsebene durch:

  1. Führen Sie den folgenden Befehl aus, um den Cloud Service Mesh-Ingress zu löschen:

    ./migration-addon.sh --command rollback-set-up-asm-ingress
    

    Die Terminalausgabe während des Prozesses sieht in etwa so aus:

    Deleting Cloud Service Mesh ingress
    deployment.apps "istio-ingressgateway" deleted
    horizontalpodautoscaler.autoscaling "istio-ingressgateway" deleted
    role.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted
    rolebinding.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted
    Cloud Service Mesh ingress is successfully deleted.
    
  2. Zum Verifizieren des Rollbacks prüfen Sie, ob der Dienst istio-ingressgateway nicht mehr im Namespace gke-system vorhanden ist:

    kubectl get deployment istio-ingressgateway -n gke-system
    
  3. Rollback der Cloud Service Mesh-Installation

  4. Führen Sie den folgenden Befehl aus, um das Istio-Add-on wieder zu aktivieren:

    ./migration-addon.sh --command rollback-uninstall-istio-addon
    
  5. Wenn Sie mit dem Rollback der Änderungen auf den ursprünglichen Zustand Ihrer Installation fortfahren möchten, führen Sie ein Rollback des Istio-Add-ons durch.