Von Istio 1.11 oder höher zu Google Service Mesh migrieren

In dieser Anleitung wird beschrieben, wie Sie eine Anwendung von einem GKE-Cluster (Google Kubernetes Engine) mit Istio zu einem neuen Cluster mit verwaltetem Cloud Service Mesh migrieren, dem vollständig verwalteten Istio-kompatiblen Service Mesh von Google.

In dieser Anleitung erwartet Sie Folgendes:

1. Sie erstellen einen neuen Google Kubernetes Engine-Cluster und installieren Istio und das Istio-Ingress-Gateway auf dem Cluster. Dieser Cluster fungiert als vorhandener Cluster, von dem Sie migrieren möchten.
2. Sie stellen die Beispielanwendung Online Boutique mit Istio auf dem Cluster bereit.
3. Sie erstellen im selben Google Cloud Projekt einen weiteren Google Kubernetes Engine-Cluster.
4. Sie aktivieren verwaltetes Cloud Service Mesh im zweiten Cluster und stellen das Cloud Service Mesh-Ingress-Gateway bereit.
5. Sie stellen Online Boutique mit Cloud Service Mesh auf dem Cluster bereit, um die Bereitstellung mit Istio aus dem Cluster zu replizieren.
6. Sie verschieben 50% des Nutzertraffics vom Cluster mit Istio auf den Cluster mit Cloud Service Mesh. Dazu werden die Aufteilungsfunktionen der Zugriffe von Istio auf dem Cluster mit Istio genutzt.
7. Sie schließen die Migration von Istio zu Cloud Service Mesh ab. Dazu verweisen Sie den DNS-Eintrag (Domain Name System) des Clusters mit Istio auf den Cluster mit Cloud Service Mesh.

Canary-Deployment

„Canary-Deployment“ ist eine Technik, die in der Softwareentwicklung verwendet wird, um eine neue Version einer Software zu testen, bevor diese für alle Nutzer veröffentlicht wird. Dabei wird der Prozentsatz des Traffics, der an die neue Version weitergeleitet wird, schrittweise erhöht. In dieser Anleitung richten Sie einen neuen Cluster mit verwaltetem Cloud Service Mesh ein und verschieben den Nutzertraffic schrittweise in diesen Cluster. Sie leiten zuerst 0% des Nutzertraffics an den neuen Cluster, dann 50 % und schließlich 100%. In der Produktion sollten Sie kleinere und mehr Schritte verwenden. Wenn Sie feststellen, dass der neue Cluster einen Prozentsatz des Traffics nicht verarbeiten kann, können Sie ein Rollback durchführen. Reduzieren Sie dazu den Prozentsatz auf 0%.

Canary-Steuerungsebene im Vergleich zu Canary-Cluster

Es gibt zwei häufig verwendete Strategien für Migrationen von Istio zu verwaltetem Cloud Service Mesh:

• Canary-Clustermigration: Bei dieser Strategie erstellen Sie einen neuen Cluster und stellen dann verwaltetes Cloud Service Mesh darauf bereit.
• Migration der Canary-Steuerungsebene: Bei dieser Strategie stellen Sie verwaltetes Cloud Service Mesh auf demselben Cluster bereit, auf dem Istio installiert ist. Dies ist kein unterstützter Migrationspfad mit Cloud Service Mesh.

In dieser Anleitung werden Sie die Migrationsstrategie für den Canary-Cluster durchlaufen.

Kosten

In dieser Anleitung werden die folgenden kostenpflichtigen Komponenten von Google Cloudverwendet:

• Google Kubernetes Engine
• Cloud Service Mesh

Nach Abschluss dieser Anleitung können Sie weitere Kosten durch Löschen von erstellten Ressourcen vermeiden. Weitere Informationen finden Sie unter Bereinigen.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistung unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the required APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the required APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Cloud Shell starten

In dieser Anleitung verwenden Sie Cloud Shell, eine in gehostete Shell Umgebung, mit der Sie Ihre Google Cloud Ressourcen verwalten können. Google Cloud

