Schnellstartlösung: In Kubernetes bereitgestellte E-Commerce-Webanwendung

Last reviewed 2023-08-29 UTC

Diese Anleitung hilft Ihnen, die Schnellstartlösung In Kubernetes bereitgestellte E-Commerce-Webanwendung zu verstehen, bereitzustellen und zu verwenden. Diese Lösung zeigt, wie Sie für ein Einzelhandelsunternehmen eine E-Commerce-Anwendung mit einer öffentlich sichtbaren Shop-Website erstellen und ausführen. Sie erfahren, wie Sie eine Anwendung erstellen, die skalieren kann, um Spitzen bei der Nutzung zu bewältigen (z. B. bei Ereignissen wie einem Verkauf), und Anfragen basierend auf dem Standort des Besuchers verwalten kann. Der Online-Shop kann somit einen konsistenten Dienst für einen geografisch verteilten Kundenstamm bieten.

Die Anwendung wird als mehrere kleine Dienste oder Mikrodienste bereitgestellt, die auf von Google verwalteten Kubernetes-Clustern in Google Cloud ausgeführt werden. Jeder Dienst führt eine bestimmte Aufgabe aus, z. B. die Bereitstellung des Web-Front-Ends oder die Verwaltung des Einkaufswagens.

Diese Lösung ist ein guter Ausgangspunkt, wenn Sie die Konfiguration und Flexibilität benötigen, die Kubernetes-Funktionen bei der Verwaltung Ihrer Website bieten. Eine Mikrodienstarchitektur wie diese ist auch besonders bei einem größeren Entwicklerteam nützlich, da es verschiedenen Teams oder Entwicklern ermöglicht, verschiedene Teile der Anwendung separat zu erstellen und zu verwalten. Wenn dies nicht für Ihre Organisation der Fall ist oder Sie sich nicht sicher sind, verwenden Sie die Lösung In Cloud Run bereitgestellte E-Commerce-Webanwendung. In dieser Lösung wird Cloud Run zum Bereitstellen einer ähnlichen Online-Shopanwendung ohne Mikrodienste und ohne Kubernetes bereitgestellt.

In diesem Dokument wird davon ausgegangen, dass Sie mit grundlegenden Cloud-Konzepten vertraut sind, aber nicht unbedingt mit Google Cloud. Erfahrung mit Terraform ist hilfreich.

Cymbal Shops

Die in dieser Lösung verwendete Anwendung ist ein Demo-Onlineshop für eine imaginäre Einzelhandelskette mit dem Namen „Cymbal Shops“ und einer Website, über die Besucher nach Produkten des Unternehmens suchen, Produkte in ihren Einkaufswagen legen, zur Kasse gehen und Produkte kaufen können. Sie können sie selbst testen, nachdem Sie die Lösung bereitgestellt haben. Leider können Sie keines der Produkte tatsächlich erwerben. Cymbal Shops haben Kunden in den USA und Europa. Daher benötigen sie eine Websitelösung, die für alle Besucher gleich schnell ist. Cymbal Shops haben auch häufig Verkäufe und erhalten viele Käufer an Feiertagen. Daher muss ihre Website in der Lage sein, einen Anstieg des Traffics zu bewältigen, ohne sich zu verlangsamen oder andere Probleme zu verursachen und ohne Geld für Cloud-Ressourcen ausgeben zu müssen, die nicht benötigt werden.

Verwendete Produkte

Die Lösung verwendet die folgenden Google Cloud-Produkte:

Google Kubernetes Engine (GKE): Eine verwaltete Umgebung zum Bereitstellen, Verwalten und Skalieren von Containeranwendungen in der Google-Infrastruktur.
Multi-Cluster-Ingress: Ein von Google gehosteter Dienst, der das Deployment freigegebener Load-Balancing-Ressourcen in mehreren Clustern und Regionen unterstützt.

Informationen zur Konfiguration dieser Produkte und zu ihrer Interaktion finden Sie im nächsten Abschnitt.

Architektur

Die Lösung stellt eine E-Commerce-Anwendung mit einer öffentlich zugänglichen Weboberfläche bereit. Das folgende Diagramm zeigt die Architektur der von der Lösung bereitgestellten Google Cloud-Ressourcen:

Diagramm zur Schnellstartlösung „In Kubernetes bereitgestellte E-Commerce-Webanwendung“

Anfrageablauf

Im Folgenden wird der Ablauf der Anfrageverarbeitung für die bereitgestellte Anwendung dargestellt. Die Schritte im Ablauf sind wie im vorherigen Architekturdiagramm dargestellt nummeriert.

Ein Nutzer interagiert in seinem Browser mit der Cymbal Shops-Website, wodurch eine HTTP-Anfrage an einen Google Cloud-Load-Balancer gesendet wird. Dies ist ein Load-Balancer am Edge des Google-Netzwerks, der Traffic an das entsprechende Ziel in Google Cloud weiterleitet.
Die Nutzeranfrage wird an einen der beiden GKE-Cluster weitergeleitet, in denen das Anwendungs-Frontend ausgeführt wird. Standardmäßig ist dies der Cluster, der am nächsten zum Nutzer liegt. Im vorherigen Diagramm befindet sich der nächste Cluster in Europa. Die Anfrage wird also dorthin gesendet. Weitere Informationen zur Konfiguration mit dem Multi-Cluster-Ingress-Dienst finden Sie im nächsten Abschnitt.
Die Anfrage wird von einem oder mehreren der Backend-Mikrodienste verarbeitet, die den Rest der Cymbal Shops-Anwendung ausmachen.
Der cartservice der Anwendung speichert den Status des Einkaufswagens von Nutzern mithilfe einer Redis-Datenbank, während sie die Website besuchen. Eine Redis-Datenbank wird nur im US-Cluster bereitgestellt.

