Mit Cloud Build in Cloud Run bereitstellen

Auf dieser Seite wird erläutert, wie Cloud Run-Dienste mithilfe von Cloud Build automatisch bereitgestellt werden. Wenn Sie Cloud Build noch nicht kennen, lesen Sie zuerst die Kurzanleitungen und die Übersicht über die Build-Konfiguration.

Mit Cloud Run können Sie zustandslose Container in einer serverlosen Umgebung ausführen. Mit Cloud Build können Sie Container-Images von Container Registry (verworfen) und Artifact Registry zu Cloud Run Sie können ein vorhandenes Image bereitstellen, ein Image erstellen und bereitstellen oder die Bereitstellung automatisieren.

Hinweis: Sie können mit Cloud Deploy auch eine Continuous Delivery einrichten. für die Bereitstellung in Cloud Run. Weitere Informationen.

Hinweise

• Enable the Cloud Build, Cloud Run, Container Registry, and Resource Manager APIs.

  Enable the APIs

• Halten Sie den Quellcode Ihrer Anwendung bereit. Ihr Quellcode muss in einem Repository gespeichert sein, z. B. Cloud Source Repositories, GitHub oder Bitbucket.

• Zum Ausführen der gcloud-Befehle auf dieser Seite müssen Sie die Google Cloud CLI installieren.

• Wenn Sie VPC Service Controls verwenden, richten Sie einen privaten Pool im VPC Service Controls-Perimeter Sie müssen außerdem konfigurieren Cloud Run for VPC Service Controls

Wichtig: Container Registry wurde verworfen und wird demnächst eingestellt. In Organisationen, die Container Registry vor dem 8. Januar 2024 nicht verwendet haben, werden neue gcr.io-Repositories standardmäßig in Artifact Registry gehostet. Ab dem 15. Mai 2024 unterstützen Google Cloud-Projekte ohne vorherige Verwendung von Container Registry nur das Hosting und die Verwaltung von Images für die Domain gcr.io in Artifact Registry.

Container Registry soll am 18. März 2025 eingestellt werden. Weitere Informationen zur Einstellung finden Sie unter Einstellung von Container Registry.

Achtung: Seit dem 17. Juni 2024 ist Cloud Source Repositories für Neukunden nicht mehr verfügbar. Wenn Ihre Organisation noch nicht Cloud Source Repositories verwendet hat, können Sie die API nicht aktivieren oder Cloud Source Repositories verwenden. Für neue Projekte, die nicht mit einer Organisation verbunden sind, kann die Cloud Source Repositories API nicht aktiviert werden. Organisationen, die bereits Cloud Source Repositories verwendet haben 17. Juni 2024 sind von dieser Änderung nicht betroffen.

Erforderliche IAM-Berechtigungen

Wenn Ihr Image im selben Google Cloud-Projekt gespeichert ist, in dem Sie es bereitstellen möchten, oder wenn Ihr Image in Container Registry öffentlich ist, benötigen Sie die folgenden IAM-Berechtigungen:

Weisen Sie zum Bereitstellen in Cloud Run den Cloud Run-Administrator und Dienstkontonutzer-Rollen für das Dienstkonto, das Sie für den Build verwenden:

1. Öffnen Sie die Seite mit den Cloud Build-Einstellungen in der Google Cloud Console:

   Zur Seite „Cloud Build-Einstellungen“

2. Wählen Sie in der Drop-down-Liste das Dienstkonto aus, dessen Rollen Sie ändern möchten.

   

3. Legen Sie im Bereich "Dienstkontoberechtigungen" den Status der Rolle Cloud Run-Administrator auf AKTIVIERT fest:

4. Klicken Sie im zusätzlichen Pop-up-Fenster "Zusätzliche Schritte" auf Zugriff auf alle Dienstkonten gewähren.

Hinweis: Weisen Sie dem Nutzer die Rolle Dienstkontonutzer zu, um die Sicherheit zu erhöhen. nur das Cloud Run-Laufzeitdienstkonto. Eine Anleitung dazu finden Sie unter Minimale IAM-Berechtigungen verwenden.

Container erstellen und bereitstellen