Cloud Shell wird mit den Befehlszeilentools, Google Cloud CLI, kubectlund istioctl vorinstalliert. Die gcloud CLI stellt die primäre Befehlszeile für Google Cloudbereit.

Öffnen Sie in der rechten oberen Ecke dieser Seite eine Cloud Shell-Sitzung, klicken Sie auf und dann auf Bestätigen. In einem Frame im unteren Teil der Seite wird eine Cloud Shell-Sitzung geöffnet. Führen Sie in dieser Cloud Shell-Sitzung die folgenden Befehle aus.

Beispielcode herunterladen

Klonen Sie die Git-Repositories mit den Kubernetes- und Istio-Ressourcen, die Sie verwenden werden:

  git clone https://github.com/GoogleCloudPlatform/anthos-service-mesh-samples.git
  git clone https://github.com/GoogleCloudPlatform/microservices-demo.git

Cluster mit Istio einrichten

Cluster erstellen und Istio installieren

In dem Abschnitt erstellen Sie Ihren Cluster, der Istio verwendet. In der Praxis sind dies die Cluster, die Sie bereits verwenden.

1. Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID und erstellen Sie einen neuen Cluster:

   gcloud container clusters create cluster-with-istio \
     --project=PROJECT_ID \
     --zone=us-central1-a \
     --machine-type=e2-standard-2 --num-nodes=3
   

   Hinweis: Dies kann einige Minuten dauern.

2. Benennen Sie den Clusterkontext um, damit der Cluster leichter verwendet werden kann:

   kubectl config rename-context \
     gke_PROJECT_ID_us-central1-a_cluster-with-istio \
     cluster-with-istio
   

3. Prüfen Sie, ob der Clusterkontext umbenannt wurde:

   kubectl config get-contexts --output="name"
   

4. Installieren Sie Istio im Cluster: Zur Vereinfachung installieren Sie das Standardprofil von Istio und die Version, die Ihrer istioctl-Installation entspricht.

   istioctl install
   

   Sie werden aufgefordert, „y“ einzugeben, und dann die Eingabetaste drücken.

   Die Ausgabe sieht etwa so aus:

   This will install the Istio X.Y.Z default profile with ["Istio core" "Istiod" "Ingress gateways"] components into the cluster. Proceed? (y/N)
   ✔ Istio core installed
   ✔ Istiod installed
   ✔ Ingress gateways installed
   ✔ Installation complete
   Making this installation the default for injection and validation.
   

Online Boutique bereitstellen

1. Sie stellen Online Boutique in einem separaten Namespace namens onlineboutique bereit. Erstellen Sie den Namespace:

   kubectl \
     --context cluster-with-istio \
     create namespace onlineboutique
   

2. Stellen Sie die 12 Dienste von Online Boutique bereit. Dazu gehören ein Ladegenerator, der den Nutzertraffic weiterleitet:

   kubectl \
     --namespace=onlineboutique \
     --context=cluster-with-istio \
     apply -f microservices-demo/release/kubernetes-manifests.yaml
   

3. Im vorherigen Schritt wurde auch ein Dienst namens frontend-external vom Typ LoadBalancer bereitgestellt, dem eine externe IP-Adresse zugewiesen wird. Sie möchten jedoch nur öffentlichen eingehenden Traffic über die Bereitstellung des Istio-Ingress-Gateways zulassen. Löschen Sie die Dienstressource frontend-external:

   kubectl \
     --namespace=onlineboutique \
     --context=cluster-with-istio \
     delete service frontend-external
   

4. Stellen Sie eine Istio-Gateway-Ressource und eine Istio-VirtualService-Ressource für den öffentlichen Traffic bereit, um auf Online Boutique zuzugreifen:

   kubectl \
     --namespace=onlineboutique \
     --context=cluster-with-istio \
     apply -f microservices-demo/istio-manifests/frontend-gateway.yaml
   

5. Rufen Sie die externe IP-Adresse des Istio-Ingress-Gateways ab:

   kubectl \
     --namespace istio-system \
     --context=cluster-with-istio \
     get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}'
   