Komponenten und Konfiguration

Die Cymbal Shops-Anwendung wird auf GKE-Clustern (Google Kubernetes Engine) ausgeführt. Kubernetes ist ein Open-Source-System zur Automatisierung der Bereitstellung, Skalierung und Verwaltung von Containeranwendungen. Dabei wird die Anwendung mit den zugehörigen Abhängigkeiten unabhängig von ihrer Umgebung verpackt (oder containerisiert). Ein Kubernetes-Cluster besteht aus einer Reihe von als Knoten bezeichneten Maschinen, die Sie zum Ausführen der Container verwenden. GKE mit Autopilot ist der skalierbare und vollständig automatisierte Kubernetes-Dienst von Google, bei dem Ihre Cluster aus virtuellen Compute Engine-Maschinen in Google Cloud bestehen.

Die Lösung „Cymbals Shops“ umfasst die folgenden Komponenten:

Drei GKE-Cluster:
- Ein Cluster, der als Konfigurationscluster bezeichnet wird und zur Verwaltung des Multi-Cluster-Ingress-Dienstes für die Anwendung verwendet wird. Multi-Cluster-Ingress ist ein Dienst, mit dem Sie Traffic über eine bestimmte Gruppe von Clustern mit einer einzigen virtuellen IP-Adresse für Ihre Anwendung verteilen können.
- Zwei Cluster in unterschiedlichen Regionen, um die Cymbal Shops-Mikrodienste auszuführen. Jeder Cluster hat identische Cymbal Shops-Dienste, die in denselben Kubernetes-Namespaces ausgeführt werden. Dadurch kann Multi-Cluster-Ingress beide Frontend-Dienste so behandeln, als wären sie derselbe Dienst, wobei der Cluster abhängig von der Nähe des Websitebesuchers Traffic sendet. Multi-Cluster-Ingress kann auch verwendet werden, um sicherzustellen, dass Traffic nur an fehlerfreie Cluster gesendet wird, dass bei Upgrades schrittweise Rollouts durchgeführt werden und vieles mehr.
Für alle drei GKE-Cluster ist Autopilot aktiviert. Autopilot ist ein GKE-Feature, mit dem Sie Cluster erstellen können, in denen Google Ihre Clusterkonfiguration verwaltet, einschließlich Knoten, Skalierung, Sicherheit und anderer vorkonfigurierter Einstellungen. Für Cymbal Shops bedeutet dies, dass die Cluster automatisch die CPU-, Arbeitsspeicher- und Speicherkapazität entsprechend den Anforderungen der Anwendung hochskalieren können, wenn mehr Besucher als gewöhnlich die Website aufrufen. Wenn Autopilot aktiviert ist, muss der Administrator der Cymbal Shops-Plattform keine weiteren Cloud-Ressourcen anfordern (und bezahlen), als die meiste Zeit benötigt werden, oder riskieren, dass Cluster nicht ausreichend Ressourcen haben, um den erhöhten Traffic an Tagen mit hohem Volumen zu bewältigen.

Kosten

Die geschätzten monatlichen Kosten finden Sie auf der Seite In Kubernetes bereitgestellte E-Commerce-Webanwendung anhand der Standardressourcenstandorte und der geschätzten Nutzungszeit. Weitere Informationen zu den Preisen für GKE, Autopilot und Multi-Cluster-Ingress finden Sie auf der GKE-Preisseite.

Hinweise

Zum Bereitstellen dieser Lösung benötigen Sie zuerst ein Google Cloud-Projekt und einige IAM-Berechtigungen.

Google Cloud-Projekt erstellen oder auswählen

Beim Bereitstellen der Lösung wählen Sie das Google Cloud-Projekt aus, in dem die Ressourcen bereitgestellt werden. Bei der Entscheidung, ob Sie ein vorhandenes Projekt verwenden oder ein neues Projekt erstellen möchten, berücksichtigen Sie die folgenden Faktoren:

Wenn Sie ein Projekt für die Lösung erstellen und die Bereitstellung nicht mehr benötigen, können Sie das Projekt löschen, um weitere Kosten zu vermeiden. Wenn Sie ein vorhandenes Projekt verwenden, müssen Sie die Bereitstellung löschen, wenn Sie sie nicht mehr benötigen.
Durch die Verwendung eines neuen Projekts können Konflikte mit zuvor bereitgestellten Ressourcen vermieden werden, beispielsweise Ressourcen, die für Produktionsarbeitslasten verwendet werden.

Wenn Sie die Lösung in einem neuen Projekt bereitstellen möchten, erstellen Sie das Projekt, bevor Sie mit der Bereitstellung beginnen.

So erstellen Sie ein Projekt:

In the Google Cloud console, go to the project selector page.

Go to project selector
Click Create project.
Name your project. Make a note of your generated project ID.
Edit the other fields as needed.
Click Create.

Erforderliche IAM-Berechtigungen abrufen

Zum Starten des Bereitstellungsprozesses benötigen Sie die in der folgenden Tabelle aufgeführten IAM-Berechtigungen (Identity and Access Management). Wenn Sie die einfache Rolle roles/owner für das Projekt haben, in dem Sie die Lösung bereitstellen möchten, haben Sie bereits alle erforderlichen Berechtigungen. Wenn Sie die Rolle roles/owner nicht haben, bitten Sie Ihren Administrator, Ihnen die Berechtigungen (oder die Rollen mit diesen Berechtigungen) zu gewähren.

