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 häufig als „Firebase zu einem Google Cloud-Projekt hinzufügen“ bezeichnet. Auf dieser Seite wird beschrieben, wie Sie Firebase hinzufügen, und es werden einige häufig gestellte Fragen beantwortet.

Wenn Sie einem Google Cloud-Projekt Firebase hinzufügen, werden automatisch mehrere APIs aktiviert und Dienstkonten erstellt, um die Verwendung aller Firebase-Dienste und ‑Schnittstellen zu vereinfachen. Firebase fügt Ihrem Projekt in der Seite „Labels“ der Google Cloud Console auch das firebase:enabled-Label hinzu. Weitere Informationen

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

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

• Sie können in der Firebase-Konsole, der Google Cloud-Konsole und der Google APIs Console auf das Projekt zugreifen und damit interagieren.

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

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

• IAM-Berechtigungen und ‑Rollen für das Projekt werden von Firebase und Google Cloud gemeinsam genutzt. Jeder Zugriff, den ein Projektmitglied (d. h. ein Prinzipal) auf Ihr Google Cloud-Projekt hat, 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 Kennzeichnungen für das Projekt, z. B. die Projektnummer und die Projekt-ID, werden in Firebase und Google Cloud gemeinsam verwendet.

• Jede Ressourcenhierarchie, die auf Ihr Google Cloud-Projekt angewendet wird (z. B. Organisation, Ordner usw.), wird auch auf Ihr Firebase-Projekt angewendet.

• 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 zu einem vorhandenen Google Cloud-Projekt hinzufügen

Sie können einem vorhandenen Google Cloud-Projekt mit einer der folgenden Optionen Firebase hinzufügen. Prüfen Sie, ob Sie die erforderlichen Berechtigungen zum Hinzufügen von Firebase zum Projekt Google Cloud haben.

Beachten Sie, dass das Hinzufügen von Firebase zu einem vorhandenen Google Cloud-Projekt nicht rückgängig gemacht werden kann. Das heißt, Sie können Firebase nicht vollständig aus dem Google Cloud-Projekt entfernen. Weitere Informationen

Hinweis :Wenn Sie in einem Google Cloud-Projekt auf alle Firebase-Funktionen zugreifen und diese nutzen möchten, müssen Sie die Firebase-Nutzungsbedingungen akzeptieren. Weitere Informationen zu den Firebase-Nutzungsbedingungen

Firebase Console

1. Melden Sie sich in der Firebase-Konsole mit dem Konto an, das Ihnen Zugriff auf das vorhandene Google Cloud-Projekt gewährt.

2. Klicken Sie auf die Schaltfläche, um ein neues Firebase-Projekt zu erstellen.

3. Klicken Sie unten auf der Seite auf Firebase dem Google Cloud-Projekt hinzufügen.

4. Geben Sie im Textfeld den Projektnamen des vorhandenen Projekts ein und wählen Sie das Projekt aus der angezeigten Liste aus.

5. Klicken Sie auf Projekt öffnen.

6. Akzeptieren Sie die Nutzungsbedingungen von Firebase, wenn Sie dazu aufgefordert werden.

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

   Das Aktivieren der KI-Unterstützung in der Firebase-Konsole und in Google Analytics ist optional.

Firebase CLI

1. Installieren Sie das Firebase-CLI, falls noch nicht geschehen.

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

3. Führen Sie dazu diesen Befehl aus:

   firebase projects:addfirebase

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

Hinweis :Wenn Sie beim Versuch, einem vorhandenen Google Cloud-Projekt Firebase hinzuzufügen, den Fehler 403 PERMISSION_DENIED erhalten, haben Sie möglicherweise nicht die erforderlichen Berechtigungen oder die Firebase-Nutzungsbedingungen nicht akzeptiert.

REST API

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

2. Generieren Sie Ihr API-Zugriffstoken.

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

   Für diesen Aufruf benötigen Sie den Ressourcennamen Ihres Projekts.

Eine detaillierte Anleitung finden Sie im Firebase-Leitfaden unter Firebase-Projekt mit der Management REST API einrichten und verwalten im Abschnitt Firebase-Dienste zu Ihrem Projekt hinzufügen. Folgen Sie der Anleitung im Abschnitt Vorbereitung dieses Leitfadens.

Hinweis: Wenn Sie beim Versuch, einem vorhandenen Google Cloud-Projekt Firebase hinzuzufügen, den Fehler 403 PERMISSION_DENIED erhalten, haben Sie möglicherweise nicht die erforderlichen Berechtigungen oder die Firebase-Nutzungsbedingungen nicht akzeptiert.

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 mit der google_firebase_project-Ressource.

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

