Container-Images für Cloud Run-Dienste bereitstellen

Console

So stellen Sie ein Container-Image bereit:

1. Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:

   Zu Cloud Run

2. Klicken Sie auf Container bereitstellen, um das Formular Dienst erstellen aufzurufen.

3. Wählen Sie im Formular die Bereitstellungsoption aus.

   1. Wenn Sie einen Container manuell bereitstellen möchten, wählen Sie Eine Überarbeitung aus dem vorhandenen Container-Image bereitstellen aus und geben Sie das Container-Image an.

   2. Wenn Sie die kontinuierliche Bereitstellung automatisieren möchten, wählen Sie Kontinuierlich neue Überarbeitungen aus einem Quell-Repository bereitstellen aus und folgen Sie der Anleitung für kontinuierliche Bereitstellungen.

4. Geben Sie einen Dienstnamen ein. Dienstnamen dürfen maximal 49 Zeichen lang sein und pro Region und Projekt nur einmal vorkommen. Ein Dienstname kann später nicht mehr geändert werden und ist öffentlich sichtbar.

5. Verwenden Sie im Feld Region Wählen Sie die Region aus,in der sich Ihr Dienst befinden soll.

   Die Regionsauswahl gibt die Preisstufe, die Verfügbarkeit von Domainzuordnungen an und hebt Regionen mit den niedrigsten CO2-Auswirkungen hervor.

6. Konfigurieren Sie unter Authentifizierung Folgendes:

   • Wenn Sie eine öffentliche API oder Website erstellen, wählen Sie Öffentlichen Zugriff zulassen aus. Durch Anklicken des Kästchens wird der Sonderkennzeichnung allUser die Rolle "IAM-Invoker" zugewiesen. Sie können die Einstellung mit IAM bearbeiten, nachdem Sie den Dienst erstellt haben.
   • Wenn Sie einen durch Authentifizierung geschützten sicheren Dienst wünschen, wählen Sie Authentifizierung erforderlich aus.

7. Richten Sie die Abrechnung nach Bedarf ein.

8. Wenn Sie unter Dienstskalierung das standardmäßige Autoscaling von Cloud Run verwenden, können Sie optional die Mindestanzahl von Instanzen angeben. Wenn Sie die manuelle Skalierung verwenden, geben Sie die Anzahl der Instanzen für den Dienst an.

9. Legen Sie die Ingress-Einstellungen wie gewünscht im Formular fest.

10. Klicken Sie auf Container, Netzwerk, Sicherheit, um weitere optionale Einstellungen auf den entsprechenden Tabs festzulegen:

    • Nebenläufigkeit
    • Containerkonfiguration
    • CPU-Beschränkungen
    • Speicherlimits
    • Zeitlimit für Anfragen
    • Secrets
    • Umgebungsvariablen
    • Ausführungsumgebung
    • HTTP/2
    • Dienstkonten
    • Cloud SQL-Verbindungen
    • VPC-Verbindung

11. Wenn Sie die Konfiguration Ihres Dienstes abgeschlossen haben, klicken Sie auf Erstellen, um das Image in Cloud Run bereitzustellen. Warten Sie, bis das Deployment abgeschlossen ist.

12. Klicken Sie auf den angezeigten URL-Link, um den nur einmal vorkommenden und stabilen Endpunkt des bereitgestellten Dienstes zu öffnen.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. So stellen Sie ein Container-Image bereit:

   1. Führen Sie dazu diesen Befehl aus:

      gcloud run deploy SERVICE --image IMAGE_URL

      Ersetzen Sie Folgendes:

      • SERVICE: Der Name des Dienstes, für den Sie die Bereitstellung ausführen möchten. Dienstnamen dürfen maximal 49 Zeichen lang sein und pro Region und Projekt nur einmal vorkommen. Wenn der Dienst noch nicht vorhanden ist, erstellt dieser Befehl den Dienst während der Bereitstellung. Sie können diesen Parameter auch weglassen, werden dann jedoch nach dem Dienstnamen gefragt.
      • IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest Wenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat das Format LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. Wenn Sie das Flag --image nicht angeben, wird mit dem Bereitstellungsbefehl versucht, aus dem Quellcode bereitzustellen.

      Wenn Sie eine öffentliche API oder Website erstellen, können Sie mit dem Flag --allow-unauthenticated öffentlichen Zugriff auf Ihren Dienst zulassen. Dadurch wird allUsers die IAM-Rolle Cloud Run Invoker zugewiesen. Sie können auch --no-allow-unauthenticated angeben, um den öffentlichen Zugriff zu verbieten. Wenn Sie keines dieser Flags angeben, werden Sie aufgefordert, zu bestätigen, ob nicht authentifizierte Aufrufe zugelassen werden sollen, wenn der Befehl deploy ausgeführt wird.

   2. Warten Sie, bis die Bereitstellung abgeschlossen ist. Nach erfolgreichem Abschluss wird eine Bestätigung zusammen mit der URL des bereitgestellten Dienstes angezeigt.

   Wenn Sie an einem anderen Standort bereitstellen möchten, als Sie in den gcloud-Attributen run/region angegeben haben, verwenden Sie Folgendes:

   gcloud run deploy SERVICE --region REGION

