Verbindung zu einer Firestore-Datenbank herstellen

Vorschau — Using the Cloud Run integrations

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Verwenden Sie Firestore, um eine skalierbare NoSQL-Cloud-Datenbank für Ihren Cloud Run-Dienst einzurichten. Firestore ist eine flexible, skalierbare NoSQL-Datenbank für die Mobil-, Web- und Serverentwicklung.

Mit der auf dieser Seite beschriebenen Cloud Run-Integration können Sie Ihren Cloud Run-Dienst schnell mit einer neuen Firestore-Datenbank verbinden.

Hinweise

• Achten Sie darauf, dass der Cloud Run-Dienst, in den Sie einbinden, bereits bereitgestellt ist.
• Preisübersicht für Firestore Ihnen werden einzelne Ressourcen in Rechnung gestellt, die von der Einbindung verwendet werden.

Erforderliche Rollen

Damit Sie die Cloud Run-Integrationen verwenden können, müssen Sie oder Ihr Administrator zwei verschiedenen Hauptkonten IAM-Rollen zuweisen.

Klicken, um die erforderlichen Rollen für Ihr Google-Konto anzuzeigen

Bitten Sie Ihren Administrator, Ihrem Google-Konto die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie für die Verwendung von Cloud Run-Einbindungen benötigen:

• Cloud Run Developer (roles/run.developer)
• Compute-Betrachter (roles/compute.viewer)
• Entwickler von serverlosen EInbindungen (roles/runapps.developer)
• Operator für serverlose Einbindungen (roles/runapps.operator)
• Dienstkontonutzer (roles/iam.serviceAccountUser)

Klicken Sie, um die erforderlichen Rollen für das Dienstkonto aufzurufen

Zum Bereitstellen des Cloud Run-Dienstes können Sie entweder das automatisch erstellte Compute Engine-Standarddienstkonto verwenden oder ein nutzerverwaltetes Dienstkonto angeben. Das Dienstkonto muss die folgenden Rollen haben:

• Cloud Run Developer (roles/run.developer)
• Log-Bucket-Autor (roles/logging.bucketWriter)
• Dienstkontonutzer (roles/iam.serviceAccountUser)
• Storage-Administrator (roles/storage.admin)
• Firestore-Administrator (roles/firestore.admin)
• Project IAM Admin (roles/projectIAM.admin)

Dienst mit einer neuen Firestore-Datenbank verbinden

Jede Konfigurationsänderung führt zur Erstellung einer neuen Überarbeitung. Für nachfolgende Überarbeitungen gilt automatisch dieselbe Konfigurationseinstellung, sofern Sie sie nicht explizit aktualisieren.

Sie können einen Cloud Run-Dienst über die Console oder die Befehlszeile mit einer Firestore-Datenbank verbinden.

Console

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run.

   Öffnen Sie Cloud Run.

2. Klicken Sie in der Liste der Dienste, die Sie in dieser Einbindung verwenden möchten, auf den Dienst.

3. Klicken Sie auf den Tab Integrations (Integrationen).

4. Klicken Sie auf Integration hinzufügen.

5. Klicken Sie auf Firestore-Datenbank.

6. Verwenden Sie den Standardnamen oder ändern Sie den Namen in den gewünschten Wert.

   

7. Wenn Sie aufgefordert werden, eine Liste von APIs zu aktivieren, klicken Sie auf Aktivieren und warten Sie, bis die APIs aktiviert sind.

8. Unter Ressourcen finden Sie die neuen Ressourcen, die durch diese Einbindung erstellt werden.

9. Klicken Sie auf Senden und warten Sie, bis die Einbindung und die Ressourcen erstellt sind. Dieser kann bis zu 15 Minuten dauern.

Befehlszeile

1. Aktualisieren Sie die Google Cloud CLI:

   gcloud components update
   

2. Integration erstellen:

   gcloud beta run integrations create \
   --type=firestore \
   --service=SERVICE \
   

   Ersetzen Sie:

   • SERVICE durch den Namen Ihres Cloud Run-Dienstes.

   Fügen Sie optional das Flag --service-account=SERVICE_ACCOUNT_EMAIL hinzu.

   • SERVICE_ACCOUNT_EMAIL durch die E-Mail-Adresse des vom Nutzer verwalteten Dienstkontos ([e-mail]), die zum Bereitstellen des Dienstes verwendet wird. Lassen Sie dieses Flag weg, wenn Sie das Compute-Standarddienstkonto (SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com) verwenden möchten.

     Führen Sie den folgenden Befehl aus, um beim Bereitstellen von Cloud Run-Integrationen das angegebene Dienstkonto weiterhin zu verwenden:

     gcloud config set runapps/deployment-service-account
     

