Erste Schritte mit Firebase mit einem vorhandenen Google Cloud-Projekt

Ein Firebase-Projekt ist ein Google Cloud-Projekt, für das einige zusätzliche Firebase-spezifische Konfigurationen und Dienste aktiviert sind. Dies wird allgemein als „Firebase einem Google Cloud-Projekt hinzufügen“ bezeichnet. Auf dieser Seite wird beschrieben, wie Sie Firebase hinzufügen. Außerdem finden Sie hier einige häufig gestellte Fragen.

Wenn Sie Firebase einem Google Cloud-Projekt hinzufügen, werden automatisch mehrere APIs aktiviert und Dienstkonten erstellt, um die Verwendung aller Firebase-Dienste und ‑Benutzeroberflächen zu vereinfachen. Firebase fügt Ihrem Projekt außerdem ein firebase:enabled-Label auf der Seite Labels der Google Cloud Console hinzu. Weitere Informationen zu den Auswirkungen der Option „Firebase hinzufügen“

Beziehung zwischen einem Firebase-Projekt und einem Google Cloud-Projekt

Da ein Firebase-Projekt ein Google Cloud-Projekt ist:

• Sie können über die Firebase Console, die Google Cloud Console und die Google APIs Console auf das Projekt zugreifen und mit ihm interagieren.

• Sie können mit dem Projekt über die Firebase-Befehlszeile, die gcloud CLI und jede Terraform-Ressource von Google interagieren.

• Sie können im Projekt sowohl Produkte als auch APIs von Firebase und Google Cloud verwenden.

• IAM-Berechtigungen und ‑Rollen für das Projekt werden von Firebase und Google Cloud gemeinsam genutzt. Der Zugriff eines Projektmitglieds (d. h. eines Prinzipals) auf Ihr Google Cloud-Projekt gilt auch für Ihr Firebase-Projekt und umgekehrt.

• Die Abrechnung für das Projekt wird zwischen Firebase und Google Cloud geteilt. Wenn die Abrechnung für Ihr Google Cloud-Projekt aktiviert ist, wird für Ihr Firebase-Projekt der Firebase-Tarif „Blaze“ (Pay as you go) angewendet.

• Eindeutige Kennungen für das Projekt (z. B. Projektnummer und Projekt-ID) werden in Firebase und Google Cloud gemeinsam verwendet.

• Die Ressourcenhierarchie, die auf Ihr Google Cloud-Projekt angewendet wird (z. B. Organisation, Ordner usw.), gilt auch für Ihr Firebase-Projekt.

• Wenn Sie das Projekt löschen, wird es in Firebase und Google Cloud gelöscht.

• Wenn Sie eine Ressource oder Daten im Projekt löschen oder ändern, gilt das für Firebase und Google Cloud.

Firebase einem vorhandenen Google Cloud-Projekt hinzufügen

Sie können einem vorhandenen Google Cloud-Projekt Firebase mit einer der folgenden Optionen hinzufügen. Sie benötigen die erforderlichen Berechtigungen, um Firebase dem Projekt Google Cloud hinzuzufügen.

Wenn Sie einem vorhandenen Google Cloud-Projekt Firebase hinzugefügt haben, kann dies nicht rückgängig gemacht werden. Das heißt, Sie können Firebase nicht vollständig aus dem Google Cloud-Projekt entfernen. Weitere Informationen finden Sie in diesen FAQs.

Hinweis: Damit Sie in einem Google Cloud-Projekt auf alle Firebase-Funktionen zugreifen und sie verwenden können, müssen Sie die Firebase-Nutzungsbedingungen akzeptieren. Weitere Informationen zu den Anforderungen an die Firebase-Nutzungsbedingungen finden Sie in diesen häufig gestellten Fragen.

Firebase-Konsole

1. Rufen Sie die Firebase Console auf.

2. Melden Sie sich mit demselben Google-Konto an, mit dem Sie auf das vorhandene Google Cloud-Projekt zugreifen können.

3. Klicken Sie auf Projekt erstellen.

4. Klicken Sie unten auf der Seite auf den Link Sie haben bereits ein Google Cloud-Projekt?

5. Geben Sie im Textfeld die Projekt-ID des vorhandenen Projekts ein und wählen Sie es dann aus der angezeigten Liste aus.

6. Klicken Sie auf Projekt öffnen.

7. Akzeptieren Sie die Firebase-Nutzungsbedingungen, wenn Sie dazu aufgefordert werden.

8. Folgen Sie der Anleitung auf dem Bildschirm, um Firebase hinzuzufügen und ein Firebase-Projekt einzurichten.

   Die Aktivierung von Google Analytics ist optional.