Hinweis: Wenn Sie beim Versuch, einem vorhandenen Google Cloud-Projekt Firebase hinzuzufügen, den Fehler 403 PERMISSION_DENIED erhalten, haben Sie möglicherweise nicht die erforderlichen Berechtigungen oder die Firebase-Nutzungsbedingungen nicht akzeptiert.

Häufig gestellte Fragen und Fehlerbehebung

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

Wenn Sie in einem Google Cloud-Projekt auf alle Firebase-Funktionen zugreifen und diese nutzen 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, tun Sie dies nur für Ihr Google-Konto. Die Akzeptanz erfolgt nicht auf Projektebene für alle Projektmitglieder.

Sie können die Firebase-Nutzungsbedingungen über die Firebase Console auf eine der folgenden Arten akzeptieren. Akzeptieren Sie die Nutzungsbedingungen, wenn Sie dazu aufgefordert werden.

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

• Öffnen Sie ein vorhandenes Firebase-Projekt in der Firebase Console. Das kann z. B. der Fall sein, wenn Sie von jemandem eingeladen wurden, Mitglied des Projekts (d. h. ein Prinzipal) zu werden.

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

Hinweis: Die Firebase-Nutzungsbedingungen können nicht über die Firebase CLI, die REST API oder Terraform akzeptiert werden. Dies ist nur über die Firebase-Konsole möglich.

Wichtig :Wenn Sie eine Offline-Variante der Google Cloud-Rahmenvereinbarung für die Nutzung bestimmter Firebase-Dienste mit demselben Google Cloud Platform-Konto abgeschlossen haben, gelten die Firebase-Nutzungsbedingungen nicht für Ihre Nutzung dieser Firebase-Dienste. In diesem Fall unterliegt Ihre Nutzung der Firebase-Dienste den Offline-Bedingungen.

Welche Berechtigungen sind erforderlich, um Firebase hinzuzufügen?

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 Seite „Labels“ der Google Cloud-Konsole das Label firebase:enabled.

Wenn Sie das Label firebase:enabled manuell Ihrer Liste von Projektlabels hinzufügen, werden dadurch jedoch NICHT Firebase-spezifische Konfigurationen und Dienste für Ihr Google Cloud-Projekt aktiviert. Dazu müssen Sie Firebase hinzufügen. Verwenden Sie dazu die Firebase Console oder für erweiterte Anwendungsfälle 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 bestehenden Google Cloud-Projekt Firebase hinzufügen, werden folgende Aktionen ausgeführt, um die Verwendung aller Firebase-Dienste und ‑Schnittstellen zu vereinfachen:

• Fügt das firebase:enabled-Label auf der Seite Labels der Google Cloud-Konsole hinzu.

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

• Erstellt die folgenden Dienstkonten:

  • [e-mail]
  • 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

Kann ich Firebase aus einem Projekt entfernen?

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

Durch das Hinzufügen von Firebase werden APIs und Backend-Dienste aktiviert, die möglicherweise für andere Google Cloud-Funktionen verwendet werden. Wenn Sie alle diese aktivierten Dienste deaktivieren, kann das 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.

Achtung :Wenn Sie die Vorgänge, die während des Hinzufügens von Firebase ausgeführt wurden, manuell deaktivieren und löschen möchten, gehen Sie dabei äußerst vorsichtig vor. Sie müssen sich absolut sicher sein, dass in Ihrem Google Cloud-Projekt und den mit dem Projekt verknüpften Apps nichts verwendet wird, was Sie deaktivieren und löschen. Andernfalls funktioniert Ihr Projekt oder Ihre App möglicherweise nicht mehr oder verhält sich unerwartet.

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

Sie können zwar nicht verhindern, dass einem vorhandenen Google Cloud-Projekt Firebase hinzugefügt wird, aber Sie können Folgendes tun:

Beschränken Sie die Projektmitglieder (d. h. die Hauptkonten), die die IAM-Berechtigung firebase.projects.update haben, die zum Hinzufügen von Firebase erforderlich ist.

Nächste Schritte

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

  • Firebase-Projekte – hier finden Sie kurze Übersichten zu wichtigen Konzepten im Zusammenhang mit Firebase-Projekten, einschließlich der Beziehung zu Google Cloud und der grundlegenden Hierarchie eines Projekts und seiner Apps und Ressourcen.

  • Allgemeine Best Practices für die Einrichtung von Firebase-Projekten – enthält allgemeine Best Practices auf hoher Ebene 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 verbinden Sie sie mit Firebase, um Firebase in Ihren Mobil- und Web-Apps zu verwenden: iOS+ | Android | Web | Flutter | Unity | C++.