YAML

Sie können Ihre Dienstspezifikation in einer YAML-Datei speichern und dann mit der gcloud CLI bereitstellen.

1. Erstellen Sie eine neue Datei vom Typ service.yaml mit folgendem Inhalt:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE

   Ersetzen Sie Folgendes:

   • SERVICE: Der Name Ihres Cloud Run-Dienstes. Dienstnamen dürfen maximal 49 Zeichen lang sein und pro Region und Projekt nur einmal vorkommen.
   • IMAGE: die URL Ihres Container-Images

   Sie können auch weitere Konfigurationen angeben, z. B. Umgebungsvariablen oder Speicherlimits.

2. Stellen Sie den neuen Dienst mit dem folgenden Befehl bereit:

   gcloud run services replace service.yaml

   Der Befehl gcloud run services replace verwendet standardmäßig die Datei service.yaml, sofern sie vorhanden ist.

3. Optional: Veröffentlichen Sie Ihren Dienst, wenn Sie den nicht authentifizierten Zugriff auf den Dienst zulassen möchten.

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

  provider "google" {
    project = "PROJECT-ID"
  }

  resource "google_cloud_run_v2_service" "default" {
    name     = "SERVICE"
    location = "REGION"
    client   = "terraform"

    template {
      containers {
        image = "IMAGE_URL"
      }
    }
  }

  resource "google_cloud_run_v2_service_iam_member" "noauth" {
    location = google_cloud_run_v2_service.default.location
    name     = google_cloud_run_v2_service.default.name
    role     = "roles/run.invoker"
    member   = "allUsers"
  }

Ersetzen Sie Folgendes:

• PROJECT-ID: die Google Cloud Projekt-ID
• REGION: die Google Cloud Region
• SERVICE: Der Name Ihres Cloud Run-Dienstes. Dienstnamen dürfen maximal 49 Zeichen lang sein und pro Region und Projekt nur einmal vorkommen.
• IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest Wenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat das Format LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

Diese Konfiguration ermöglicht öffentlichen Zugriff (entspricht --allow-unauthenticated). Wenn Sie den Dienst privat machen möchten, entfernen Sie die google_cloud_run_v2_service_iam_member-Stanza.

Schreiben

Sie können Ihre Compose-Spezifikation in einer YAML-Datei speichern und dann mit einem einzelnen gcloud-Befehl als Cloud Run-Dienst bereitstellen.

So stellen Sie eine compose.yaml-Datei als Cloud Run-Dienst bereit:

1. Erstellen Sie in Ihrem Projektverzeichnis eine compose.yaml-Datei mit Ihren Dienstdefinitionen.

   services:
     web:
       image: IMAGE
       ports:
         - "8080:8080"

   Ersetzen Sie IMAGE_URL durch die URL Ihres Container-Images.

   Sie können auch weitere Konfigurationsoptionen wie Umgebungsvariablen, Secrets und Volume-Bereitstellungen angeben.

Dienst bereitstellen

1. Führen Sie den Befehl gcloud run compose up aus, um die Dienste bereitzustellen:

   gcloud run compose up compose.yaml

2. Antworten Sie mit y auf alle Aufforderungen, erforderliche Komponenten zu installieren oder APIs zu aktivieren.

3. Optional: Veröffentlichen Sie Ihren Dienst, wenn Sie den nicht authentifizierten Zugriff auf den Dienst zulassen möchten.