Firebase CLI

1. Installieren Sie die Firebase-Befehlszeile, falls noch nicht geschehen.

2. Melden Sie sich mit demselben Google-Konto an, mit dem Sie auf das vorhandene Google Cloud-Projekt zugreifen können.

3. Führen Sie dazu diesen Befehl aus:

   firebase projects:addfirebase

4. Wählen Sie auf Aufforderung das vorhandene Google Cloud-Projekt aus der angezeigten Liste aus.

5. Wenn Sie die Firebase-Nutzungsbedingungen noch nicht akzeptiert haben, öffnen Sie ein Firebase-Projekt in der Firebase Console, um sie zu akzeptieren. Weitere Informationen zu den Anforderungen an die Firebase-Nutzungsbedingungen finden Sie in diesen FAQs.

REST API

1. Aktivieren Sie die Firebase Management API im vorhandenen Google Cloud-Projekt.

2. Erstellen Sie ein API-Zugriffstoken.

3. Aktivieren Sie Firebase-Dienste für das Projekt, indem Sie projects.addFirebase aufrufen.

   Sie benötigen den Ressourcennamen Ihres Projekts, um diesen Aufruf auszuführen.

4. Wenn Sie die Firebase-Nutzungsbedingungen noch nicht akzeptiert haben, öffnen Sie ein Firebase-Projekt in der Firebase Console, um sie zu akzeptieren. Weitere Informationen zu den Anforderungen an die Firebase-Nutzungsbedingungen finden Sie in diesen FAQs.

Eine ausführliche Anleitung finden Sie im Firebase-Leitfaden „Firebase-Projekt mit der Management REST API einrichten und verwalten“ unter Ihrem Projekt Firebase-Dienste hinzufügen. Folgen Sie unbedingt allen Anweisungen im Abschnitt Vorbereitung dieses Leitfadens.

Terraform

1. Aktivieren Sie die Firebase Management API (firebase.googleapis.com) im vorhandenen Google Cloud-Projekt.

2. Aktivieren Sie Firebase-Dienste für das Projekt mithilfe der Ressource google_firebase_project.

3. Wenn Sie die Firebase-Nutzungsbedingungen noch nicht akzeptiert haben, öffnen Sie ein Firebase-Projekt in der Firebase Console, um sie zu akzeptieren. Weitere Informationen zu den Anforderungen an die Firebase-Nutzungsbedingungen finden Sie in diesen FAQs.

Ausführliche Informationen zur Verwendung von Firebase und Terraform finden Sie unter Erste Schritte mit Terraform und Firebase.

FAQs und Fehlerbehebung

Muss ich die Firebase-Nutzungsbedingungen akzeptieren, um Firebase verwenden zu können?

Wenn Sie in einem Google Cloud-Projekt auf alle Firebase-Funktionen zugreifen und sie verwenden möchten, müssen Sie die Firebase-Nutzungsbedingungen akzeptieren.

Sie müssen die Firebase-Nutzungsbedingungen nur einmal für Ihr Google-Konto akzeptieren, unabhängig davon, auf wie viele Projekte Sie Zugriff haben. Wenn Sie die Nutzungsbedingungen akzeptieren, gilt dies nur für Ihr Google-Konto. Die Zustimmung erfolgt nicht auf Projektebene für alle Projektmitglieder.

Sie akzeptieren die Firebase-Nutzungsbedingungen, indem Sie das Firebase-Projekt in der Firebase Console öffnen und der Anleitung auf dem Bildschirm folgen.

Wichtig: Wenn Sie eine Offlineversion der Google Cloud-Mastervereinbarung für die Nutzung bestimmter Firebase-Dienste mit demselben Google Cloud-Konto unterzeichnet haben, gelten die Firebase-Nutzungsbedingungen nicht für Ihre Nutzung dieser Firebase-Dienste. Stattdessen regeln Ihre Offline-Nutzungsbedingungen Ihre Nutzung dieser Firebase-Dienste.

Welche Berechtigungen sind für die Option „Firebase hinzufügen“ erforderlich?

Wenn Sie einem vorhandenen Google Cloud-Projekt „Firebase hinzufügen“ möchten, muss ein Projektmitglied (d. h. ein Prinzipal) die folgenden IAM-Berechtigungen haben:

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

Die IAM-Rollen „Bearbeiter“ und „Inhaber“ enthalten diese Berechtigungen standardmäßig.

Reicht es aus, das Label firebase:enabled hinzuzufügen, um Firebase hinzuzufügen?

Alle Firebase-Projekte haben in der Google Cloud Console auf der Seite Labels das Label firebase:enabled.