Erforderliche IAM-Berechtigung	Vordefinierte Rolle mit den erforderlichen Berechtigungen
`serviceusage.services.enable`	Service Usage-Administrator (`roles/serviceusage.serviceUsageAdmin`)
`iam.serviceAccounts.create`	Dienstkontoadministrator (`roles/iam.serviceAccountAdmin`)
`resourcemanager.projects.setIamPolicy`	Projekt-IAM-Administrator (`roles/resourcemanager.projectIamAdmin`)
`config.deployments.create` `config.deployments.list`	Cloud Infrastructure Manager Admin (`roles/config.admin`)

Dienstkonto, das für die Lösung erstellt wurde

Wenn Sie den Bereitstellungsprozess über die Console starten, erstellt Google ein Dienstkonto, um die Lösung für Sie bereitzustellen und die Bereitstellung später zu löschen, wenn Sie dies möchten. Diesem Dienstkonto werden bestimmte IAM-Berechtigungen vorübergehend zugewiesen. Das heißt, die Berechtigungen werden automatisch widerrufen, nachdem die Bereitstellungs- und Löschvorgänge für die Lösung abgeschlossen sind. Google empfiehlt, dass Sie nach dem Löschen der Bereitstellung das Dienstkonto löschen, wie weiter unten in dieser Anleitung beschrieben.

Rollen aufrufen, die dem Dienstkonto zugewiesen sind

Diese Rollen sind hier aufgeführt, falls ein Administrator Ihres Google Cloud-Projekts oder Ihrer Organisation diese Informationen benötigt.

roles/container.admin
roles/gkehub.editor
roles/compute.networkAdmin
roles/iam.serviceAccountAdmin
roles/iam.serviceAccountUser
roles/resourcemanager.projectIamAdmin
roles/serviceusage.serviceUsageAdmin

Lösung bereitstellen

Damit Sie diese Lösung mit minimalem Aufwand bereitstellen können, wird in GitHub eine Terraform-Konfiguration bereitgestellt. Die Terraform-Konfiguration definiert alle Google Cloud-Ressourcen, die für die Lösung erforderlich sind.

Sie können die Lösung mit einer der folgenden Methoden bereitstellen:

Über die Console: Verwenden Sie diese Methode, wenn Sie die Lösung mit der Standardkonfiguration testen und sehen möchten, wie sie funktioniert. Cloud Build stellt alle für die Lösung erforderlichen Ressourcen bereit. Wenn Sie die bereitgestellte Lösung nicht mehr benötigen, können Sie sie aus der Console löschen. Alle Ressourcen, die Sie nach der Bereitstellung der Lösung erstellen, müssen möglicherweise separat gelöscht werden.

Folgen Sie der Anleitung unter Über die Console bereitstellen, um diese Bereitstellungsmethode zu verwenden.
Terraform-Befehlszeile verwenden: Verwenden Sie diese Methode, wenn Sie die Lösung anpassen oder die Bereitstellung und Verwaltung der Ressourcen mithilfe von Infrastruktur als Code (IaC) automatisieren möchten. Laden Sie die Terraform-Konfiguration von GitHub herunter, passen Sie optional den Code nach Bedarf an und stellen Sie die Lösung mit der Terraform-Befehlszeile bereit. Nachdem Sie die Lösung bereitgestellt haben, können Sie sie mit Terraform verwalten.

Folgen Sie der Anleitung unter Mit der Terraform CLI bereitstellen, um diese Bereitstellungsmethode zu verwenden.

Über die Console bereitstellen

Führen Sie die folgenden Schritte aus, um die vorkonfigurierte Lösung bereitzustellen.

Wechseln Sie im Google Cloud-Katalog der Schnellstartlösungen zur Lösung In Kubernetes bereitgestellte E-Commerce-Webanwendung.

Zur Lösung "In Kubernetes bereitgestellte E-Commerce-Webanwendung"
Prüfen Sie die auf der Seite bereitgestellten Informationen, z. B. die geschätzten Kosten der Lösung und die geschätzte Bereitstellungszeit.
Wenn Sie die Lösung bereitstellen möchten, klicken Sie auf Bereitstellen.

Es wird eine interaktive Schritt-für-Schritt-Anleitung angezeigt.
Führen Sie die Schritte in der interaktiven Anleitung aus.

Notieren Sie sich den Namen, den Sie für die Bereitstellung eingegeben haben. Sie benötigen diesen Namen später, wenn Sie die Bereitstellung löschen.

Wenn Sie auf Bereitstellen klicken, wird die Seite Lösungsbereitstellungen angezeigt. Im Feld Status auf dieser Seite wird Wird bereitgestellt angezeigt.
Warten Sie, bis die Lösung bereitgestellt wurde.

Wenn die Bereitstellung fehlschlägt, wird im Feld Status der Eintrag Fehlgeschlagen angezeigt. Sie können das Cloud Build-Log verwenden, um die Fehler zu diagnostizieren. Weitere Informationen finden Sie unter Fehler bei der Bereitstellung über die Console.

Wenn die Bereitstellung abgeschlossen ist, ändert sich das Feld Status in Bereitgestellt.

Wenn Sie die Lösung nicht mehr benötigen, können Sie die Bereitstellung löschen, um weitere Kosten für die Google Cloud-Ressourcen zu vermeiden. Weitere Informationen finden Sie unter Bereitstellung löschen.

Fahren Sie mit Cymbal Shops entdecken fort, um zu erfahren, wie Sie Ihre Lösung testen und kennenlernen.

Mit der Terraform-Befehlszeile bereitstellen