Nach der Bereitstellung wird die Cloud Run-Dienst-URL angezeigt. Kopieren Sie diese URL und fügen Sie sie in Ihren Browser ein, um den ausgeführten Container aufzurufen. Sie können die Standardauthentifizierung in der Google Cloud Console deaktivieren.

MCP

Sie können einen KI-Agenten verwenden, um Ihren Dienst mit dem offiziellen Cloud Run-MCP-Server bereitzustellen.

Die besten Ergebnisse erzielen Sie, wenn Sie Ihrem Agenten mitteilen, dass er MCP-Tools gegenüber der gcloud CLI bevorzugen soll, bevor Sie diesen MCP-Server verwenden.

1. Folgen Sie der Anleitung im Leitfaden Remote-MCP-Server in Cloud Run verwenden, um den Remote-MCP-Server in Cloud Run einzurichten.

2. Wenn Sie den Dienst über ein Beispiel-Container-Image helloworld bereitstellen möchten, geben Sie Ihrem Agent den folgenden Prompt: Deploy service "helloworld" to Cloud Run from the container image us-docker.pkg.dev/cloudrun/container/hello.

   Der Agent verwendet das Tool deploy_service_from_image, um ein Container-Image als Cloud Run-Dienst bereitzustellen.

Den Prompt /deploy verwenden

Mit dem /deploy-Prompt können Sie schnell einen Dienst mit dem Cloud Run-MCP-Server bereitstellen. Möglicherweise müssen Sie im Menü Ihres Chatbots nach dem erforderlichen Tool oder Prompt suchen.

Führen Sie den folgenden /deploy-Prompt aus, um das aktuelle Arbeitsverzeichnis in Cloud Run bereitzustellen:

/deploy SERVICE_NAME \
    --project PROJECT_ID \
    --region REGION \

Ersetzen Sie Folgendes:

• SERVICE_NAME: Der Name des Cloud Run-Dienstes
• PROJECT_ID: die Google Cloud Projekt-ID
• REGION: der Name der Region

Clientbibliotheken

So stellen Sie einen neuen Dienst aus Code bereit:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

Senden Sie zum Bereitstellen eines neuen Dienstes eine POST-HTTP-Anfrage an den Endpunkt service der Cloud Run Admin API.

Verwenden Sie zum Beispiel curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services?serviceId=SERVICE

Ersetzen Sie Folgendes:

• ACCESS_TOKEN: Ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Bereitstellen von Diensten hat. Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mit gcloud auth print-access-token abrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen.
• IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest Wenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat das Format LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
• SERVICE: Der Name des Dienstes, in dem Sie die Bereitstellung vornehmen möchten. Dienstnamen dürfen maximal 49 Zeichen lang sein und pro Region und Projekt nur einmal vorkommen.
• REGION: die Google Cloud Region des Dienstes.
• PROJECT-ID: die Google Cloud Projekt-ID.

Console

So stellen Sie eine neue Überarbeitung eines vorhandenen Dienstes bereit:

1. Rufen Sie in der Google Cloud Console die Seite Dienste für Cloud Run auf:

   Zu Cloud Run

2. Klicken Sie in der Übersicht auf den zu aktualisierenden Dienst, um dessen Details anzuzeigen.

3. Klicken Sie auf Neue Überarbeitung bearbeiten und bereitstellen, um das Formular für die Bereitstellung der Überarbeitung aufzurufen.

   1. Geben Sie bei Bedarf die URL des neu bereitzustellenden Container-Images an.

   2. Konfigurieren Sie den Container nach Bedarf.

   3. Richten Sie die Abrechnung nach Bedarf ein.

   4. Geben Sie unter Ressourcen Speicherlimits und CPU-Limits an.

   5. Geben Sie nach Bedarf Zeitlimit für Anfragen und Gleichzeitigkeit an.

   6. Geben Sie nach Bedarf die Ausführungsumgebung an.

   7. Geben Sie unter Autoscaling die minimale und die maximale Anzahl an Instanzen an.

   8. Verwenden Sie nach Bedarf die anderen Tabs, um Folgendes zu konfigurieren:

      • Secrets
      • Umgebungsvariablen
      • HTTP/2
      • Dienstkonten
      • Cloud SQL-Verbindungen
      • VPC-Verbindung