Wenn Sie das Label firebase:enabled jedoch nur manuell der Liste der Projektlabels hinzufügen, werden Firebase-spezifische Konfigurationen und Dienste für Ihr Google Cloud-Projekt NICHT aktiviert. Dazu müssen Sie Firebase über die Firebase Console hinzufügen (oder bei erweiterten Anwendungsfällen über die Firebase CLI, die Firebase Management REST API oder Terraform).

Was passiert, wenn Sie einem vorhandenen Google Cloud-Projekt „Firebase hinzufügen“?

Ein Firebase-Projekt ist ein Google Cloud-Projekt, für das einige zusätzliche Firebase-spezifische Konfigurationen und Dienste aktiviert sind. Wenn Sie einem vorhandenen Google Cloud-Projekt „Firebase hinzufügen“, werden von Firebase die folgenden Aktionen ausgeführt, um die Verwendung aller Firebase-Dienste und ‑Benutzeroberflächen zu vereinfachen:

• Das Label firebase:enabled wird auf der Seite Labels der Google Cloud-Konsole hinzugefügt.

• Erstellt einen API-Schlüssel vom Typ „Browser“ und schränkt ihn automatisch auf die Firebase-bezogenen APIs ein.

• Die folgenden Dienstkonten werden erstellt:

  • [e-mail]
  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Dadurch werden die folgenden APIs aktiviert:

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Firebase Dynamic Links API
  • Firebase Hosting API
  • Firebase Installations API
  • Firebase Management API
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

Kann ich Firebase aus einem Projekt entfernen?

Wenn Sie einem vorhandenen Google Cloud-Projekt Firebase hinzugefügt haben, kann dies nicht rückgängig gemacht werden. Das heißt, Sie können Firebase nicht vollständig aus dem Google Cloud-Projekt entfernen.

Wenn du Firebase hinzufügst, werden APIs und Backend-Dienste aktiviert, die für andere Google Cloud-Funktionen verwendet werden können. Die Deaktivierung all dieser aktivierten Dienste kann aufgrund von Abhängigkeiten zu unerwarteten und unbeabsichtigten Folgen führen.

Sie können jedoch alle APIs manuell deaktivieren und das Label, den API-Schlüssel und die Dienstkonten löschen, die automatisch aktiviert und erstellt wurden, als Sie Firebase hinzugefügt haben.

Warnung :Wenn Sie die Änderungen, die Sie beim Hinzufügen von Firebase vorgenommen haben, manuell deaktivieren und löschen möchten, gehen Sie dabei mit äußerster Vorsicht vor. Sie müssen sich absolut sicher sein, dass in Ihrem Google Cloud-Projekt und den zugehörigen Apps nichts verwendet wird, das mit den Elementen zusammenhängt, die Sie deaktivieren und löschen. Andernfalls funktioniert Ihr Projekt oder Ihre App möglicherweise nicht mehr oder sie verhält sich unerwartet.

Kann das Hinzufügen von Firebase für ein vorhandenes Google Cloud-Projekt blockiert werden?

Ja, Sie können die Möglichkeit blockieren, einem vorhandenen Google Cloud-Projekt Firebase hinzuzufügen. Sie haben unter anderem folgende Möglichkeiten:

• Blockieren Sie die Aktivierung der firebase.googleapis.com API mit der Einschränkung Zulässige Google Cloud APIs und -Dienste einschränken.

• Beschränken Sie die Projektmitglieder (d. h. die Hauptkonten), die die IAM-Berechtigung firebase.projects.update haben, die für die Option „Firebase hinzufügen“ erforderlich ist. Sie können dazu eine IAM-Ablehnungsrichtlinie verwenden.

Nächste Schritte

• Weitere Informationen zu Firebase-Projekten finden Sie in den folgenden Ressourcen:

  • Firebase-Projekte: Hier erhalten Sie einen kurzen Überblick über einige wichtige Konzepte zu Firebase-Projekten, einschließlich ihrer Beziehung zu Google Cloud und der grundlegenden Hierarchie eines Projekts sowie seiner Apps und Ressourcen.

  • Allgemeine Best Practices für die Einrichtung von Firebase-Projekten: Hier finden Sie allgemeine Best Practices für die Einrichtung von Firebase-Projekten und die Registrierung Ihrer Apps in einem Projekt, damit Sie einen klaren Entwicklungsablauf mit verschiedenen Umgebungen haben.

• Registrieren Sie Ihre Apps in Ihrem Firebase-Projekt und verknüpfen Sie sie mit Firebase, um Firebase in Ihren mobilen und Web-Apps zu verwenden: iOS+ | Android | Web | Flutter | Unity | C++.