Kurzanleitung: Anwendung 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:

1. Erstellen der beiden Cluster.

2. Erstellen Sie eine Skaffold-Konfiguration und ein Kubernetes-Manifest, um das (vordefinierte) Container-Image anzugeben.

3. Definieren Sie Ihre Google Cloud Deploy-Lieferpipeline und Bereitstellungsziele, die auf beide Cluster verweisen.

   Sie können Ihre Ziele in derselben Datei wie die Lieferpipeline oder in einer anderen Datei bzw. Dateien definieren. Der Einfachheit halber werden Sie meist in derselben Datei gespeichert.

4. Instanziieren Sie Ihre Lieferpipeline. Dazu erstellen Sie einen Release, der automatisch für das erste Ziel bereitgestellt wird.

5. Stufen Sie das Release zum zweiten Ziel hoch.

6. Lassen Sie beide Rollouts in der Cloud Console anzeigen.

Hinweis

1. 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.

2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

4. Google Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs aktivieren.

   Aktivieren Sie die APIs

5. Installieren und initialisieren Sie Google Cloud CLI.
   Hinweis: Sie können die gcloud CLI in der Cloud Console ausführen, ohne die Google Cloud CLI zu installieren. Verwenden Sie Cloud Shell, um die gcloud CLI in der Cloud Console auszuführen.

6. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

7. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

8. Google Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs aktivieren.

   Aktivieren Sie die APIs

9. Installieren und initialisieren Sie Google Cloud CLI.
   Hinweis: Sie können die gcloud CLI in der Cloud Console ausführen, ohne die Google Cloud CLI zu installieren. Verwenden Sie Cloud Shell, um die gcloud CLI in der Cloud Console auszuführen.
10. Prüfen Sie, ob das Compute Engine-Standarddienstkonto über ausreichende Berechtigungen verfügt.

    Das Dienstkonto hat möglicherweise bereits die erforderlichen Berechtigungen. Diese Schritte sind für Projekte enthalten, die automatische Rollenzuweisungen für Standarddienstkonten deaktivieren.

    1. Die clouddeploy.jobRunner-Rolle hinzufügen:

       gcloud projects add-iam-policy-binding PROJECT_ID \
           --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
           --format="value(projectNumber)")[e-mail] \
           --role="roles/clouddeploy.jobRunner"
       

    2. 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)")[e-mail] \
           --role="roles/container.developer"
       

       Wenn Sie Probleme beim Hinzufügen einer dieser Rollen haben, wenden Sie sich an Ihren Projektadministrator.

11. Prüfen Sie, ob Sie die neueste Version des gcloud-Befehlszeilentools verwenden, 369.0 oder höher:

    gcloud components update

Google Kubernetes Engine-Cluster erstellen

Sie erstellen zwei Cluster: qsdev und qsprod, mit Standardeinstellungen. Die Kubernetes API-Endpunkte der Cluster müssen über das öffentliche Internet erreichbar sein. GKE-Cluster sind standardmäßig extern zugänglich.

1. Erstellen Sie den qsdev-Cluster:

   gcloud container clusters create quickstart-cluster-qsdev --project=PROJECT_ID --region=us-central1
   

2. Erstellen Sie den qsprod-Cluster:

   gcloud container clusters create quickstart-cluster-qsprod --project=PROJECT_ID --region=us-central1
   

Skaffold-Konfiguration und Kubernetes-Manifest vorbereiten

Google Cloud Deploy verwendet Skaffold, um Details zu den bereitzustellenden Elementen und deren korrekte Bereitstellung für separate Ziele anzugeben.

In dieser Kurzanleitung erstellen Sie eine skaffold.yaml-Datei, die das Kubernetes-Manifest angibt, das zur Bereitstellung der Beispielanwendung verwendet werden soll.

1. Öffnen Sie ein Terminalfenster.

2. Erstellen Sie ein neues Verzeichnis mit dem Namen deploy-quickstart und rufen Sie dieses Verzeichnis auf.

   mkdir deploy-quickstart
   cd deploy-quickstart
   

3. Erstellen Sie eine Datei mit dem Namen skaffold.yaml und folgendem Inhalt:

   apiVersion: skaffold/v2beta16
   kind: Config
   deploy:
     kubectl:
       manifests:
         - k8s-*
   