4. Wählen Sie Diese Version sofort bereitstellen aus, um den gesamten Traffic an die neue Version zu senden. Wenn Sie eine neue Version nach und nach einführen möchten, entfernen Sie das Häkchen aus diesem Kästchen. Dies führt zu einer Bereitstellung, bei der kein Traffic an die neue Version gesendet wird. Folgen Sie der Anleitung für schrittweise Rollouts nach der Bereitstellung.

5. Klicken Sie auf Bereitstellen und warten Sie, bis die Bereitstellung abgeschlossen ist.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. So stellen Sie ein Container-Image bereit:

   1. Führen Sie diesen Befehl aus:

      gcloud run deploy SERVICE --image IMAGE_URL

      Ersetzen Sie Folgendes:

      • SERVICE: der Name des Dienstes, für den Sie die Bereitstellung vornehmen. Sie können diesen Parameter auch weglassen, werden dann jedoch nach dem Dienstnamen gefragt.
      • IMAGE_URL: ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest Wenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat das Format LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

      Das Überarbeitungssuffix wird neuen Überarbeitungen automatisch zugewiesen. Wenn Sie Ihr eigenes Überarbeitungssuffix angeben möchten, verwenden Sie den gcloud CLI-Parameter --revision-suffix.

   2. Warten Sie, bis die Bereitstellung abgeschlossen ist. Nach erfolgreichem Abschluss wird eine Bestätigung zusammen mit der URL des bereitgestellten Dienstes angezeigt.

YAML

Wenn Sie die Konfiguration eines vorhandenen Dienstes herunterladen oder aufrufen müssen, speichern Sie die Ergebnisse mit dem folgenden Befehl in einer YAML-Datei:

gcloud run services describe SERVICE --format export > service.yaml

Ändern Sie in einer YAML-Dienstkonfigurationsdatei alle untergeordneten spec.template-Attribute wie gewünscht, um die Überarbeitungseinstellungen zu aktualisieren, und stellen Sie dann die neue Überarbeitung bereit:

gcloud run services replace service.yaml

Der Befehl gcloud run services replace verwendet standardmäßig die Datei service.yaml, sofern sie vorhanden ist.

Terraform

Achten Sie darauf, dass Sie Terraform wie im Beispiel Neuen Dienst bereitstellen eingerichtet haben.

1. Nehmen Sie eine Änderung an der Konfigurationsdatei vor.

2. Wenden Sie die Terraform-Konfiguration an:

   terraform apply

   Bestätigen Sie, dass Sie die beschriebenen Aktionen anwenden möchten, indem Sie yes eingeben.

Cloud Code

Weitere Informationen zum Bereitstellen einer neuen Version eines vorhandenen Dienstes mit Cloud Code finden Sie in den Anleitungen zu IntelliJ und Visual Studio Code.

Schreiben

Sie können Ihre Compose-Spezifikation in einer YAML-Datei speichern und dann als Cloud Run-Dienstrevision mit einem einzigen gcloud-Befehl bereitstellen.

So stellen Sie eine compose.yaml-Datei als Cloud Run-Dienstversion bereit:

1. Erstellen Sie in Ihrem Projektverzeichnis eine compose.yaml-Datei mit Ihren Dienstdefinitionen.

   services:
     web:
       image: IMAGE
       ports:
         - "8080:8080"

   Ersetzen Sie IMAGE_URL durch die URL Ihres Container-Images.

   Sie können auch weitere Konfigurationsoptionen wie Umgebungsvariablen, Secrets und Volume-Bereitstellungen angeben.

Dienst bereitstellen

1. Führen Sie den Befehl gcloud run compose up aus, um die Dienste bereitzustellen:

   gcloud run compose up compose.yaml

2. Antworten Sie mit y auf alle Aufforderungen, erforderliche Komponenten zu installieren oder APIs zu aktivieren.

3. Optional: Veröffentlichen Sie Ihren Dienst, wenn Sie den nicht authentifizierten Zugriff auf den Dienst zulassen möchten.

Nach der Bereitstellung wird die Cloud Run-Dienst-URL angezeigt. Kopieren Sie diese URL und fügen Sie sie in Ihren Browser ein, um den ausgeführten Container aufzurufen. Sie können die Standardauthentifizierung in der Google Cloud Console deaktivieren.

Clientbibliotheken

So stellen Sie eine neue Code-Version bereit:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP