Kurzanleitung: Für Cloud Run aus einem Git-Repository bereitstellen
Auf dieser Seite erfahren Sie, wie Sie mit Cloud Build kontinuierlich aus einem Git-Repository für Cloud Run bereitstellen.
Sie können kontinuierlich aus einem Repository bereitstellen, indem Sie Cloud Build oder Developer Connect verwenden.
Eine detaillierte Anleitung dazu finden Sie direkt in der Google Cloud Console. Klicken Sie dazu einfach auf Anleitung:
Hinweis
- Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch 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.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
-
Aktivieren Sie die Cloud Build API.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (
roles/serviceusage.serviceUsageAdmin), die die Berechtigungserviceusage.services.enableenthält. Weitere Informationen zum Zuweisen von Rollen Wenn Sie einer Domaineinschränkung zur Organisation nicht eingeschränkter Aufrufe für Ihr Projekt unterliegen, müssen Sie auf Ihren bereitgestellten Dienst zugreifen, wie unter Private Dienste testen beschrieben.
- Cloud Run-Preise ansehen oder Kosten mit dem Preisrechner schätzen
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen der Kurzanleitung benötigen:
-
Cloud Run Source Developer (
roles/run.sourceDeveloper) im Dienst -
Rolle Cloud Run-Administrator (
roles/run.admin) im Projekt -
Dienstkontonutzer (
roles/iam.serviceAccountUser) für die Dienstidentität -
Loganzeige (
roles/logging.viewer) für das Projekt
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Repository aus einer Vorlage erstellen
So erstellen Sie ein Repository:
Öffnen Sie das Vorlagen-Repository:
Node.js
Rufen Sie github.com/GoogleCloudPlatform/cloud-run-microservice-template-nodejs auf.
Python
Rufen Sie github.com/GoogleCloudPlatform/cloud-run-microservice-template-python auf.
Go
Rufen Sie github.com/GoogleCloudPlatform/cloud-run-microservice-template-go auf.
Java
Rufen Sie github.com/GoogleCloudPlatform/cloud-run-microservice-template-java auf.
Klicken Sie auf In Google Cloud ausführen.
Wählen Sie Neues Repository erstellen aus.
Geben Sie im Formular einen Repository-Namen ein.
Klicken Sie auf Repository aus Vorlage erstellen.
Aus dem Repository bereitstellen
So stellen Sie aus dem Repository bereit:
Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:
Wählen Sie im Menü Dienste aus und klicken Sie auf Repository verbinden.
Klicken Sie im Formular auf Cloud Build einrichten.
Im rechten Bereich,
Wählen Sie unter Repository das neu erstellte Repository aus. Wenn Sie sich noch nicht authentifiziert haben, müssen Sie dies möglicherweise tun. Verwenden Sie den Link authenticate unter dem Feld Repository-Anbieter.
Lesen Sie die Bestätigungsvereinbarung zur Interaktion von GitHub und Google Cloud .
Klicken Sie auf Weiter.
Wählen Sie unter Build-Typ die Option Google Cloud Buildpacks aus.
Klicken Sie auf Speichern.
Im Formular Dienst erstellen:
Bestätigen Sie den Namen des Dienstes. Er enthält automatisch den Repository-Namen.
Wählen Sie im Drop-down-Menü Region die Region aus, in der sich Ihr Dienst befinden soll.
Wählen Sie unter Authentifizierung die Option Öffentlichen Zugriff erlauben aus. Wenn Sie nicht berechtigt sind, diese Option auszuwählen (Cloud Run-Administratorrolle), wird der Dienst bereitgestellt und erfordert eine Authentifizierung.
Klicken Sie auf Erstellen, um das Beispiel-Repository in Cloud Run bereitzustellen. Warten Sie dann, bis die Bereitstellung abgeschlossen ist.
Klicken Sie auf den angezeigten URL-Link, um den bereitgestellten Container auszuführen.
Cloud Run-Standorte
Cloud Run ist regional. Die Infrastruktur, in der die Cloud Run-Dienste ausgeführt werden, befindet sich demnach in einer bestimmten Region. Aufgrund der Verwaltung durch Google sind die Anwendungen in allen Zonen innerhalb dieser Region redundant verfügbar.
Bei der Auswahl der Region, in der Ihre Cloud Run-Dienste ausgeführt werden, ist vorrangig, dass die Anforderungen hinsichtlich Latenz, Verfügbarkeit oder Langlebigkeit erfüllt werden.
Sie können im Allgemeinen die Region auswählen, die Ihren Nutzern am nächsten ist. Sie sollten dabei jedoch auch den Standort der anderen Google Cloud-Produkte berücksichtigen, die der Cloud Run-Dienst verwendet.
Die gemeinsame Nutzung von Google Cloud Produkten an mehreren Standorten kann sich auf die Latenz und die Kosten des Dienstes auswirken.
Cloud Run ist in diesen Regionen verfügbar:
Unterliegt Preisstufe 1
asia-east1(Taiwan)asia-northeast1(Tokio)asia-northeast2(Osaka)asia-south1(Mumbai, Indien)asia-southeast3(Bangkok)europe-north1(Finnland)Niedriger CO2-Wert
europe-north2(Stockholm)Niedriger CO2-Ausstoß
europe-southwest1(Madrid)Niedriger CO2-Ausstoß
europe-west1(Belgien)Niedriger CO2-Ausstoß
europe-west4(Niederlande)Niedriger CO2-Ausstoß
europe-west8(Mailand)europe-west9(Paris)Niedriger CO2-Ausstoß
me-west1(Tel Aviv)northamerica-south1(Mexiko)us-central1(Iowa)Niedriger CO2-Ausstoß
us-east1(South Carolina)us-east4(Northern Virginia)us-east5(Columbus)us-south1(Dallas)Niedriger CO2-Ausstoß
us-west1(Oregon)Niedriger CO2-Ausstoß
Unterliegt Preisstufe 2
africa-south1(Johannesburg)asia-east2(Hongkong)asia-northeast3(Seoul, Südkorea)asia-southeast1(Singapur)asia-southeast2(Jakarta)asia-south2(Delhi, Indien)australia-southeast1(Sydney)australia-southeast2(Melbourne)europe-central2(Warschau, Polen)europe-west10(Berlin)europe-west12(Turin)europe-west2(London, Vereinigtes Königreich)Niedriger CO2-Ausstoß
europe-west3(Frankfurt, Deutschland)europe-west6(Zürich, Schweiz)Niedriger CO2-Ausstoß
me-central1(Doha)me-central2(Dammam)northamerica-northeast1(Montreal)Niedriger CO2-Ausstoß
northamerica-northeast2(Toronto)Niedriger CO2-Ausstoß
southamerica-east1(Sao Paulo, Brasilien)Niedriger CO2-Ausstoß
southamerica-west1(Santiago, Chile)Niedriger CO2-Ausstoß
us-west2(Los Angeles)us-west3(Salt Lake City)us-west4(Las Vegas)
Wenn Sie bereits einen Cloud Run-Dienst erstellt haben, können Sie dessen Region im Cloud Run-Dashboard der Google Cloud Console aufrufen.
Dienst aktualisieren
So ändern Sie den Dienst:
Übertragen Sie ein Commit per Push an den Hauptzweig des Repositorys.
Aktualisieren Sie den Cloud Run-Dienst, um den Status der Aktualisierung anzuzeigen.
Cloud Run skaliert Ihre Containerinstanzen automatisch basierend auf der Nachfrage. Sie zahlen nur für die CPU-, Arbeitsspeicher- und Netzwerkressourcen, die während der Anfrageverarbeitung verbraucht werden.
Bereinigen
Löschen Sie alle Ressourcen, die Sie mit dieser Kurzanleitung bereitgestellt haben, um zusätzliche Gebühren für Ihr Google Cloud -Konto zu vermeiden.
Repository löschen
Für Cloud Run fallen keine Kosten an, wenn Ihr bereitgestellter Dienst nicht verwendet wird. Das Speichern des Container-Images in Artifact Registry ist jedoch möglicherweise kostenpflichtig. Wenn Sie Artifact Registry-Repositories löschen möchten, folgen Sie der Anleitung unter Repositories löschen in der Artifact Registry-Dokumentation.
Dienst löschen
Für Cloud Run-Dienste fallen erst Kosten an, wenn sie Anfragen empfangen. So löschen Sie Ihren Cloud Run-Dienst:
Console
So löschen Sie einen Dienst:
Rufen Sie in der Google Cloud Console die Seite Dienste für Cloud Run auf:
Klicken Sie in der Übersicht das Kästchen des zu löschenden Dienstes an.
Klicken Sie auf Löschen. Dadurch werden alle Überarbeitungen des Dienstes gelöscht.
gcloud
Führen Sie den folgenden Befehl aus, um einen Dienst zu löschen:
gcloud run services delete SERVICE --region REGION
Ersetzen Sie Folgendes:
- SERVICE: Name Ihres Dienstes.
- REGION: Google Cloud Region des Dienstes.
Testprojekt löschen
Wenn Sie Ihr Google Cloud -Projekt löschen, wird die Abrechnung für alle Ressourcen in diesem Projekt beendet. So geben Sie alle Google Cloud Ressourcen in Ihrem Projekt frei:
- Wechseln Sie in der Google Cloud -Console zur Seite Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.