Firebase-Erweiterung installieren

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

Lesen Sie die Unterschiede bei den unterstützten Aktionen für jede Installationsmethode.



Wenn Sie Erweiterungen installieren oder verwalten möchten, müssen Sie eine der folgenden Rollen haben: Inhaber oder Bearbeiter oder Firebase-Administrator.

Damit Sie eine Erweiterung installieren können, muss für Ihr Projekt der Tarif Blaze (Pay as you go) verwendet werden. Die Installation einer Erweiterung ist kostenlos. Es können jedoch Kosten für die Nutzung von Firebase-Diensten oder Cloud-Diensten wie Cloud Secret Manager anfallen, wenn Ihre Nutzung die kostenlose Stufe der Dienste überschreitet.

Hinweis

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

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 ausführliche Informationen zur Erweiterung ansehen, darunter:

  • Funktionsweise der Erweiterung, alle Aufgaben vor der Installation und Details zur Erweiterung
  • Allgemeine Informationen zur Identifizierung und Beschreibung
  • Ob für die Aufgaben der Erweiterung ein Rechnungskonto erforderlich ist
  • Für den Betrieb erforderliche Google-Dienste (APIs) und Zugriffsrollen
  • Für die Erweiterung erstellte Ressourcen (z. B. Funktionen)
  • Beschreibungen der von Nutzern konfigurierbaren Parameter

So rufen Sie die Details einer Erweiterung auf:

  1. Offizielle Firebase-Erweiterungen findest du im Extensions Hub.

  2. Wenn Sie auf die Karte einer Erweiterung klicken, haben Sie folgende Möglichkeiten:

Schritt 2: Erweiterung installieren

Während der Installation werden Sie aufgefordert, die grundlegenden Spezifikationen für die Erweiterung zu überprüfen, z. B. ob APIs aktiviert, Ressourcen erstellt und Zugriff gewährt wurden. Sie werden über alle Abrechnungsanforderungen informiert und aufgefordert, Werte für die konfigurierbaren Parameter der Erweiterung anzugeben.

  1. Offizielle Firebase-Erweiterungen findest du im Extensions Hub.

  2. Klicken Sie auf die Karte einer Erweiterung und lesen Sie die detaillierten Informationen dazu. Dort finden Sie möglicherweise eine spezifische Anleitung zur Verwendung und Informationen zu vorbereitenden Aufgaben.

  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 bestimmte oder optionale Schritte ausführen, bevor Sie sie verwenden können. Diese Anleitung finden Sie auf der Seite mit den Details Ihrer Erweiterung im Extensions-Dashboard der Firebase-Konsole nach der Installation. Der Link zum Dashboard wird nach der Installation im Terminal angezeigt.

Diese Anleitung finden Sie auch in der Datei POSTINSTALL.md im Quellverzeichnis der Erweiterung.

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 diese, bevor Sie die Erweiterung verwenden.

Eventarc-Event-Handler erstellen

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

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

Weitere Informationen zum Erstellen von Eventarc-Ereignis-Handlern finden Sie unter Benutzerdefinierte Ereignistrigger.

Mehrere Erweiterungsinstanzen installieren

Sie können dieselbe Erweiterung mehrmals in dasselbe Projekt installieren. Jede installierte Instanz kann eine eigene benutzerdefinierte Konfiguration und eigene Erweiterungsressourcen haben. Sie identifizieren und verweisen auf jede installierte Instanz anhand ihrer Instanz-ID, die innerhalb Ihres Projekts eindeutig ist.

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

Nächste Schritte