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 von Firebase und Google Cloud gemeinsam genutzt. 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.

  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.

  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.

  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.

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.

  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.

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

FAQs und Fehlerbehebung

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 auch die Firebase-Nutzungsbedingungen akzeptieren, um einem vorhandenen Google Cloud-Projekt Firebase hinzuzufügen.

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, geschieht dies nur für Ihr Google-Konto. Die Zustimmung erfolgt nicht auf Projektebene für alle Projektmitglieder.

Sie können die Firebase-Nutzungsbedingungen über die Firebase Console mit einer der folgenden Optionen akzeptieren. Akzeptieren Sie die Nutzungsbedingungen, wenn Sie dazu aufgefordert werden.

  • Erstellen Sie mit der Firebase Console ein neues Firebase-Projekt.

  • Öffnen Sie ein vorhandenes Firebase-Projekt in der Firebase Console. Beispiel: Jemand hat Sie eingeladen, Projektmitglied (d. h. Hauptverantwortlicher) für das Projekt zu werden.

  • Öffnen Sie eine vorhandene Google Cloud in der Firebase-Konsole und fügen Sie Firebase hinzu.

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.

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

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).

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:

    • service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
    • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com
  • Aktiviert die folgenden APIs:

    • 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

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.

Sie können zwar nicht verhindern, dass einem vorhandenen Google Cloud-Projekt Firebase hinzugefügt wird, aber Sie haben folgende Möglichkeiten:

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. Mit einer IAM-Ablehnungsrichtlinie können Sie dies effizient erreichen.

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 bei einem Projekt, damit Sie einen klaren Entwicklungsablauf mit verschiedenen Umgebungen haben.

  • Wenn Sie Firebase in Ihren mobilen und Web-Apps verwenden möchten, registrieren Sie Ihre Apps in Ihrem Firebase-Projekt und verknüpfen Sie sie mit Firebase: iOS+ | Android | Web | Flutter | Unity | C++.