Kontinuierliche Bereitstellung aus Git mit Cloud Build

Sie können Cloud Build verwenden, um Builds und Bereitstellungen in Cloud Run zu automatisieren. Dabei nutzen Sie Cloud Build-Trigger, um Ihren Code automatisch zu erstellen und bereitzustellen, wann immer neue Commits an einen bestimmten Branch eines Git-Repositorys übertragen werden. Eine Beispielanleitung für das Erstellen eines Vorlagen-Repositorys und die kontinuierliche Bereitstellung aus Git finden Sie unter Kurzanleitung: Continuous Deployment.

Wenn Sie einen Cloud Build-Trigger zum Erstellen von Containern verwenden, werden die Informationen zum Quell-Repository in der Google Cloud Console für Ihren Dienst nach der Bereitstellung in Cloud Run angezeigt.

Hinweis

  • Sie haben entweder ein Git-Repository mit einem Dockerfile oder Ihre Codebasis wurde in einer der Sprachen geschrieben, die von den Buildpacks von Google Cloud unterstützt werden.
  • Cloud Build und Cloud Source Repositories APIs aktivieren.

    Aktivieren Sie die APIs

Kontinuierliche Bereitstellung über die Cloud Run-Benutzeroberfläche einrichten

Das Verfahren variiert geringfügig je nachdem, ob Sie die kontinuierliche Bereitstellung für einen neuen Dienst oder einen vorhandenen Dienst einrichten. Klicken Sie auf den entsprechenden Tab, um weitere Informationen zu erhalten.

Neuer Dienst

  1. Erstellen Sie einen neuen Dienst aus, wie unter Neuen Dienst bereitstellen beschrieben. Wählen Sie dabei auf der Seite Diensteinstellungen Neue Überarbeitungen aus dem Quell-Repository kontinuierlich bereitstellen aus.

  2. Klicken Sie auf der Seite Diensteinstellungen auf Mit Cloud Build einrichten.

  3. GitHub ist der Standard-Repository-Anbieter. Klicken Sie auf Authentifizieren, wenn Sie noch nicht authentifiziert sind, und folgen Sie der Anleitung. Das Verbinden eines Repositorys erfolgt über die GitHub-Anwendung von Cloud Build.

    Schritt 1 für die Einrichtung der kontinuierlichen Bereitstellung

  4. Klicken Sie auf Weiter.

  5. Füllen Sie die Optionen im Schritt „Build-Konfiguration“ aus:

    • Branch: Gibt an, welche Quelle beim Ausführen des Triggers verwendet werden soll. Sie können den Regex hier einfügen. Übereinstimmende Branches werden automatisch verifiziert und unter der Eingabe angezeigt. Stimmt genau ein Branch überein, wird der Trigger nach der Erstellung automatisch ausgeführt.
    • Build-Typ

      • Wenn Ihr Repository mithilfe von Docker erstellt werden soll und ein Dockerfile enthält, wählen Sie Dockerfile aus. Quellort gibt den Speicherort und den Namen des Dockerfile an. Dieses Verzeichnis wird als Docker-Build-Kontext verwendet. Alle Pfade sollten sich auf das aktuelle Verzeichnis beziehen.

      • Andernfalls wählen Sie Google Cloud Buildpacks aus. Geben Sie mit Buildpack-Kontext das Verzeichnis an und stellen Sie mit Einstiegspunkt (optional) den Befehl zum Starten des Servers bereit. Beispiel: gunicorn -p :8080 main:app für Python, java -jar target/myjar.jar für Java. Wenn Sie das Feld leer lassen, gilt das Standardverhalten.

    Schritt 2 für die Einrichtung der kontinuierlichen Bereitstellung

  6. Klicken Sie auf Speichern.

  7. Prüfen Sie die ausgewählten Einstellungen.

    Prüfung der Einrichtung der kontinuierlichen Bereitstellung

  8. Klicken Sie auf Erstellen.

  9. Beachten Sie, dass Sie zur Seite Dienstdetails weitergeleitet werden, auf der Sie den Fortschritt Ihrer Einrichtung der kontinuierlichen Bereitstellung verfolgen können.

  10. Beachten Sie, dass Sie folgende weitere Optionen auswählen können, sobald alle Schritte abgeschlossen sind:

Vorhandener Dienst

  1. Öffnen Sie Cloud Run.

  2. Suchen Sie den Dienst in der Liste der Dienste und klicken Sie darauf.

  3. Klicken Sie auf Kontinuierliche Bereitstellung einrichten.

  4. GitHub ist der Standard-Repository-Anbieter. Klicken Sie auf Authentifizieren, wenn Sie noch nicht authentifiziert sind, und folgen Sie der Anleitung. Das Verbinden eines Repositorys erfolgt über die GitHub-Anwendung von Cloud Build.

    Schritt 1 für die Einrichtung der kontinuierlichen Bereitstellung

  5. Klicken Sie auf Weiter.

  6. Füllen Sie die Optionen im Schritt „Build-Konfiguration“ aus:

    • Branch: Gibt an, welche Quelle beim Ausführen des Triggers verwendet werden soll. Sie können den Regex hier einfügen. Übereinstimmende Branches werden automatisch verifiziert und unter der Eingabe angezeigt. Stimmt genau ein Branch überein, wird der Trigger nach der Erstellung automatisch ausgeführt.
    • Build-Typ

      • Wenn Ihr Repository mithilfe von Docker erstellt werden soll und ein Dockerfile enthält, wählen Sie Dockerfile aus. Quellort gibt den Speicherort und den Namen des Dockerfile an. Dieses Verzeichnis wird als Docker-Build-Kontext verwendet. Alle Pfade sollten sich auf das aktuelle Verzeichnis beziehen.

      • Andernfalls wählen Sie Google Cloud Buildpacks aus. Geben Sie mit Buildpack-Kontext das Verzeichnis an und stellen Sie mit Einstiegspunkt (optional) den Befehl zum Starten des Servers bereit. Beispiel: gunicorn -p :8080 main:app für Python, java -jar target/myjar.jar für Java. Wenn Sie das Feld leer lassen, gilt das Standardverhalten.

    Schritt 2 für die Einrichtung der kontinuierlichen Bereitstellung

  7. Klicken Sie auf Speichern.

  8. Die Seite wird neu geladen und zeigt den Fortschritt der Einrichtung der kontinuierlichen Bereitstellung an.

  9. Beachten Sie, dass Sie folgende weitere Optionen auswählen können, sobald alle Schritte abgeschlossen sind:

Kontinuierliche Bereitstellung manuell einrichten

Unter Kontinuierliche Bereitstellung manuell einrichten finden Sie weitere Informationen, falls Sie ein manuelles Verfahren und nicht die Benutzeroberfläche verwenden müssen.

Vorhandenen Cloud Build-Trigger an den Cloud Run-Dienst anhängen

Wenn bereits ein Cloud Build-Trigger vorhanden ist, können Sie ihn an den Dienst anhängen und die Vorteile der Google Cloud Console-Features auf der Seite „Dienstdetails“ nutzen: die Schaltfläche Kontinuierliche Bereitstellung bearbeiten und den Build-Verlauf.

Dazu müssen Sie ein Label mit gcb-trigger-id als Schlüssel und der eindeutigen Kennzeichnung des Cloud Build-Triggers als Wert (nicht dem Triggernamen) hinzufügen. Hier finden Sie eine Anleitung zum Einrichten des Labels.