Kurzanleitung: Cloud Run-Instanz erstellen

Kurzanleitung: Cloud Run-Instanz erstellen

Vorschau — Cloud Run-Instanzen

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Auf dieser Seite erfahren Sie, wie Sie mit Cloud Run eine Cloud Run-Instanz in einem Beispielcontainer erstellen, die Logs aufrufen und den Lebenszyklus mit der gcloud CLI verwalten.

Hinweis

1. Installieren Sie die Google Cloud CLI.

   Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.

2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

   Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

   gcloud init

4. Erstellen oder wählen Sie ein Google Cloud Projekt aus.

   Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

   • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
   • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die resourcemanager.projects.create Berechtigung enthält. Rollen zuweisen.
   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit ihm verknüpften Ressourcen entfernen.

   • Google Cloud Projekt erstellen:

     gcloud projects create PROJECT_ID

     Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud Projekt, das Sie erstellen.

   • Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

     gcloud config set project PROJECT_ID

     Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

5. Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.

6. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

7. Aktivieren Sie die Cloud Run Admin API und die Cloud Logging APIs:

   Rollen, die zum Aktivieren von APIs erforderlich sind

   Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Rollen zuweisen.

   gcloud services enable run.googleapis.com logging.googleapis.com

8. So legen Sie das Standardprojekt für Ihre Cloud Run-Instanz fest:

   gcloud config set project PROJECT_ID

   Ersetzen Sie PROJECT_ID durch den Namen des Projekts, das Sie für diese Kurzanleitung erstellt haben.
9. Prüfen Sie, ob die Komponente gcloud beta installiert ist:

   gcloud components install beta

10. Preise für Cloud Run 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:

• Rolle „Cloud Run-Administrator“ (roles/run.admin) für die Instanz
• Rolle „Dienstkontonutzer“ (roles/iam.serviceAccountUser) für die Dienstidentität
• Rolle „Logs-Betrachter“ (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.

Instanz erstellen

So erstellen Sie mit der gcloud CLI eine Cloud Run-Instanz in einem Beispielcontainer:

1. Führen Sie dazu diesen Befehl aus:

   gcloud beta run instances create my-instance \
   --image us-docker.pkg.dev/cloudrun/container/hello \
   --region REGION \
   --port 8080 \
   --no-invoker-iam-check

   Ersetzen Sie REGION durch eine unterstützte Google Cloud Region.

   Das Flag --no-invoker-iam-check deaktiviert die IAM-Authentifizierung für Aufrufer, sodass auf die Instanz-URL ohne IAM-Authentifizierung zugegriffen werden kann.

2. Warten Sie, bis die Erstellung der Instanz abgeschlossen ist. Nach Abschluss wird eine Ausgabe ähnlich der folgenden angezeigt:

   Creating instance...
   Importing container..............done
   Provisioning resources.......done
   Starting instance.....done
   Done.
   Instance [my-instance] has successfully been created.
   
   URL: https://my-instance-PROJECT-NUMBER.REGION.run.app
   

3. Öffnen Sie die zurückgegebene URL in Ihrem Browser, um mit dem ausgeführten Container zu interagieren.

Instanzlogs ansehen

So rufen Sie die von Ihrer Cloud Run-Instanz generierten Logs auf:

1. Rufen Sie in der Google Cloud Console den Log-Explorer auf:

   Zum Log-Explorer

2. Filtern Sie die Logs nach Ihrer spezifischen Instanz:

   resource.type="cloud_run_instance"
   resource.labels.location="<var>REGION</var>"
   resource.labels.instance_name="my-instance"
   

Bereinigen

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

Instanz löschen

So beenden und löschen Sie die Cloud Run-Instanz:

gcloud beta run instances delete my-instance --region REGION

Testprojekt löschen

Durch das Löschen Ihres Google Cloud Projekts wird die Abrechnung für alle Ressourcen in diesem Projekt beendet. So geben Sie alle Google Cloud Ressourcen in Ihrem Projekt frei:

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:
• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Projekt Google Cloud löschen:

gcloud projects delete PROJECT_ID

Nächste Schritte

Weitere Informationen zu Cloud Run-Instanzen:

• Cloud Run-Instanzen erstellen und verwalten
• Lebenszyklus von Cloud Run-Instanzen