6. Kopieren Sie die externe IP-Adresse des Dienstes istio-ingressgateway und greifen Sie dann über Ihren Webbrowser darauf zu. Sie sehen die Beispiel-App „Online Boutique“.

Neuen Cluster mit verwaltetem Cloud Service Mesh einrichten

Cluster erstellen und verwaltetes Cloud Service Mesh bereitstellen

In diesem Abschnitt erstellen Sie den Cluster, zu dem Sie migrieren. Sie stellen verwaltetes Cloud Service Mesh bereit und stellen Online Boutique bereit, um die Bereitstellungen aus dem Cluster zu replizieren, der Istio verwendet.

1. Erstellen Sie einen neuen Cluster:

   gcloud container clusters create cluster-with-csm \
     --project=PROJECT_ID --zone=us-central1-a \
     --machine-type=e2-standard-4 --num-nodes=2 \
     --workload-pool PROJECT_ID.svc.id.goog
   

   Hinweis: Dies kann einige Minuten dauern.

2. Benennen Sie den Clusterkontext um, damit der Cluster leichter verwendet werden kann:

   kubectl config rename-context \
     gke_PROJECT_ID_us-central1-a_cluster-with-csm \
     cluster-with-csm
   

3. Prüfen Sie, ob der Clusterkontext umbenannt wurde:

   kubectl config get-contexts --output="name"
   

4. Aktivieren Sie Cloud Service Mesh in der Flotte Ihres Projekts. Eine Flotte ist eine logische Gruppierung von Kubernetes-Clustern und anderen Ressourcen, die zusammen verwaltet werden können.

   gcloud container fleet mesh enable --project PROJECT_ID
   

   Die Ausgabe sieht etwa so aus:

   Waiting for Feature Service Mesh to be created...done.
   

5. Registrieren Sie den Cluster in der Flotte des Projekts:

   gcloud container fleet memberships register cluster-with-csm-membership \
     --gke-cluster=us-central1-a/cluster-with-csm \
     --enable-workload-identity \
     --project PROJECT_ID
   

   Die Ausgabe sieht etwa so aus:

   Waiting for membership to be created...done.
   Finished registering to the Fleet.
   

6. Aktivieren Sie verwaltetes Cloud Service Mesh im Cluster:

   gcloud container fleet mesh update \
     --management automatic \
     --memberships cluster-with-csm-membership \
     --project PROJECT_ID
   

   Die Ausgabe sieht etwa so aus:

   Waiting for Feature Service Mesh to be updated...done.
   

   Hinweis: verwaltete Cloud Service Mesh nimmt Ihnen einen Großteil der manuellen Wartungsarbeiten ab, die mit dem Upgrade, der Skalierung und der Sicherung Ihres Service Mesh verbunden sind. Weitere Informationen zu verwaltetem Cloud Service Mesh .

7. Prüfen Sie, ob verwaltetes Cloud Service Mesh für den Cluster bereitgestellt wurde und bereit zur Verwendung ist:

   gcloud container fleet mesh describe --project PROJECT_ID
   

   Es kann etwa 10 Minuten dauern, bis Cloud Service Mesh bereitgestellt wird und im Cluster bereit ist. Wenn controlPlaneManagement.state: DISABLED oder controlPlaneManagement.state: PROVISIONING angezeigt wird, müssen Sie den vorherigen Befehl alle paar Minuten noch einmal ausführen, bis controlPlaneManagement.state: ACTIVE angezeigt wird.

   Die Ausgabe sieht etwa so aus:

   createTime: '2022-07-06T01:05:39.110120474Z'
   membershipSpecs:
     projects/123456789123/locations/global/memberships/cluster-with-csm-membership:
       mesh:
         management: MANAGEMENT_AUTOMATIC
   membershipStates:
     projects/123456789123/locations/global/memberships/cluster-with-csm-membership:
       servicemesh:
         controlPlaneManagement:
           details:
           - code: REVISION_READY
             details: 'Ready: asm-managed'
           state: ACTIVE
         dataPlaneManagement:
           details:
           - code: OK
             details: Service is running.
           state: ACTIVE
       state:
         code: OK
         description: 'Revision(s) ready for use: asm-managed.'
         updateTime: '2022-07-06T01:19:24.243993678Z'
   name: projects/your-project-id/locations/global/features/servicemesh
   resourceState:
     state: ACTIVE
   spec: {}
   state:
     state: {}
   updateTime: '2022-07-06T01:19:27.475885687Z'
   