4. 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
   

Hinweis: Wenn Sie pro Ziel verschiedene Manifeste verwenden möchten, lesen Sie diesen Artikel zum Verwalten von Manifesten, um mehr über die Verwendung von Skaffold-Profilen zu erfahren.

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.

1. Erstellen Sie im deploy-quickstart-Verzeichnis die neue Datei clouddeploy.yaml mit folgendem Inhalt:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
    name: my-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
   

   Hinweis: In dieser Datei sind Ziele in der Lieferpipeline enthalten. Sie können Ziele auch in einer separaten Datei oder mehreren separaten Dateien definieren.

2. Registrieren Sie Ihre Pipeline 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.

3. Bestätigen Sie Pipeline und Ziele:

   Rufen Sie in der Cloud Console die Seite Lieferpipelines von Google Cloud auf, um eine Liste der verfügbaren Lieferpipelines 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 Google Cloud-Bereitstellungsressource, die die bereitgestellten Änderungen darstellt. Die Lieferpipeline definiert den Lebenszyklus des Releases. Weitere Informationen zu diesem Lebenszyklus finden Sie unter Google Cloud Deploy-Dienstarchitektur.

Führen Sie folgenden Befehl im Verzeichnis deploy-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-demo-app-1 \
  --images=my-app-image=k8s.gcr.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

Hinweis: Nachdem Sie den Release erstellt haben, müssen Sie möglicherweise einige Minuten warten, bevor Sie mit diesem Schritt fortfahren können.

1. Klicken Sie auf der Seite Lieferpipelines auf die Pipeline my-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.

   

2. Klicken Sie für das erste Ziel in der Visualisierung der Lieferpipeline auf Hochstufen.

   Das Dialogfeld Release hochstufen wird angezeigt. Es enthält die Details des Ziels, zu dem Sie hochstufen.

3. Klicken Sie auf Hochstufen.

   Der Release wird jetzt für die Bereitstellung in qsprod in die Warteschlange gestellt. Sobald die Bereitstellung abgeschlossen ist, wird sie in der Visualisierung der Lieferpipeline als bereitgestellt angezeigt:

   

Ergebnisse in der Cloud Console ansehen

1. Rufen Sie in der Cloud Console die Google Cloud Deploy-Seite für Lieferpipelines auf, um Ihre Pipeline, my-demo-app-1, anzuzeigen.

   Zur Seite der Lieferpipelines

2. Klicken Sie auf den Namen der Lieferpipeline "my-demo-app-1".

   Die Pipeline-Visualisierung zeigt den Fortschritt der Anwendung durch die Pipeline.

   

   Ihre Version wird auf dem Tab Releases unter Details zur Lieferpipeline aufgeführt.

3. Klicken Sie auf den Releasenamen, test-release-001.

   Ihre Rollouts werden unter Rollouts angezeigt. Sie können auf ein Rollout klicken, um die Details aufzurufen, darunter das Deployment-Log.

   

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

1. Den qsdev-Cluster löschen:

   gcloud container clusters delete quickstart-cluster-qsdev --region=us-central1 --project=PROJECT_ID
   

2. Den qsprod-Cluster löschen:

   gcloud container clusters delete quickstart-cluster-qsprod --region=us-central1 --project=PROJECT_ID
   

3. Löschen Sie die Lieferpipeline:

   gcloud deploy delivery-pipelines delete my-demo-app-1 --force --region=us-central1 --project=PROJECT_ID
   

   Dieser Befehl löscht die Lieferpipeline selbst sowie alle release- und rollout-Ressourcen, die Google Cloud Deploy für diese Pipeline erstellt hat.

4. Löschen Sie die Cloud Storage-Buckets, die Google Cloud Deploy erstellt hat.

   Eine endet mit _clouddeploy, die andere ist [region].deploy-artifacts.[project].appspot.com.

   Die Cloud Storage-Browserseite öffnen

Das war alles. Sie haben diesen Schnellstart abgeschlossen!

Nächste Schritte

• Weitere Informationen zu Google Cloud Deploy

• Grundlagen der Bereitstellung von Anwendungen

• Anleitung für Google Cloud Deploy

• Manifeste verwalten