In diesem Abschnitt wird beschrieben, wie Sie die Lösung anpassen oder die Bereitstellung und Verwaltung der Lösung mit der Terraform CLI automatisieren können. Lösungen, die Sie mit der Terraform-Befehlszeile bereitstellen, werden auf der Seite Lösungsbereitstellungen in der Google Cloud Console nicht angezeigt.

Wenn Sie die Bereitstellung nicht mehr benötigen, können Sie sie mit der Terraform-Befehlszeile löschen, wie unter Mit der Terraform-Befehlszeile löschen beschrieben.

Terraform-Client einrichten

Sie können Terraform entweder in Cloud Shell oder auf Ihrem lokalen Host ausführen. In dieser Anleitung wird beschrieben, wie Sie Terraform in Cloud Shell ausführen. Dort ist Terraform vorinstalliert und für die Authentifizierung bei Google Cloud konfiguriert.

Der Terraform-Code für diese Lösung ist in einem GitHub-Repository verfügbar.

Klonen Sie das GitHub-Repository in Cloud Shell.

Es wird eine Eingabeaufforderung angezeigt, um das Herunterladen des GitHub-Repositorys in Cloud Shell zu bestätigen.
Klicken Sie auf Bestätigen.

Cloud Shell wird in einem separaten Browser-Tab gestartet und der Terraform-Code wird in das Verzeichnis $HOME/cloudshell_open Ihrer Cloud Shell-Umgebung heruntergeladen.
Prüfen Sie in Cloud Shell, ob das aktuelle Arbeitsverzeichnis $HOME/cloudshell_open/terraform-ecommerce-microservices-on-gke/infra ist. Dies ist das Verzeichnis, das die Terraform-Konfigurationsdateien für die Lösung enthält. Wenn Sie in dieses Verzeichnis wechseln müssen, führen Sie den folgenden Befehl aus:
```
cd $HOME/cloudshell_open/terraform-ecommerce-microservices-on-gke/infra
```
Initialisieren Sie Terraform mit dem folgenden Befehl:
```
terraform init
```
Warten Sie, bis folgende Meldung angezeigt wird:
```
Terraform has been successfully initialized!
```

Terraform-Variablen konfigurieren

Der heruntergeladene Terraform-Code enthält Variablen, mit denen Sie die Bereitstellung entsprechend Ihren Anforderungen anpassen können. Sie können beispielsweise das Google Cloud-Projekt und die Region angeben, in der die Lösung bereitgestellt werden soll.

Achten Sie darauf, dass das aktuelle Arbeitsverzeichnis $HOME/cloudshell_open/terraform-ecommerce-microservices-on-gke/infra ist. Ist dies nicht der Fall, wechseln Sie zu diesem Verzeichnis.
Erstellen Sie im selben Verzeichnis eine Textdatei mit dem Namen terraform.tfvars.
Kopieren Sie in der Datei terraform.tfvars das folgende Code-Snippet und legen Sie Werte für die erforderlichen Variablen fest.
- Folgen Sie den Anleitungen, die im Code-Snippet als Kommentare angegeben sind.
- Dieses Code-Snippet enthält nur die Variablen, für die Sie Werte festlegen müssen. Die Terraform-Konfiguration enthält andere Variablen mit Standardwerten. Informationen zu allen Variablen und Standardwerten finden Sie in der Datei variables.tf im Verzeichnis $HOME/cloudshell_open/terraform-ecommerce-microservices-on-gke/infra.
- Achten Sie darauf, dass jeder in der Datei terraform.tfvars festgelegte Wert mit dem Typ der Variable übereinstimmt, wie in der Datei variables.tf angegeben. Beispiel: Wenn der Typ, der für eine Variable in der Datei variables.tf definiert wurde, bool ist, müssen Sie true oder false als Wert dieser Variable in der Datei terraform.tfvars angeben.

# This is an example of the terraform.tfvars file.
# The values in this file must match the variable types declared in variables.tf.
# The values in this file override any defaults in variables.tf.

# ID of the project in which you want to deploy the solution
project_id = "PROJECT_ID"

Weitere Informationen zu den Werten, die Sie der Variable project_id zuweisen können, finden Sie unter Projekte identifizieren.

Terraform-Konfiguration validieren und prüfen

Prüfen Sie, ob das aktuelle Arbeitsverzeichnis $HOME/cloudshell_open/terraform-ecommerce-microservices-on-gke/infra ist. Ist dies nicht der Fall, wechseln Sie zu diesem Verzeichnis.
Prüfen Sie, ob die Terraform-Konfiguration Fehler enthält:
```
terraform validate
```
Wenn der Befehl einen Fehler zurückgibt, nehmen Sie die erforderlichen Korrekturen in der Konfiguration vor und führen Sie den Befehl terraform validate noch einmal aus. Wiederholen Sie diesen Schritt, bis der Befehl die folgende Meldung zurückgibt:
```
Success! The configuration is valid.
```
Sehen Sie sich die Ressourcen an, die in der Konfiguration definiert sind:
```
terraform plan
```
Wenn Sie die Datei terraform.tfvars nicht wie zuvor beschrieben erstellt haben, werden Sie von Terraform zur Eingabe von Werten für die Variablen aufgefordert, die keine Standardwerte haben. Geben Sie die erforderlichen Werte ein.

Die Ausgabe des Befehls terraform plan ist eine Liste der Ressourcen, die Terraform beim Anwenden der Konfiguration bereitstellt.

Wenn Sie Änderungen vornehmen möchten, bearbeiten Sie die Konfiguration und führen Sie dann die Befehle terraform validate und terraform plan noch einmal aus.

Ressourcen bereitstellen