Ingress-Gateway von Cloud Service Mesh bereitstellen

1. Sie stellen das Ingress-Gateway von Cloud Service Mesh in einem separaten Namespace namens asm-ingress bereit. Erstellen Sie den Namespace:

   kubectl \
     --context cluster-with-csm \
     create namespace asm-ingress
   

2. Verwenden Sie das Label istio.io/rev=asm-managed, um den Namespace asm-ingress dem Service Mesh hinzuzufügen und die automatische Sidecar-Proxy-Injektion zu aktivieren.

   kubectl \
     --context cluster-with-csm \
     label namespace asm-ingress 'istio.io/rev=asm-managed'
   

3. Stellen Sie das Cloud Service Mesh Ingress-Gateway bereit:

   kubectl \
     --context cluster-with-csm \
     --namespace=asm-ingress \
     apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/asm-gateway-deployment-svc.yaml
   kubectl \
     --context cluster-with-csm \
     --namespace=asm-ingress \
     apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/gateway.yaml
   

   Die Ausgabe sieht etwa so aus:

   namespace/asm-ingress configured
   serviceaccount/asm-ingressgateway configured
   service/asm-ingressgateway configured
   deployment.apps/asm-ingressgateway configured
   gateway.networking.istio.io/asm-ingressgateway configured
   

   Hinweis: Sie können in den Ressourcen im offiziellen Beispiel-GitHub-Repository von Cloud Service Mesh suchen.

Online Boutique bereitstellen

1. Sie stellen Online Boutique in einem separaten Namespace namens onlineboutique bereit. Erstellen Sie den Namespace:

   kubectl \
     --context cluster-with-csm \
     create namespace onlineboutique
   

2. Verwenden Sie das Label istio.io/rev=asm-managed, um den Namespace onlineboutique dem Service Mesh hinzuzufügen und die automatische Sidecar-Proxy-Injektion zu aktivieren.

   kubectl \
     --context cluster-with-csm \
     label namespace onlineboutique 'istio.io/rev=asm-managed'
   

3. Stellen Sie die 12 Dienste von Online Boutique bereit, einschließlich des Load-Generators, der den Nutzertraffic weiterleitet:

   kubectl \
     --context cluster-with-csm \
     --namespace=onlineboutique \
     apply -f anthos-service-mesh-samples/docs/shared/online-boutique/kubernetes-manifests.yaml
   kubectl \
     --context cluster-with-csm \
     --namespace=onlineboutique \
     apply -f anthos-service-mesh-samples/docs/shared/online-boutique/virtual-service.yaml
   

4. Rufen Sie die externe IP-Adresse des Ingress-Gateways von Cloud Service Mesh ab:

   kubectl \
     --context cluster-with-csm \
     --namespace asm-ingress \
     get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}'
   

5. Kopieren Sie die externe IP-Adresse des Dienstes asm-ingressgateway und greifen Sie über Ihren Webbrowser darauf zu. Sie sehen die Beispielanwendung Online Boutique. Sie verwenden die externe IP-Adresse im nächsten Abschnitt. Kopieren Sie sie also in eine Umgebungsvariable:

   export INGRESS_IP_OF_CLUSTER_WITH_MANAGED_ASM=$( \
     kubectl \
       --context cluster-with-csm \
       --namespace asm-ingress \
       get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}' \
     )
   

Cluster mit Cloud Service Mesh unter Verwendung eines Canary-Deployments testen

In diesem Abschnitt konfigurieren Sie den Cluster mit Istio so, dass 50% des Nutzertraffics zu Online Boutique auf die Instanz von Online Boutique im Cluster mit verwaltetem Cloud Service Mesh verschoben werden. Dazu stellen Sie mit Istio zwei Istio-Ressourcen im Cluster bereit:

• Einen ServiceEntry, um Istio über den Online-Endpunkt des verwalteten Cloud Service Mesh-Clusters zu informieren
• Einen VirtualService, um dem Istio-Ingress-Gateway mitzuteilen, dass der Traffic je zur Hälfte aufgeteilt werden soll.

Hinweis: In der Produktion sollte diese Aufteilung des Traffics auf den Cluster mit verwaltetem Cloud Service Mesh in kleinen Schritten erfolgen – statt sofort auf 50 % – und schrittweise auf 100 % erhöht werden.

1. Legen Sie die IP-Adresse des Ingress-Gateways des verwalteten Cloud Service Mesh-Clusters in der Ressource ServiceEntry fest:

   sed -i "s/1.2.3.4/${INGRESS_IP_OF_CLUSTER_WITH_MANAGED_ASM}/" anthos-service-mesh-samples/docs/migrate-to-managed-asm/service-entry.yaml
   

2. Stellen Sie den ServiceEntry mit Istio im Cluster bereit:

   kubectl \
     --context cluster-with-istio \
     --namespace onlineboutique \
     apply -f anthos-service-mesh-samples/docs/migrate-to-managed-asm/service-entry.yaml
   

3. Stellen Sie den VirtualService mit Istio im Cluster bereit:

   kubectl \
     --context cluster-with-istio \
     --namespace onlineboutique \
     apply -f anthos-service-mesh-samples/docs/migrate-to-managed-asm/virtual-service.yaml
   

4. Rufen Sie in Ihrem Webbrowser die IP-Adresse des Ingress-Gateways des Clusters mit Istio auf:

   kubectl \
     --context cluster-with-istio \
     --namespace istio-system \
     get service
   

   Aktualisieren Sie die Online Boutique-Startseite mehrmals und prüfen Sie jedes Mal die Fußzeile der Seite. Beachten Sie, dass 50% der Anfragen von einem Pod im Cluster mit verwaltetem Cloud Service Mesh verarbeitet werden.

Mit verwaltetem Cloud Service Mesh zum Cluster migrieren

In diesem Abschnitt wird davon ausgegangen, dass Sie Inhaber eines Domainnamens sind und Zugriff auf die DNS-Einstellungen (Domainnamenserver) haben.

1. Fügen Sie einen A-Eintrag zu den DNS-Einstellungen hinzu, um den Domainnamen (z. B. example.com) auf die IP-Adresse des Ingress-Gateways zu verweisen, das auf dem Cluster mit Istio läuft.

   Hinweis: Dies kann einige Minuten dauern.

2. Greifen Sie über den Domainnamen in Ihrem Webbrowser auf Online Boutique zu.

3. Minimieren Sie die Gültigkeitsdauer (TTL) für DNS-Einträge, damit Sie den DNS-Eintrag schnell zurücksetzen können, wenn Sie ein Rollback durchführen müssen.

4. Legen Sie für den A-Eintrag Ihres Domainnamens die externe IP-Adresse des Ingress-Gateways des Clusters mit verwaltetem Cloud Service Mesh fest.

5. Wenn die Migration erfolgreich ist, löschen Sie den Cluster mit Istio:

   gcloud container clusters delete cluster-with-istio \
     --zone=us-central1-a \
     --project=PROJECT_ID
   

Bereinigen

Damit Ihrem Google Cloud -Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, können Sie entweder das Projekt löschen, das die Ressourcen enthält, oder das Projekt beibehalten und die einzelnen Ressourcen löschen.

Projekt löschen

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:
• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.
1. Wechseln Sie in der Google Cloud -Console zur Seite Ressourcen verwalten.

   Zur Seite „Ressourcen verwalten“

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.

Ressourcen löschen

Löschen Sie den Cluster mit verwaltetem Cloud Service Mesh:

  gcloud container clusters delete cluster-with-managed-asm \
    --zone=us-central1-a \
    --project=PROJECT_ID

Nächste Schritte

• Weitere Informationen zu verwaltetem Cloud Service Mesh.
• Weitere Informationen zu Best Practices für die Sicherheit von Cloud Service Mesh.