Mit Cloud Build können Sie das Container-Image erstellen, das erstellte Image in Container Registry speichern und es anschließend für Cloud Run bereitstellen.

So erstellen Sie ein Container-Image und stellen es anschließend bereit:

1. Erstellen Sie im Stammverzeichnis des Projekts eine Konfigurationsdatei mit dem Namen cloudbuild.yaml.

2. Fügen Sie in der Build-Konfigurationsdatei docker Build-Schritte hinzu, um das Image zu erstellen und an Container Registry zu übertragen. Fügen Sie dann den Build-Schritt gcloud hinzu, um den Befehl gcloud run deploy aufzurufen und das Image in Cloud Run bereitzustellen:

   steps:
   # Build the container image
   - name: 'gcr.io/cloud-builders/docker'
     args: ['build', '-t', 'gcr.io/PROJECT_ID/IMAGE', '.']
   # Push the container image to Container Registry
   - name: 'gcr.io/cloud-builders/docker'
     args: ['push', 'gcr.io/PROJECT_ID/IMAGE']
   # Deploy container image to Cloud Run
   - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
     entrypoint: gcloud
     args: ['run', 'deploy', 'SERVICE_NAME', '--image', 'gcr.io/PROJECT_ID/IMAGE', '--region', 'SERVICE_REGION']
   images:
   - gcr.io/PROJECT_ID/IMAGE
   

   Wobei:

   • SERVICE_NAME ist der Name des Cloud Run-Dienstes.
   • SERVICE_REGION ist die Region des Cloud Run-Dienstes, den Sie bereitstellen.
   • PROJECT_ID ist die Google Cloud-Projekt-ID, unter der Ihr Image gespeichert ist.
   • IMAGE ist der Name des Images in Container Registry.

3. Rufen Sie das Stammverzeichnis Ihres Projekts auf und führen Sie den folgenden Befehl aus. BUILD_REGION ist eine der unterstützten Build-Regionen. um den Build auszuführen:

    gcloud builds submit --region=BUILD_REGION
   

Nach erfolgreichem Abschluss wird eine Nachricht zusammen mit der URL des bereitgestellten Dienstes angezeigt.

Kontinuierliche Bereitstellung

Sie können die Bereitstellung Ihrer Software in Cloud Run automatisieren, indem Sie Erstellen von Cloud Build-Triggern. Sie können die Trigger so konfigurieren, dass Images immer dann erstellt und bereitgestellt werden, wenn Sie den Quellcode aktualisieren.

So automatisieren Sie die Bereitstellung:

1. Fügen Sie im Repository-Stammverzeichnis eine Konfigurationsdatei namens cloudbuild.yaml mit Schritten hinzu Um das Image zu erstellen, laden Sie es in Container Registry hoch. Rufen Sie den Befehl gcloud run deploy auf:

     steps:
     # Build the container image
     - name: 'gcr.io/cloud-builders/docker'
       args: ['build', '-t', 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA', '.']
     # Push the container image to Container Registry
     - name: 'gcr.io/cloud-builders/docker'
       args: ['push', 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA']
     # Deploy container image to Cloud Run
     - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
       entrypoint: gcloud
       args:
       - 'run'
       - 'deploy'
       - 'SERVICE_NAME'
       - '--image'
       - 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA'
       - '--region'
       - 'SERVICE_REGION'
     images:
     - 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA'
   

   Wobei:

   • SERVICE_NAME ist der Name des Cloud Run-Dienstes.
   • SERVICE_REGION ist die Region des Cloud Run-Dienstes, den Sie bereitstellen.

   Die Substitutionsvariable $COMMIT_SHA wird von Cloud Build ersetzt, wenn sie von einem Git-Repository ausgelöst wird.

2. Erstellen Sie einen Build-Trigger mit der im vorherigen Schritt erstellten Konfigurationsdatei Schritt:

   1. Seite "Trigger" aufrufen

      Zur Seite "Trigger"

   2. Klicken Sie auf Trigger erstellen.

   3. Geben Sie im Feld Name einen Namen für den Trigger ein.

   4. Wählen Sie unter Region die Region für den Trigger aus.

      Hinweis: Die Region für Ihren Trigger muss mit der Region übereinstimmen. des Cloud Run-Dienstes, in dem die Bereitstellung erfolgt.

   5. Wählen Sie unter Ereignis das Repository-Ereignis aus, um den Trigger zu starten.

   6. Wählen Sie unter Quelle Ihr Repository und den Branch- oder Tag-Namen aus, der den Trigger auslöst. Weitere Informationen zum Angeben, welche Branches automatisch erstellt werden sollen, finden Sie unter Build-Trigger erstellen.

   7. Wählen Sie unter Konfiguration die Cloud Build-Konfigurationsdatei (YAML oder JSON) aus.

   8. Geben Sie im Feld Speicherort der Cloud Build-Konfigurationsdatei cloudbuild.yaml nach / ein.

   9. Klicken Sie auf Erstellen, um den Build-Trigger zu speichern.

3. Fertig! Von nun an werden bei jeder Übertragung in Ihr Repository automatisch ein Build und eine Bereitstellung für Ihren Dienst ausgelöst.

Hinweis: Zum Veröffentlichen des bereitgestellten Dienstes nehmen Sie eine einmalige Änderung an den IAM-Einstellungen des Dienstes vor.

Jedes Mal, wenn Sie neuen Code in Ihr Repository übertragen, lösen Sie automatisch einen Build aus und stellen diesen in Ihrem Cloud Run-Dienst bereit.

Weitere Informationen zum Erstellen von Cloud Build-Triggern finden Sie unter Build-Trigger erstellen und verwalten.

Minimale IAM-Berechtigungen verwenden

Wenn ein Container in einem Cloud Run-Dienst bereitgestellt wird, wird er mit der Identität des Laufzeitdienstkontos dieses Cloud Run-Dienstes ausgeführt. Da Cloud Build neue Container automatisch bereitstellen kann, muss Cloud Build als Laufzeitdienstkonto Ihres Cloud Run-Dienstes fungieren können.

So gewähren Sie Cloud Build eingeschränkten Zugriff für die Bereitstellung in einem Cloud Run-Dienst:

Console

1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf:

   Zur Seite „Dienstkonten“

2. Klicken Sie auf die E-Mail-Adresse des Laufzeitdienstkonto (standardmäßig ist es [e-mail].

3. Klicken Sie auf den Tab Berechtigungen.

4. Klicken Sie auf Zugriff erlauben.

5. Geben Sie das Cloud Build-Dienstkonto ein ([e-mail]).

6. Wählen Sie im Drop-down-Menü Rolle auswählen die Rolle Dienstkonten > Dienstkontonutzer aus.

7. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud iam service-accounts add-iam-policy-binding, wobei PROJECT_NUMBER die numerische ID Ihres Projekts ist:

gcloud iam service-accounts add-iam-policy-binding \
  [e-mail] \
  --member="serviceAccount:[e-mail]" \
  --role="roles/iam.serviceAccountUser"

Ersetzen Sie PROJECT_NUMBER durch die numerische ID Ihres Projekts.

Wenn Sie Cloud Run mit einer benutzerdefinierten Dienstidentität verwenden, ersetzen Sie [e-mail] durch die Adresse Ihres Dienstkontos.

Weitere Informationen finden Sie unter Bereitstellungsberechtigungen.

Codebeispiele

Im Folgenden finden Sie einige Beispiel-Repositories, die jeweils eine Beispielanwendung und eine Build-Konfigurationsdatei zum Erstellen der Anwendung in Cloud Run enthalten:

• deploy-prebuilt: ein Codebeispiel, das zeigt, wie ein vordefiniertes Image in Cloud Run bereitgestellt wird.
• run-example-builddeploy: ein Codebeispiel, das zeigt, wie ein Image in Cloud Run erstellt und bereitgestellt wird

Nächste Schritte

• Weitere Informationen zum Bereitstellen in Cloud Run mit Cloud Deploy
• Mehr zum Bereitstellen in GKE.
• Mehr zum Bereitstellen in Cloud Run-Funktionen
• Mehr zum Bereitstellen in App Engine.
• Mehr zum Bereitstellen in Firebase.
• Blau/Grün-Bereitstellungen in Compute Engine ausführen
• Build-Fehler beheben