Wenn keine weiteren Änderungen an der Terraform-Konfiguration erforderlich sind, stellen Sie die Ressourcen bereit.

Prüfen Sie, ob das aktuelle Arbeitsverzeichnis $HOME/cloudshell_open/terraform-ecommerce-microservices-on-gke/infra ist. Ist dies nicht der Fall, wechseln Sie zu diesem Verzeichnis.
Wenden Sie die Terraform-Konfiguration an:
```
terraform apply
```
Wenn Sie die Datei terraform.tfvars nicht wie zuvor beschrieben erstellt haben, werden Sie von Terraform zur Eingabe von Werten für die Variablen aufgefordert, die keine Standardwerte haben. Geben Sie die erforderlichen Werte ein.

Terraform zeigt eine Liste der Ressourcen an, die erstellt werden.
Wenn Sie aufgefordert werden, die Aktionen auszuführen, geben Sie yes ein.

In Terraform werden Nachrichten angezeigt, die den Fortschritt der Bereitstellung anzeigen.

Wenn die Bereitstellung nicht abgeschlossen werden kann, zeigt Terraform die Fehler an, die den Fehler verursacht haben. Prüfen Sie die Fehlermeldungen und aktualisieren Sie die Konfiguration, um die Fehler zu beheben. Führen Sie den Befehl terraform apply dann noch einmal aus. Hilfe zur Fehlerbehebung bei Terraform-Fehlern finden Sie unter Fehler bei der Bereitstellung der Lösung mit der Terraform-Befehlszeile.

Nachdem alle Ressourcen erstellt wurden, zeigt Terraform die folgende Meldung an:
```
Apply complete!
```

Fahren Sie mit Cymbal Shops entdecken fort, um zu erfahren, wie Sie Ihre Lösung testen und kennenlernen.

Cymbal Shops entdecken

Glückwunsch, Sie haben die Website von Cymbal Shops bereitgestellt! Sie können die Website von Cymbal Shops besuchen und sich dort ansehen, wie die Lösung in der Google Cloud Console funktioniert. Nach dem erfolgreichen Bereitstellen der Anwendung kann es etwa fünf Minuten dauern, bis die Website unter der angegebenen Adresse angezeigt wird.

Website von Cymbals Shops besuchen

Wie Sie die Website von Cymbals aufrufen, hängt davon ab, wie Sie die Lösung bereitgestellt haben.

Bereitstellungen über die Console

Wenn Sie die Lösung über die Console bereitgestellt haben, können Sie die Website direkt über die Seite Lösungsbereitstellungen aufrufen.

Wenn Sie die Bereitstellung der Lösung gerade erst abgeschlossen haben, klicken Sie auf Webanwendung ansehen, um die Website aufzurufen. Klicken Sie andernfalls auf das Menü Aktionen für die Bereitstellung und wählen Sie Webanwendung ansehen aus.

Terraform-Bereitstellungen

Wenn Sie die Lösung mithilfe der Terraform-Befehlszeile bereitgestellt haben, suchen Sie zuerst die IP-Adresse für das Frontend, das von Multi-Cluster-Ingress bereitgestellt wird. Dies ist über die Befehlszeile mit der Google Cloud CLI (der einfachsten Ansatz) oder über die Google Cloud Console möglich.

gcloud

Prüfen Sie, ob die neueste Version der Google Cloud CLI installiert ist. Wir empfehlen, den Befehl in Cloud Shell auszuführen, wo das Tool bereits installiert ist.
Führen Sie folgenden Befehl aus, um die IP-Adresse abzurufen. Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Google Cloud-Projekts:
```
gcloud compute addresses list \
   --filter="name=('multi-cluster-ingress-ip-address-1')" \
   --project=PROJECT_ID
```
Kopieren Sie die vom Befehl zurückgegebene Adresse und fügen Sie sie in Ihren Browser ein, um die Website zu öffnen.

Console

Rufen Sie in der Google Cloud Console die Seite „Google Kubernetes Engine“ auf.

Zur Seite "Google Kubernetes Engine"
Wählen Sie im Navigationsmenü die Option Objektbrowser aus.
Maximieren Sie in der Liste Objektbrowser den Abschnitt networking.gke.io und wählen Sie dann MultiClusterIngress aus. Möglicherweise müssen Sie weiter scrollen, um diesen Abschnitt zu finden.
Wählen Sie auf der Seite MultiClusterIngress die Option MultiClusterIngress aus.
Suchen Sie auf der Detailseite frontend-multi-cluster-ingress die frontend-multi-cluster-ingress. Klicken Sie auf diese Adresse, um die Website aufzurufen.

Website entdecken

Sie können jetzt mit der Cymbal Shops-Website interagieren, wie Kunden sie sehen würden. Sie können nach Produkten suchen, Produkte in den Einkaufswagen legen und als Gast zur Kasse gehen.

Lösung entdecken

Nehmen Sie an einer interaktiven Tour teil, um die bereitgestellten Google Cloud-Ressourcen und ihre Konfiguration aufzurufen.

Tour starten

Bereitstellung löschen

Löschen Sie die Bereitstellung, wenn Sie die Lösungsbereitstellung nicht mehr benötigen, um eine weitere Abrechnung der von Ihnen erstellten Ressourcen zu vermeiden.

Über die Console löschen

Verwenden Sie dieses Verfahren, wenn Sie die Lösung über die Console bereitgestellt haben.

Rufen Sie in der Google Cloud Console die Seite Lösungsbereitstellungen auf.

