Pipeline und Release in der Google Cloud Console erstellen

Auf dieser Seite wird beschrieben, wie Sie mit der Google Cloud Console eine Cloud Deploy-Bereitstellungspipeline erstellen und dann einen Release für diese Pipeline erstellen.

Dieser Schnellstart erläutert folgende Schritte:

  1. Erstellen Sie zwei GKE-Cluster oder konfigurieren Sie zwei Cloud Run-Dienste.

  2. Erstellen Sie mit derGoogle Cloud Console eine Bereitstellungspipeline und zwei Ziele.

  3. Instanziieren Sie Ihre Bereitstellungspipeline, indem Sie mit der Google Cloud Console einen Release erstellen.

    Nachdem Sie diesen Release erstellt haben, wird die Anwendung automatisch im Ziel bereitgestellt.

  4. Sehen Sie sich die Ergebnisse in der Google Cloud Console an.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie einfach 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. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage 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

  5. Installieren Sie die Google Cloud CLI.

  6. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  7. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init
  8. 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.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

  10. Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage 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

  11. Installieren Sie die Google Cloud CLI.

  12. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  13. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init
  14. Wenn Sie die CLI bereits installiert haben, prüfen Sie, ob Sie die neueste Version verwenden:

    gcloud components update
    

Laufzeitumgebung erstellen

Wenn Sie in Cloud Run bereitstellen, können Sie diesen Befehl überspringen.

Erstellen Sie für GKE zwei Cluster: quickstart-cluster-for-console-staging und quickstart-cluster-for-console-prod mit den Standardeinstellungen. Die Kubernetes API-Endpunkte der Cluster müssen über das öffentliche Internet erreichbar sein. Auf GKE-Cluster kann standardmäßig extern zugegriffen werden.

gcloud container clusters create-auto quickstart-cluster-for-console-staging \
                 --project=PROJECT_ID \
                 --region=us-central1 && \
gcloud container clusters create-auto quickstart-cluster-for-console-prod \
                 --project=PROJECT_ID \
                 --region=us-central1

Bereitstellungspipeline und zwei Ziele erstellen

Mit Cloud Deploy können Sie eine Bereitstellungspipeline und Ziele basierend auf der Konfiguration erstellen, die in einer oder mehreren YAML-Dateien angegeben ist. Sie können aber auch eine Bereitstellungspipeline mit der Google Cloud Console erstellen.

In diesem Abschnitt verwenden Sie die Google Cloud Console, um eine Bereitstellungspipeline und zwei Ziele zu erstellen. Wenn Sie die Google Cloud Console verwenden, müssen Sie keine YAML-Dateien erstellen. Cloud Deploy erstellt die Datei „ skaffold.yaml “ und das Manifest für Sie.

  1. Rufen Sie in der Google Cloud Console die Cloud Deploy Hauptseite auf.

    Zur Seite der Lieferpipelines

  2. Klicken Sie auf Erstellen.

    Cloud Deploy-Hauptseite in der Google Cloud -Konsole

    Das Formular Bereitstellungspipeline erstellen wird angezeigt.

  3. Ersetzen Sie im Feld Pipelinename den Standardtext durch in-console-quickstart-pipeline.

  4. Geben Sie optional eine Beschreibung für diese Bereitstellungspipeline ein.

  5. Wählen Sie im Drop-down-Menü Region die Option us-central1 aus.

  6. Wählen Sie Ihre Laufzeit aus.

    Wenn Sie in GKE bereitstellen, wählen Sie Google Kubernetes Engine aus. Wählen Sie andernfalls Cloud Run aus.

  7. Erstellen Sie Ihre Ziele:

    GKE

    1. Ersetzen Sie unter Neues Ziel im Feld Zielname den Standardtext durch console-staging.

    2. Wählen Sie im Drop-down-Menü Kubernetes Engine-Cluster die Option quickstart-cluster-for-console-staging aus.

    3. Klicken Sie auf Fertig.

    4. Klicken Sie auf Ziel hinzufügen.

      Ersetzen Sie den Standardtext für Zielname durch console-prod.

    5. Wählen Sie im Drop-down-Menü Kubernetes Engine-Cluster die Option quickstart-cluster-for-console-prod aus.

    6. Wählen Sie Genehmigung für Roll-outs anfordern aus.

      In diesem Schnellstart ist eine Genehmigung für das zweite Ziel, aber nicht für das erste Ziel erforderlich.

    7. Klicken Sie auf Erstellen , um diese Bereitstellungspipeline zu erstellen.

      Cloud Deploy-Hauptseite in der Google Cloud Console

    Cloud Run

    1. Ersetzen Sie unter Neues Ziel im Feld Zielname den Standardtext durch console-staging.

    2. Wählen Sie im Drop-down-Menü Region die Option us-central1 aus.

    3. Klicken Sie auf Fertig.

    4. Klicken Sie auf Ziel hinzufügen.

    5. Ersetzen Sie den Standardtext für Zielname durch console-prod.

    6. Aktivieren Sie für dieses Ziel das Kästchen Genehmigung für Roll-outs anfordern.

      In diesem Schnellstart ist eine Genehmigung für das zweite Ziel, aber nicht für das erste Ziel erforderlich.

    7. Klicken Sie auf Erstellen , um diese Bereitstellungspipeline zu erstellen.

      Cloud Deploy-Hauptseite in der Google Cloud Console

    Sie haben jetzt eine Bereitstellungspipeline mit zwei Zielen und können einen Release erstellen.
    Die Seite der Pipeline wird angezeigt und enthält beide Ziele, aber keine Roll-outs.

    Neue Lieferpipeline, die in der Google Cloud Console erstellt wurde

