Sie können jede der offiziellen Firebase-Erweiterungen entweder über die Firebase-Konsole oder die Firebase-CLI (Befehlszeilenschnittstelle) installieren (und verwalten ).
Überprüfen Sie unbedingt die Unterschiede bei den unterstützten Aktionen für die Firebase-CLI und die Firebase-Konsole.
Um Erweiterungen zu installieren oder zu verwalten, muss Ihnen eine dieser Rollen zugewiesen sein: Besitzer oder Herausgeber oder Firebase-Administrator .
Um eine Erweiterung zu installieren, muss Ihr Projekt im Blaze- Plan (Pay-as-you-go) enthalten sein. Obwohl für die Installation einer Erweiterung keine Kosten anfallen, können Ihnen für die Nutzung von Firebase-Diensten oder Cloud-Diensten wie Cloud Secret Manager Gebühren in Rechnung gestellt werden, wenn Ihre Nutzung das kostenlose Kontingent der Dienste überschreitet.
Bevor Sie beginnen
Wenn Sie dies noch nicht getan haben, fügen Sie Firebase zu Ihrem Projekt hinzu und aktualisieren Sie Ihr Firebase-Projekt auf den Blaze -Plan (Pay-as-you-go).
Schritt 1 : Detaillierte Informationen zu einer Erweiterung anzeigen
Dieser Schritt ist optional, wird aber dringend empfohlen.
Bevor Sie eine Firebase-Erweiterung installieren, empfehlen wir Ihnen, detaillierte Informationen zur Erweiterung zu lesen, darunter:
- Wie die Erweiterung funktioniert, alle Aufgaben vor der Installation und Details zur Erweiterung
- Allgemeine identifizierende Informationen 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 (wie Funktionen)
- Beschreibungen der vom Benutzer konfigurierbaren Parameter
So zeigen Sie detaillierte Informationen zu einer Erweiterung an:
Durchsuchen Sie die offiziellen Firebase-Erweiterungen im Extensions Hub .
Klicken Sie auf die Karte einer Erweiterung, um Folgendes zu tun:
Zeigen Sie die detaillierten Informationen zur Erweiterung an.
Den Link zum Quellcode der Erweiterung finden Sie im Quell-Repository von Firebase Extensions .
Im Erweiterungsverzeichnis der Erweiterung können Sie diese detaillierten Informationen in der
README
einsehen.
Schritt 2 : Installieren Sie eine Erweiterung
Während des Installationsvorgangs werden Sie aufgefordert, die grundlegenden Spezifikationen für die Erweiterung zu überprüfen (z. B. aktivierte APIs, erstellte Ressourcen , gewährter Zugriff usw.). Sie werden über alle Abrechnungsanforderungen informiert und aufgefordert, Werte für die konfigurierbaren Parameter der Erweiterung anzugeben.
Durchsuchen Sie die offiziellen Firebase-Erweiterungen im Extensions Hub .
Klicken Sie auf die Karte einer Erweiterung und sehen Sie sich dann die detaillierten Informationen zur Erweiterung an, die spezifische Nutzungsanweisungen und etwaige Vorinstallationsaufgaben enthalten können.
Klicken Sie auf „Installieren“ und befolgen Sie dann die Anweisungen auf dem Bildschirm, um die Erweiterung zu installieren.
Schritt 3 : Schließen Sie die Einrichtung nach der Installation ab
Bei einigen Erweiterungen müssen Sie vor der Verwendung erforderliche oder optionale Schritte ausführen. Diese Anweisungen finden Sie auf der Detailseite Ihrer Erweiterung nach der Installation im Erweiterungs-Dashboard der Firebase-Konsole (der spezifische Link zum Dashboard wird nach der Installation im Terminal angezeigt).
Sie finden diese Anweisungen auch in der Datei POSTINSTALL.md
, die im Quellverzeichnis der Erweiterung enthalten ist.
Erstellen Sie Firebase-Ressourcen
Wenn Sie die Erweiterung für die Verwendung von Firebase-Ressourcen (Cloud Firestore-Sammlungen, Echtzeitdatenbankpfade, Cloud Storage-Buckets) konfiguriert haben, die noch nicht vorhanden sind, erstellen Sie diese, bevor Sie die Erweiterung verwenden.
Erstellen Sie Eventarc-Ereignishandler
Einige Erweiterungen veröffentlichen auf 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 mit Ihrer eigenen benutzerdefinierten Logik Funktionen schreiben, die auf diese Ereignisse reagieren. Dies kann beispielsweise nützlich sein, um Benutzer zu benachrichtigen, wenn Aufgaben mit langer Laufzeit abgeschlossen sind, oder um die Ausgabe einer Erweiterungsfunktion nachzubearbeiten.
Eine Liste der von ihr veröffentlichten Ereignisse (falls vorhanden) finden Sie in der Dokumentation der Erweiterung. Sehen Sie sich beispielsweise die Ereignistypen für die Erweiterung „Run Payments with Stripe“ an.
Weitere Informationen zum Schreiben von Eventarc-Ereignishandlern finden Sie dann unter Benutzerdefinierte Ereignisauslöser .
Installieren Sie mehrere Erweiterungsinstanzen
Sie können dieselbe Erweiterung mehr als einmal im selben Projekt installieren. Jede installierte Instanz kann über eine eigene angepasste Konfiguration und eigene Erweiterungsressourcen verfügen. 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 weiteren Instanz der von Ihnen installierten Erweiterung zu bestätigen oder zu bearbeiten.
Nächste Schritte
Sehen Sie sich die Details und die Konfiguration Ihrer installierten Erweiterung in der Firebase-Konsole an.
Überwachen Sie die Aktivität Ihrer installierten Erweiterung, einschließlich Überprüfungen des Zustands, der Nutzung und der Protokolle.
Verwalten Sie Ihre installierte Erweiterung über die Firebase-Konsole. Bei offiziellen Firebase-Erweiterungen können Sie Ihre Erweiterung neu konfigurieren oder deinstallieren sowie Ihre Erweiterung auf die neueste Version aktualisieren.
Als Best Practice für alle Projekte stellen Sie sicher, dass Sie Budgetwarnungen für Ihr Projekt einrichten und Ihr Nutzungs- und Abrechnungs- Dashboard in der Firebase-Konsole überwachen.