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.

Wenn Sie eine Erweiterung installieren möchten, muss für Ihr Projekt der Blaze-Tarif (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

Fügen Sie Ihrem Projekt Firebase hinzu und führen Sie ein Upgrade 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 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
  • Ressourcen, die für die Erweiterung erstellt wurden (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

Für einige Erweiterungen sind vor der Verwendung erforderliche oder optionale Schritte erforderlich. 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-Ereignis-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 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 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