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
Falls noch nicht geschehen, fügen Sie Firebase zu Ihrem Projekt hinzu .
Wenn Sie dies noch nicht getan haben, aktualisieren Sie Ihr Projekt auf den Blaze- Plan (Pay-as-you-go).
Installieren oder aktualisieren Sie die neueste Version der Firebase-CLI.
Notieren Sie sich entweder Ihre Firebase-Projekt-ID oder den zuvor konfigurierten Projektalias.
- Projekt-ID – Führen Sie
firebase projects:list
von überall auf Ihrem Computer aus. - Projektalias – Führen Sie
firebase use
in Ihrem lokalen App-Verzeichnis aus.
- Projekt-ID – Führen Sie
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:
Stellen Sie sicher, dass Sie Ihre Umgebung eingerichtet und eine Erweiterung ausgewählt haben.
Führen Sie den Befehl „extension-info“ von einer beliebigen Stelle auf Ihrem Computer aus:
firebase ext:info publisher-id/extension-id
Die Argumente
publisher-id
undextension-id
sind erforderlich und können auf der Seite mit den Vorinstallationsdetails der Erweiterung gefunden werden.
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.
Stellen Sie sicher, dass Sie Ihre Umgebung eingerichtet und eine Erweiterung ausgewählt haben.
Führen Sie in Ihrem lokalen Firebase-Verzeichnis den Befehl „extension-install“ aus. Geben Sie bei Aufforderung Parameterwerte ein, um die Erweiterungsinstanz anzupassen.
firebase ext:install publisher-id/extension-id --project=projectId-or-alias
Die Argumente
publisher-id
undextension-id
sind erforderlich und können auf der Seite mit den Vorinstallationsdetails der Erweiterung gefunden werden.Wenn Sie diesen Befehl ausführen, wird Ihrem Erweiterungsmanifest eine Erweiterungsinstanz hinzugefügt.
Führen Sie dann Folgendes aus, um die Erweiterungen in Ihrem Manifest in einem Firebase-Projekt bereitzustellen:
firebase deploy --only extensions --project=projectId-or-alias
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 mithilfe der Firebase-CLI. Sie können Ihre Erweiterung neu konfigurieren oder deinstallieren sowie Ihre Erweiterung auf die neueste Version aktualisieren.
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.