Zu Lösungsbereitstellungen
Wählen Sie das Projekt aus, das die Bereitstellung enthält, die Sie löschen möchten.
Suchen Sie die Bereitstellung, die Sie löschen möchten.
Klicken Sie auf Aktionen und wählen Sie Löschen aus.
Geben Sie den Namen der Bereitstellung ein und klicken Sie auf Bestätigen.

Im Feld Status wird Löschen angezeigt.

Wenn der Löschvorgang fehlschlägt, lesen Sie die Anleitung zur Fehlerbehebung unter Fehler beim Löschen einer Bereitstellung.

Wenn Sie das für die Lösung verwendete Google Cloud-Projekt nicht mehr benötigen, können Sie das Projekt löschen. Weitere Informationen finden Sie unter Optional: Projekt löschen.

Mit der Terraform-Befehlszeile löschen

Verwenden Sie dieses Verfahren, wenn Sie die Lösung mit der Terraform CLI bereitgestellt haben.

Prüfen Sie in Cloud Shell, ob das aktuelle Arbeitsverzeichnis $HOME/cloudshell_open/terraform-ecommerce-microservices-on-gke/infra ist. Ist dies nicht der Fall, wechseln Sie zu diesem Verzeichnis.
Entfernen Sie die von Terraform bereitgestellten Ressourcen:
```
terraform destroy
```
Terraform zeigt eine Liste der Ressourcen an, die gelöscht werden.
Wenn Sie aufgefordert werden, die Aktionen auszuführen, geben Sie yes ein.

Terraform zeigt Nachrichten mit dem Fortschritt an. Nachdem alle Ressourcen gelöscht wurden, zeigt Terraform die folgende Meldung an:
```
Destroy complete!
```
Wenn der Löschvorgang fehlschlägt, lesen Sie die Anleitung zur Fehlerbehebung unter Fehler beim Löschen einer Bereitstellung.

Wenn Sie das für die Lösung verwendete Google Cloud-Projekt nicht mehr benötigen, können Sie das Projekt löschen. Weitere Informationen finden Sie unter Optional: Projekt löschen.

Optional: Projekt löschen

Wenn Sie die Lösung in einem neuen Google Cloud-Projekt bereitgestellt haben und das Projekt nicht mehr benötigen, löschen Sie es mit den folgenden Schritten:

Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.
Zur Seite „Ressourcen verwalten“
Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie auf Löschen.
Geben Sie an der Eingabeaufforderung die Projekt-ID ein und klicken Sie auf Beenden.

Wenn Sie das Projekt behalten möchten, löschen Sie das Dienstkonto, das für diese Lösung erstellt wurde, wie im nächsten Abschnitt beschrieben.

Optional: Dienstkonto löschen

Wenn Sie das Projekt gelöscht haben, das Sie für die Lösung verwendet haben, überspringen Sie diesen Abschnitt.

Wie bereits in diesem Leitfaden erwähnt, wurde bei der Bereitstellung der Lösung ein Dienstkonto für Sie erstellt. Dem Dienstkonto wurden vorübergehend bestimmte IAM-Berechtigungen zugewiesen; Das heißt, die Berechtigungen werden nach dem Abschluss der Bereitstellungs- und Löschvorgänge der Lösung automatisch widerrufen, aber das Dienstkonto wird nicht gelöscht. Google empfiehlt, dass Sie dieses Dienstkonto löschen.

Wenn Sie die Lösung über die Google Cloud Console bereitgestellt haben, rufen Sie die Seite Lösungsbereitstellungen auf. Wenn Sie sich bereits auf dieser Seite befinden, aktualisieren Sie den Browser. Im Hintergrund wird ein Prozess ausgelöst, mit dem das Dienstkonto gelöscht wird. Es sind keine weiteren Aktionen erforderlich.
Wenn Sie die Lösung mithilfe der Terraform-Befehlszeile bereitgestellt haben, führen Sie folgende Schritte aus:
1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf:
  
  Zur Seite „Dienstkonten“
2. Wählen Sie das Projekt aus, das Sie für die Lösung verwendet haben.
3. Wählen Sie das Dienstkonto aus, das Sie löschen möchten.
  
  Die E-Mail-ID des Dienstkontos, das für die Lösung erstellt wurde, hat das folgende Format:
```
goog-sc-DEPLOYMENT_NAME-NNN@PROJECT_ID.iam.gserviceaccount.com
```
  Die E-Mail-ID enthält die folgenden Werte:
  - DEPLOYMENT_NAME: Der Name der Bereitstellung.
  - NNN: Eine zufällige dreistellige Zahl.
  - PROJECT_ID: Die ID des Projekts, in dem Sie die Lösung bereitgestellt haben.
4. Klicken Sie auf Löschen.

Fehler beheben

Welche Aktionen Sie zur Diagnose und Behebung von Fehlern ausführen können, hängt von der Bereitstellungsmethode und der Komplexität des Fehlers ab.

Fehler bei der Bereitstellung über die Console

Wenn Sie die Console verwenden und die Bereitstellung fehlschlägt, gehen Sie so vor:

Rufen Sie die Seite Lösungsbereitstellungen auf.

Wenn die Bereitstellung fehlgeschlagen ist, wird im Feld Status der Eintrag Fehlgeschlagen angezeigt.
So rufen Sie die Details zu den Fehlern auf, die das Problem verursacht haben:
1. Klicken Sie auf Aktionen.
2. Wählen Sie Cloud Build-Logs ansehen aus.
Prüfen Sie das Cloud Build-Log und ergreifen Sie entsprechende Maßnahmen, um das Problem zu beheben.

Fehler bei der Bereitstellung mit der Terraform-Befehlszeile

