Firebase-Erweiterung installieren

Sie können alle offiziellen Firebase-Erweiterungen über die Firebase-Konsole, die Firebase-Befehlszeile oder ein automatisch generiertes SDK installieren und verwalten.

Sehen Sie sich die Unterschiede bei den unterstützten Aktionen für die einzelnen Installationsmethoden an.



Wenn Sie Erweiterungen installieren oder verwalten möchten, muss Ihnen eine der folgenden Rollen zugewiesen sein: Inhaber oder Bearbeiter oder Firebase-Administrator.

Damit Sie eine Erweiterung installieren können, muss Ihr Projekt im Blaze-Tarif (Pay as you go) sein. Die Installation einer Erweiterung ist zwar kostenlos, aber für die Nutzung von Firebase- oder Cloud-Diensten wie Cloud Secret Manager können Gebühren anfallen, wenn die Nutzung die kostenlose Stufe der Dienste übersteigt.

Hinweis

Falls noch nicht geschehen, fügen Sie Ihrem Projekt Firebase hinzu und führen Sie ein Upgrade Ihres Firebase-Projekts auf den Blaze-Tarif (Pay as you go) durch.

Schritt 1: Detaillierte Informationen zu einer Erweiterung aufrufen

Dieser Schritt ist optional, wird aber dringend empfohlen.

Bevor Sie eine Firebase Extension installieren, sollten Sie sich detaillierte Informationen zur Erweiterung ansehen, z. B.:

  • Funktionsweise der Erweiterung, Vorinstallationsaufgaben und Details zur Erweiterung
  • Allgemeine Identifikationsinformationen und Beschreibung
  • Ob für die Aufgaben der Erweiterung ein Rechnungskonto erforderlich ist
  • Für den Betrieb erforderliche Google-Dienste (APIs) und Zugriffsrollen
  • Ressourcen, die für die Erweiterung erstellt wurden (z. B. Funktionen)
  • Beschreibungen der nutzerkonfigurierbaren Parameter

So rufen Sie die detaillierten Informationen zu einer Erweiterung auf:

  1. Offizielle Firebase-Erweiterungen finden Sie im Extensions Hub.

  2. Klicken Sie auf die Karte einer Erweiterung, um:

Schritt 2: Erweiterung installieren

Während der Installation werden Sie aufgefordert, die grundlegenden Spezifikationen der Erweiterung zu prüfen, z. B. aktivierte APIs, erstellte Ressourcen und gewährter Zugriff. Sie werden über alle Abrechnungsanforderungen informiert und aufgefordert, Werte für die konfigurierbaren Parameter der Erweiterung anzugeben.

  1. Offizielle Firebase-Erweiterungen finden Sie im Extensions Hub.

  2. Klicken Sie auf die Karte einer Erweiterung und sehen Sie sich die detaillierten Informationen zur Erweiterung an. Dort finden Sie möglicherweise spezifische Anleitungen zur Verwendung und Aufgaben, die vor der Installation ausgeführt werden müssen.

  3. Klicken Sie auf Installieren und folgen Sie der Anleitung auf dem Bildschirm, um die Erweiterung zu installieren.

Schritt 3: Einrichtung nach der Installation abschließen

Bei einigen Erweiterungen müssen Sie vor der Verwendung erforderliche oder optionale Schritte ausführen. Diese Anleitung finden Sie auf der Seite mit den Details nach der Installation Ihrer Erweiterung im Extensions-Dashboard der Firebase-Konsole. Der spezifische Link zum Dashboard wird nach der Installation im Terminal angezeigt.

Sie finden diese Anleitung auch in der Datei POSTINSTALL.md, die im Quellverzeichnis der Erweiterung enthalten ist.

Firebase-Ressourcen erstellen

Wenn Sie die Erweiterung so konfiguriert haben, dass Firebase-Ressourcen (Cloud Firestore-Sammlungen, Realtime Database-Pfade, Cloud Storage-Buckets) verwendet werden, die noch nicht vorhanden sind, erstellen Sie sie, bevor Sie die Erweiterung verwenden.

Eventarc-Event-Handler erstellen

Einige Erweiterungen werden in Eventarc veröffentlicht, wenn während der Ausführung wichtige Ereignisse eintreten. Wenn eine Erweiterung Ereignisse veröffentlicht und Sie Ereignisse bei der Installation aktiviert haben, können Sie Funktionen schreiben, die mit Ihrer eigenen benutzerdefinierten Logik auf diese Ereignisse reagieren. Das kann beispielsweise nützlich sein, um Nutzer zu benachrichtigen, wenn lang andauernde Aufgaben abgeschlossen sind, oder um die Ausgabe einer Erweiterungsfunktion nachzubearbeiten.

In der Dokumentation der Erweiterung finden Sie eine Liste der veröffentlichten Ereignisse (falls vorhanden). Weitere Informationen finden Sie beispielsweise in den Ereignistypen für die Erweiterung „Run Payments with Stripe“.

Informationen zum Schreiben von Eventarc-Event-Handlern finden Sie unter Benutzerdefinierte Ereignistrigger.

Mehrere Erweiterungsinstanzen installieren

Sie können dieselbe Erweiterung mehrmals im selben Projekt installieren. Jede installierte Instanz kann eine eigene benutzerdefinierte Konfiguration und eigene Erweiterungsressourcen haben. Jede installierte Instanz wird anhand ihrer Instanz-ID identifiziert und referenziert. Diese ist innerhalb Ihres Projekts eindeutig.

Sie werden aufgefordert, die Instanz-ID jeder zusätzlichen Instanz der Erweiterung, die Sie installieren, zu bestätigen oder zu bearbeiten.

Nächste Schritte