Release erstellen

Nachdem Sie eine Bereitstellungspipeline mit zwei Zielen erstellt haben, die auf zwei GKE-Cluster oder zwei Cloud Run-Dienste verweisen, können Sie einen Release erstellen, um Ihre Anwendung im ersten Ziel bereitzustellen.

  1. Wenn Sie sich noch nicht auf der Seite der Bereitstellungspipeline befinden, auf der die neue Bereitstellungspipeline in-console-quickstart-pipeline angezeigt wird, rufen Sie sie jetzt auf.

    Die Pipelinevisualisierung wird ohne Roll-outs angezeigt.

  2. Klicken Sie auf die Schaltfläche Release erstellen.

    Das Dialogfeld Release erstellen wird angezeigt. Die meisten Felder sind bereits ausgefüllt. Übernehmen Sie diese Standardwerte.

    Dialogfeld „Release erstellen“

    Sie können auf die Schaltfläche Manifest ansehen klicken, um das automatisch generierte Manifest für das jeweilige Ziel anzusehen. Außerdem können Sie auf Skaffold-Datei ansehen klicken, um die generierte Datei skaffold.yaml anzusehen. Sie können die Dateien auch bearbeiten, aber für diesen Schnellstart sollten Sie sie unverändert lassen.

  3. Optional können Sie im Feld Beschreibung eine Beschreibung für diesen Release hinzufügen.

  4. Klicken Sie auf Erstellen , um den Release zu starten.

    Die Detailseite des Roll-outs wird für den Roll-out zum ersten Ziel angezeigt. Sie können den Fortschritt dieses Roll-outs beobachten. Das dauert einige Minuten. Es kann einige Sekunden dauern, bis der Roll-out gestartet wird.

  5. Klicken Sie nach Abschluss des ersten Roll-outs auf den Namen der Bereitstellungspipeline, um zur Seite der Bereitstellungspipeline zu gelangen.

    Klicken Sie auf den Namen der Pipeline, um die Visualisierung aufzurufen.

    Die Pipelinevisualisierung wird angezeigt. Der Roll-out zum ersten Ziel ist abgeschlossen.

    Visualisierung der Lieferpipeline mit abgeschlossenem ersten Ziel

  6. Klicken Sie auf Hochstufen , um den Roll-out zum nächsten Ziel zu starten.

    Das Dialogfeld Hochstufen wird angezeigt.

  7. Übernehmen Sie die Standardwerte, fügen Sie optional eine Roll-out-Beschreibung hinzu und klicken Sie dann auf Hochstufen.

    Da wir beim Erstellen des zweiten Ziels die Option Genehmigung für Roll-outs anfordern ausgewählt haben, muss diese Hochstufung genehmigt werden.

  8. Klicken Sie in der Visualisierung der Bereitstellungspipeline auf Überprüfen.

    Die Genehmigungsseite wird angezeigt.

    Genehmigung für Hochstufung zum zweiten Ziel erforderlich

  9. Klicken Sie noch einmal auf Überprüfen und dann im Genehmigungsdialogfeld auf Genehmigen.

    Der Roll-out für das zweite Ziel wird gestartet. Sie können noch einmal auf den Namen der Bereitstellungspipeline klicken, um den Fortschritt in der Pipelinevisualisierung zu beobachten.

Nach Abschluss des zweiten Roll-outs wird die Anwendung im zweiten Ziel bereitgestellt und die Bereitstellungspipeline ist abgeschlossen.

Abgeschlossene Bereitstellungspipeline.

Bereinigen

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

  1. Löschen Sie die GKE-Cluster oder Cloud Run-Dienste:

    GKE

    gcloud container clusters delete quickstart-cluster-for-console-staging --region=us-central1 --project=PROJECT_ID \
    && gcloud container clusters delete quickstart-cluster-for-console-prod --region=us-central1 --project=PROJECT_ID
    

    Cloud Run

    gcloud run services delete in-console-quickstart-pipeline-target-1 --region=us-central1 --project=PROJECT_ID \
    && gcloud run services delete in-console-quickstart-pipeline-target-2 --region=us-central1 --project=PROJECT_ID
    
  2. Klicken Sie auf der Seite der Bereitstellungspipeline auf Löschen , um die Bereitstellungspipeline, den Release und die Roll-outs zu löschen.

    Geben Sie den Namen der Pipeline in das Feld ein und klicken Sie auf Bestätigen, um das Löschen der Ressourcen abzuschließen.

    Bestätigungsdialogfeld zum Löschen von Pipeline und untergeordneten Ressourcen. target

  3. Löschen Sie beide Ziele:

    gcloud deploy targets delete console-staging --region=us-central1  && \
    gcloud deploy targets delete console-prod --region=us-central1
    
  4. Löschen Sie die Cloud Storage-Buckets, die von Cloud Deploy erstellt wurden.

    Einer endet mit _clouddeploy und der andere ist [region].deploy-artifacts.[project].appspot.com.

    Die Cloud Storage-Browserseite öffnen

Das war alles. Sie haben diesen Schnellstart abgeschlossen!

Nächste Schritte