Wenn die Bereitstellung bei Verwendung von Terraform fehlschlägt, enthält die Ausgabe des Befehls terraform apply Fehlermeldungen, die Sie prüfen können, um das Problem zu diagnostizieren.

Die Beispiele in den folgenden Abschnitten zeigen Bereitstellungsfehler, die bei der Verwendung von Terraform auftreten können.

Fehler beim Erstellen des Features: Ressource ist bereits vorhanden

Wenn Sie diese Lösung in einem Projekt bereitstellen, in dem Multi-Cluster-Ingress bereits konfiguriert ist, wird ein Fehler wie dieser angezeigt:

Error: Error creating Feature: Resource already exists - apply blocked by lifecycle params: &beta.Feature{Name:(*string)(0xc0017d1d00), Labels:map[string]string{}, ResourceState:(*beta.FeatureResourceState)(0xc001b9d890), Spec:(*beta.FeatureSpec)(0xc001792f00), State:(*beta.FeatureState)(0xc001792f50), CreateTime:(*string)(0xc001792fd0), UpdateTime:(*string)(0xc001792ff0), DeleteTime:(*string)(nil), Project:(*string)(0xc0017d1d40), Location:(*string)(0xc0017d1ca0)}.
running tf apply: terraform apply failed: running terraform failed: exit status 1

Das liegt daran, dass diese Lösung einen neuen GKE-Konfigurationscluster im ausgewählten Projekt bereitstellt. Ein Projekt (insbesondere die Flotte eines Projekts) kann nur einen einzigen Konfigurationscluster zum Konfigurieren von Multi-Cluster-Ingress enthalten. Zur Behebung dieses Problems entfernen Sie entweder den vorhandenen Konfigurationscluster für Multi-Cluster-Ingress oder beginnen in einem neuen Projekt von vorne.

Fehler: Job: default/kubernetes-manifests-deployer-job hat den Status „Fehlgeschlagen“

Das Terraform dieser Lösung stellt einen Kubernetes-Job mit dem Namen kubernetes-manifests-deployer-job bereit. Dieser Kubernetes-Job stellt die für diese Lösung erforderlichen Kubernetes-Ressourcen (Cymbal Shops-Mikrodienste, die Redis-Datenbank usw.) in allen drei Clustern bereit.

Da dieser Kubernetes-Job komplex ist und auf der Bereitschaft aller drei Cluster basiert, schlägt er gelegentlich mit einer Fehlermeldung wie dieser fehl:

kubernetes_job.kubernetes_manifests_deployer_job: Creation errored after 5m8s
...
Error: job: default/kubernetes-manifests-deployer-job is in failed state

Wenn Sie diesen Fehler erhalten, ist es wahrscheinlich, dass die Google Cloud-Infrastruktur der Lösung bereits teilweise oder vollständig bereitgestellt wurde, auch wenn die restliche Bereitstellung nicht erfolgreich abgeschlossen wurde. Wir empfehlen, das Projekt zu löschen, damit Ihnen keine Ressourcen in Rechnung gestellt werden, und die Bereitstellung in einem neuen, separaten Projekt noch einmal auszuführen.

Fehler „API nicht aktiviert“

Wenn Sie ein Projekt erstellen und dann sofort versuchen, die Lösung im neuen Projekt bereitzustellen, schlägt die Bereitstellung mit folgendem Fehler möglicherweise fehl:

Error: Error creating Network: googleapi: Error 403: Compute Engine API has not
been used in project PROJECT_ID before or it is disabled. Enable it by visiting
https://console.developers.google.com/apis/api/compute.googleapis.com/overview?project=PROJECT_ID
then retry. If you enabled this API recently, wait a few minutes for the action
to propagate to our systems and retry.

Wenn dieser Fehler auftritt, warten Sie einige Minuten und führen Sie dann den Befehl terraform apply noch einmal aus.

Fehler beim Löschen einer Bereitstellung

In bestimmten Fällen können Versuche, eine Bereitstellung zu löschen, fehlschlagen:

Wenn Sie nach dem Bereitstellen einer Lösung über die Console eine Ressource ändern, die von der Lösung bereitgestellt wurde, und Sie dann versuchen, die Bereitstellung zu löschen, schlägt der Vorgang möglicherweise fehl. Das Feld Status auf der Seite Lösungsbereitstellungen zeigt Fehlgeschlagen und das Cloud Build-Log zeigt die Fehlerursache an.
Wenn Sie nach dem Bereitstellen einer Lösung mit der Terraform-Befehlszeile eine Ressource über eine Nicht-Terraform-Schnittstelle ändern (z. B. die Console) und dann versuchen, die Bereitstellung zu löschen, schlägt der Vorgang möglicherweise fehl. Die Nachrichten in der Ausgabe des Befehls terraform destroy enthalten die Ursache des Fehlers.

Überprüfen Sie die Fehlerlogs und -meldungen, identifizieren und löschen Sie die Ressourcen, die den Fehler verursacht haben, und versuchen Sie dann noch einmal, die Bereitstellung zu löschen.

Wenn eine console-basierte Bereitstellung nicht gelöscht wird und Sie den Fehler nicht mit dem Cloud Build-Log diagnostizieren können, können Sie die Bereitstellung mit der Terraform-Befehlszeile löschen. Dies wird im nächsten Abschnitt beschrieben.

Console-basierte Bereitstellung mithilfe der Terraform-Befehlszeile löschen

In diesem Abschnitt wird beschrieben, wie Sie eine console-basierte Bereitstellung löschen, wenn Fehler beim Löschen aus der Console auftreten. Bei diesem Ansatz laden Sie die Terraform-Konfiguration für die Bereitstellung herunter, die Sie löschen möchten, und verwenden dann die Terraform-Befehlszeile, um die Bereitstellung zu löschen.