3. Warten Sie bis zu 15 Minuten. In dieser Zeit wird eine vollständig konfigurierte Firestore-Datenbank erstellt und verbunden. Außerdem wird eine neue Cloud Run-Überarbeitung erstellt, einschließlich Umgebungsvariablen, die die Datenbank identifizieren. Wenn der Vorgang abgeschlossen ist, wird die folgende Meldung angezeigt:

   [firestore] integration [firestore-xxx] has been updated successfully.
   
   To connect to the Firestore database, utilize the environment variable
   `FIRESTORE_DB_NAME`. This variable is added to the Cloud Run
   service for you.

   Sie können den Status prüfen, indem Sie gcloud beta run integrations describe ausführen.

Firestore-Datenbankintegrationen ansehen

So rufen Sie den aktuellen Status der Firestore-Datenbankintegrationen für Ihren Cloud Run-Dienst auf:

Console

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run.

   Öffnen Sie Cloud Run.

2. Klicken Sie in der Liste der Dienste, die Sie in dieser Einbindung verwenden möchten, auf den Dienst.

3. Klicken Sie auf den Tab Integrations (Integrationen).

4. Suchen Sie nach der Firestore-Datenbankintegration, die Sie interessiert, und klicken Sie auf Details ansehen.

Befehlszeile

1. Verwenden Sie den folgenden Befehl, um eine Liste der verfügbaren Integrationen abzurufen:

   gcloud beta run integrations list

2. Zeigen Sie die Details dafür mit einem Namen aus der zurückgegebenen Liste an:

   gcloud beta run integrations describe INTEGRATION_NAME

   Ersetzen Sie INTEGRATION_NAME durch den Namen der Firestore-Datenbankintegration.

Firestore-Datenbankintegrationen löschen

Beim Löschen einer Einbindung werden auch alle mit dieser Einbindung verknüpften Google Cloud-Ressourcen gelöscht. Der Cloud Run-Dienst wird jedoch nicht gelöscht.

So löschen Sie eine Firestore-Datenbankintegration aus Ihrem Cloud Run-Dienst:

Console

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run.

   Öffnen Sie Cloud Run.

2. Klicken Sie auf den Dienst, für den Sie eine Einbindung löschen möchten.

3. Klicken Sie auf den Tab Integrations (Integrationen).

4. Suchen Sie die Firebase Datenbank-Integration, die Sie interessiert, und klicken Sie rechts neben der Integration auf Dreipunkt-Symbol und dann auf Löschen.

Befehlszeile

1. Verwenden Sie den folgenden Befehl, um eine Liste der verfügbaren Integrationen abzurufen:

   gcloud beta run integrations list

2. Löschen Sie die Integration mithilfe eines Namens aus der zurückgegebenen Liste:

   gcloud beta run integrations delete INTEGRATION_NAME
   

   Ersetzen Sie:

   • INTEGRATION_NAME durch den Namen der Firestore-Datenbankintegration.

   Optional können Sie die folgenden Flag-Optionen verwenden:

   Wahltaste	Beschreibung
   --service-account	Die E-Mail-Adresse des vom Nutzer verwalteten Dienstkontos, um den Löschvorgang auszuführen.

Über Ihren Code auf die Firestore-Datenbank zugreifen

Nachdem Sie die Integration abgeschlossen haben, fügt Cloud Run automatisch die Umgebungsvariable FIRESTORE_DB_NAME zur Verwendung in Ihrem Cloud Run-Dienstcode hinzu.

Beispielcode für Dienste mit Firestore

Codebeispiele für Cloud Run und Firestore finden sich in der Firestore-Dokumentation.

Beschränkungen

• Die Cloud Run-Integrationen werden nur in bestimmten Regionen unterstützt. Falls Sie eine Region verwenden müssen, die nicht von den Cloud Run-Integrationen unterstützt wird, lesen Sie die Informationen unter Serverseitige Clientbibliothek verwenden.
• Die Firestore-Standarddatenbank wird nicht unterstützt. Diese Integration unterstützt nur das Erstellen benannter Firestore-Datenbanken.