Anwendung mit Google Cloud Deploy in GKE bereitstellen
Auf dieser Seite erfahren Sie, wie Sie mit Google Cloud Deploy ein Beispielanwendungs-Image namens echoserver
an eine Sequenz aus zwei Google Kubernetes Engine-Clustern bereitstellen.
Dieser Schnellstart erläutert folgende Schritte:
Erstellen der beiden Cluster.
Erstellen Sie eine Skaffold-Konfiguration und ein Kubernetes-Manifest, um das (vordefinierte) Container-Image anzugeben.
Definieren Sie Ihre Google Cloud Deploy-Lieferpipeline und Bereitstellungsziele, die auf beide Cluster verweisen.
Instanziieren Sie Ihre Lieferpipeline. Dazu erstellen Sie einen Release, der automatisch für das erste Ziel bereitgestellt wird.
Erhöhen Sie den Release auf das zweite Ziel.
Sehen Sie sich beide Roll-outs in der Google Cloud Console an.
Hinweis
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit 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.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
-
Google Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
-
Google Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
- Prüfen Sie, ob das Compute Engine-Standarddienstkonto die erforderlichen Berechtigungen hat.
Das Dienstkonto hat möglicherweise bereits die erforderlichen Berechtigungen. Diese Schritte sind für Projekte erforderlich, die automatische Rollenzuweisungen für Standarddienstkonten deaktivieren.
- Fügen Sie die Rolle
clouddeploy.jobRunner
hinzu:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/clouddeploy.jobRunner"
- Fügen Sie die Kubernetes-Entwicklerberechtigungen hinzu:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/container.developer"
Wenn Sie Probleme beim Hinzufügen einer dieser Rollen haben, wenden Sie sich an Ihren Projektadministrator.
Google Kubernetes Engine-Cluster erstellen
Erstellen Sie zwei Cluster: qsdev
und qsprod
mit Standardeinstellungen. Die Kubernetes API-Endpunkte des Clusters müssen über das öffentliche Internet erreichbar sein.
GKE-Cluster sind standardmäßig extern zugänglich.
gcloud container clusters create-auto quickstart-cluster-qsdev --project=PROJECT_ID --region=us-central1 && gcloud container clusters create-auto quickstart-cluster-qsprod --project=PROJECT_ID --region=us-central1
Skaffold-Konfiguration und Kubernetes-Manifest vorbereiten
Google Cloud Deploy verwendet Skaffold, um die Details für die Bereitstellung und die korrekte Bereitstellung für Ihre separaten Ziele anzugeben.
In dieser Kurzanleitung erstellen Sie eine skaffold.yaml
-Datei, die das Kubernetes-Manifest angibt, das zum Bereitstellen der Beispielanwendung verwendet werden soll.
Öffnen Sie ein Terminalfenster.
Erstellen Sie ein neues Verzeichnis mit dem Namen
deploy-gke-quickstart
und rufen Sie dieses Verzeichnis auf.mkdir deploy-gke-quickstart cd deploy-gke-quickstart
Erstellen Sie eine Datei mit dem Namen
skaffold.yaml
und mit folgendem Inhalt:apiVersion: skaffold/v2beta16 kind: Config deploy: kubectl: manifests: - k8s-*
Diese Datei ist eine minimale Skaffold-Konfiguration, die dein Manifest identifiziert. In dieser Kurzanleitung erstellen Sie die Datei. Sie können aber auch Google Cloud Deploy für Sie erstellen, um einfache Nicht-Produktionsanwendungen zu erstellen.
Weitere Informationen zu dieser Datei finden Sie in der Referenz zu
skaffold.yaml
.Erstellen Sie eine Datei mit dem Namen
k8s-pod.yaml
und folgendem Inhalt:apiVersion: v1 kind: Pod metadata: name: getting-started spec: containers: - name: echoserver image: my-app-image
Diese Datei ist ein einfaches Kubernetes-Manifest, das auf den Cluster angewendet wird, um die Anwendung bereitzustellen.
Lieferpipeline und Ziele erstellen
Sie können Pipeline und Ziele in einer Datei oder in separaten Dateien definieren. In dieser Kurzanleitung erstellen Sie nur eine Datei.
Erstellen Sie im
deploy-gke-quickstart
-Verzeichnis die neue Dateiclouddeploy.yaml
mit folgendem Inhalt:apiVersion: deploy.cloud.google.com/v1 kind: DeliveryPipeline metadata: name: my-gke-demo-app-1 description: main application pipeline serialPipeline: stages: - targetId: qsdev profiles: [] - targetId: qsprod profiles: [] --- apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: qsdev description: development cluster gke: cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsdev --- apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: qsprod description: production cluster gke: cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod
Registrieren Sie Ihre Pipeline und Ziele beim Google Cloud Deploy-Dienst:
gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
Sie haben jetzt eine Pipeline mit Zielen und können Ihre Anwendung für das erste Ziel bereitstellen.
Bestätigen Sie Pipeline und Ziele:
Rufen Sie in der Google Cloud Console die Seite Bereitstellungspipelines für Google Cloud Deploy auf, um eine Liste der verfügbaren Bereitstellungspipelines aufzurufen.
Zur Seite der Lieferpipelines
Die soeben erstellte Lieferpipeline wird angezeigt und die beiden Ziele werden in der Spalte Ziele aufgeführt.
Release erstellen
Ein Release ist die zentrale Ressource von Google Cloud Deploy, die die bereitgestellten Änderungen darstellt. Die Bereitstellungspipeline definiert den Lebenszyklus dieses Release. Weitere Informationen zu diesem Lebenszyklus finden Sie unter Google Cloud Deploy-Dienstarchitektur.
Führen Sie folgenden Befehl im Verzeichnis deploy-gke-quickstart
aus, um eine release
-Ressource zu erstellen, die das bereitzustellende Container-Image darstellt:
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-gke-demo-app-1 \
--images=my-app-image=registry.k8s.io/echoserver:1.4
Da dieser Release der erste ist (er wird im ersten angegebenen Ziel bereitgestellt), erstellt Google Cloud Deploy automatisch auch eine rollout
-Ressource. Die Anwendung wird automatisch für das erste Ziel in der Sequenz bereitgestellt.
Release hochstufen
Klicken Sie auf der Seite Lieferpipelines auf die Pipeline
my-gke-demo-app-1
.Zur Seite der Lieferpipelines
Die Seite mit den Details der Lieferpipeline zeigt eine grafische Darstellung des Fortschritts der Lieferpipeline. In diesem Fall wird gezeigt, dass die Version am
qsdev
-Ziel bereitgestellt wurde.Klicken Sie für das erste Ziel in der Visualisierung der Lieferpipeline auf Hochstufen.
Das Dialogfeld Release hochstufen wird angezeigt. Er zeigt die Details des Ziels an, zu dem Sie hochstufen.
Klicken Sie auf Werben.
Der Release befindet sich jetzt in der Warteschlange für die Bereitstellung in
qsprod
. Wenn die Bereitstellung abgeschlossen ist, wird sie in der Visualisierung der Bereitstellungspipeline als bereitgestellt angezeigt:
Ergebnisse in der Google Cloud Console ansehen
Rufen Sie in der Google Cloud Console die Seite Bereitstellungspipelines für Google Cloud Deploy auf, um die Bereitstellungspipeline my-gke-demo-app-1 aufzurufen.
Zur Seite der Lieferpipelines
Klicken Sie auf den Namen Ihrer Bereitstellungspipeline „my-gke-demo-app-1“.
Die Pipelinevisualisierung zeigt den Fortschritt der Anwendung durch die Pipeline.
Ihre Version wird auf dem Tab Releases unter Details zur Lieferpipeline aufgeführt.
Klicken Sie auf den Releasenamen,
test-release-001
.Ihre Roll-outs werden unter Roll-outs angezeigt. Sie können auf ein Roll-out klicken, um die Details aufzurufen, einschließlich des Deployment-Logs.
Bereinigen
So vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:
Den
qsdev
-Cluster löschen:gcloud container clusters delete quickstart-cluster-qsdev --region=us-central1 --project=PROJECT_ID
Den
qsprod
-Cluster löschen:gcloud container clusters delete quickstart-cluster-qsprod --region=us-central1 --project=PROJECT_ID
Löschen Sie die Bereitstellungspipeline, Ziele, Releases und Roll-outs:
gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
Löschen Sie die von Google Cloud Deploy erstellten Cloud Storage-Buckets.
Eines davon endet mit
_clouddeploy
und das andere[region].deploy-artifacts.[project].appspot.com
.Die Cloud Storage-Browserseite öffnen
Das war alles. Sie haben diesen Schnellstart abgeschlossen!