Ermitteln Sie die Region, in der der Terraform-Code, die Logs und andere Daten der Bereitstellung gespeichert sind. Diese Region kann sich von der Region unterscheiden, die Sie bei der Bereitstellung der Lösung ausgewählt haben.
1. Rufen Sie in der Google Cloud Console die Seite Lösungsbereitstellungen auf.
  
  Zu „Lösungsbereitstellungen“
2. Wählen Sie das Projekt aus, das die Bereitstellung enthält, die Sie löschen möchten.
3. Identifizieren Sie in der Liste der Bereitstellungen die Zeile für die Bereitstellung, die Sie löschen möchten.
4. Klicken Sie auf Gesamten Zeileninhalt ansehen.
5. Beachten Sie in der Spalte Standort den zweiten Standort, wie im folgenden Beispiel hervorgehoben:
In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Erstellen Sie Umgebungsvariablen für die Projekt-ID, die Region und den Namen der Bereitstellung, die Sie löschen möchten:
```
export REGION="REGION"
export PROJECT_ID="PROJECT_ID"
export DEPLOYMENT_NAME="DEPLOYMENT_NAME"
```
Ersetzen Sie in diesen Befehlen Folgendes:
- REGION: der Standort, den Sie zuvor in dieser Prozedur notiert haben.
- PROJECT_ID: die ID des Projekts, in dem Sie die Lösung bereitgestellt haben.
- DEPLOYMENT_NAME: der Name der Bereitstellung, die Sie löschen möchten.

Rufen Sie die ID der neuesten Überarbeitung der Bereitstellung ab, die Sie löschen möchten:

export REVISION_ID=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .latestRevision -r)
    echo $REVISION_ID

Die Ausgabe sieht in etwa so aus:

projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME/revisions/r-0

Rufen Sie den Cloud Storage-Speicherort der Terraform-Konfiguration für die Bereitstellung ab:

export CONTENT_PATH=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/${REVISION_ID}" \
    | jq .applyResults.content -r)
    echo $CONTENT_PATH

Im Folgenden finden Sie ein Beispiel für die Ausgabe dieses Befehls:

gs://PROJECT_ID-REGION-blueprint-config/DEPLOYMENT_NAME/r-0/apply_results/content

Laden Sie die Terraform-Konfiguration von Cloud Storage in Cloud Shell herunter:
```
gsutil cp -r $CONTENT_PATH $HOME
cd $HOME/content/infra
```
Warten Sie, bis die Meldung Operation completed angezeigt wird, wie im folgenden Beispiel gezeigt:
```
Operation completed over 45 objects/268.5 KiB
```
Initialisieren Sie Terraform:
```
terraform init
```
Warten Sie, bis folgende Meldung angezeigt wird:
```
Terraform has been successfully initialized!
```
Entfernen Sie die bereitgestellten Ressourcen:
```
terraform destroy
```
Terraform zeigt eine Liste der Ressourcen an, die gelöscht werden.

Wenn Warnungen zu nicht deklarierten Variablen angezeigt werden, ignorieren Sie die Warnungen.
Wenn Sie aufgefordert werden, die Aktionen auszuführen, geben Sie yes ein.

Terraform zeigt Nachrichten mit dem Fortschritt an. Nachdem alle Ressourcen gelöscht wurden, zeigt Terraform die folgende Meldung an:
```
Destroy complete!
```

Löschen Sie das Bereitstellungsartefakt:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}?force=true&delete_policy=abandon"

Warten Sie einige Sekunden und prüfen Sie dann, ob das Bereitstellungsartefakt gelöscht wurde:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .error.message

Wenn in der Ausgabe null angezeigt wird, warten Sie einige Sekunden und führen Sie den Befehl noch einmal aus.

Nachdem das Bereitstellungsartefakt gelöscht wurde, wird wie im folgenden Beispiel gezeigt eine Meldung angezeigt:

Resource 'projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME' was not found

Feedback geben

Schnellstartlösungen dienen nur zu Informationszwecken und sind keine offiziell unterstützten Produkte. Google kann Lösungen ohne Vorankündigung ändern oder entfernen.

Prüfen Sie zur Behebung von Fehlern die Cloud Build-Logs und die Terraform-Ausgabe.

So senden Sie Feedback:

Verwenden Sie für Dokumentation, Anleitungen in der Console oder die Lösung die Schaltfläche Feedback senden auf der Seite.

Erstellen Sie bei unverändertem Terraform-Code Fragen im GitHub-Repository. GitHub-Probleme werden auf Best-Effort-Basis geprüft und sind nicht für allgemeine Fragen zur Nutzung vorgesehen.

Bei Problemen mit Produkten, die in der Lösung verwendet werden, wenden Sie sich an den Cloud Customer Care.

Wir empfehlen außerdem, die Liste der (sowohl offenen als auch geschlossenen) Probleme im GitHub-Repository der Lösung zu prüfen.

Nächste Schritte

Wenn Sie noch nicht mit Containern und Kubernetes vertraut sind:
- Verwenden Sie diese Anleitung. Sie richtet sich an Anthos Service Mesh-Nutzer, ist jedoch hilfreich für alle, die wissen möchten, wie sie vom Quellcode zu einem Container in GKE wechseln können.
- Lesen Sie unseren Kubernetes-Comic.
- Besuchen Sie die Kubernetes-Dokumentationswebsite.
Weitere Informationen zu GKE
Weitere Informationen zu Autopilot
Weitere Informationen zu Multi-Cluster-Ingress