Wenn Sie Erweiterungen installieren oder verwalten möchten, müssen Sie eine der folgenden Rollen haben: Inhaber oder Bearbeiter oder Firebase-Administrator.
Installierte Erweiterungsinstanzen eines Projekts auflisten
Sie können eine Liste aller Instanzen der von Ihnen installierten Erweiterungen aufrufen.
Führen Sie den Befehl „extensions-list“ aus:
firebase ext:list --project=projectId-or-alias
Details und Konfiguration einer installierten Erweiterungs-Instanz aufrufen
Rufe in der Firebase-Konsole dein Firebase Extensions-Dashboard auf.
Klicken Sie auf der Karte der installierten Erweiterungs-Instanz auf Verwalten.
Installierte Erweiterungsinstanzen überwachen
In der Firebase-Konsole können Sie die Aktivitäten einer installierten Erweiterung überwachen, einschließlich Status, Nutzung und Protokollen.
Budgetbenachrichtigungen festlegen
Es ist generell empfehlenswert, Budgetbenachrichtigungen festzulegen. Sie können jedoch besonders wichtig sein, wenn Sie den Code einer anderen Partei in Ihrem Projekt ausführen lassen.
Richten Sie Budgetbenachrichtigungen für Ihr Firebase-Projekt ein.
Von Erweiterungen erstellte Funktionen ansehen
Rufen Sie in der Firebase-Konsole das Dashboard „Functions“ auf.
Auf dem Tab Dashboard sehen Sie die Funktionen von Firebase Extensions sowie alle anderen Funktionen, die Sie für Ihr Projekt bereitgestellt haben.
Von Erweiterungen erstellte Funktionen haben Namen im Format:
ext-extension-instance-id-functionName
Beispiel:
ext-awesome-task-simplifier-onUserCreate
Von Erweiterungen erstellte Cloud Scheduler Jobs ansehen
Öffnen Sie in der Google Cloud-Konsole die Seite Cloud Scheduler Ihres Projekts.
In der Jobliste sehen Sie die Cloud Scheduler-Jobs von Firebase Extensions sowie alle anderen Jobs, die Sie für Ihr Projekt erstellt haben.
Jobs, die von Erweiterungen erstellt wurden, haben Namen im folgenden Format:
firebase-ext-extension-instance-id-functionName
Beispiel:
firebase-ext-awesome-task-simplifier-doTask
Von Erweiterungen in die Warteschlange gestellte Cloud Tasks ansehen und verwalten
Einige Erweiterungen verwenden Cloud Tasks, um länger laufende Aufgaben auszuführen. Am häufigsten sind dies Verarbeitungsaufgaben, die zu verschiedenen Zeitpunkten im Lebenszyklus einer Erweiterung ausgeführt werden – bei der Installation, Neukonfiguration und nach Upgrades.
Diese Aufgaben werden normalerweise automatisch ausgeführt und abgeschlossen, ohne dass Sie eingreifen müssen. Wenn Sie die Aufgaben einer Erweiterung in der Warteschlange jedoch manuell verwalten möchten, z. B. die Warteschlange pausieren oder eine Aufgabe, die noch nicht gestartet wurde, daraus entfernen, gehen Sie so vor:
Öffnen Sie in der Firebase Console im Bereich Erweiterungen die Seite mit den Details zur Erweiterungs-Instanz.
Öffnen Sie auf der Detailseite den Abschnitt APIs und Ressourcen. Wenn die Erweiterung Cloud Tasks verwendet, ist der Abschnitt Cloud Tasks-Warteschlangen mit einem oder mehreren Einträgen vorhanden.
Klicken Sie für die Warteschlange, die Sie verwalten möchten, auf Warteschlange ansehen. Daraufhin wird in der Google Cloud Console die Seite „Warteschlangendetails“ geöffnet. Dort können Sie sich die Aufgaben in der Warteschlange ansehen, die Warteschlange pausieren, Aufgaben aus der Warteschlange entfernen usw. Weitere Informationen finden Sie in der Cloud Tasks-Dokumentation unter Warteschlangen und Aufgaben verwalten.
Von Erweiterungen erstellte Cloud Secret Manager-Secrets ansehen
Öffnen Sie die Seite Secret Manager Ihres Projekts in der Google Cloud-Konsole.
In der Liste „Secrets“ sehen Sie die für Firebase Extensions erstellten Secrets sowie alle anderen Secrets, die Sie für Ihr Projekt erstellt haben.
Von Erweiterungen erstellte Secrets haben Namen im folgenden Format:
ext-extension-instance-id-paramnName
Beispiel:
ext-awesome-task-simplifier-API_KEY
Secrets sind mit dem Schlüssel
firebase-extensions-managed
gekennzeichnet. Entfernen Sie dieses Label nur, wenn Sie nicht mehr möchten, dass Firebase das Secret verwaltet.
Prüfen, ob eine installierte Erweiterung fehlerfrei ist
Sie können alle Fehler von Funktionen (einschließlich der mit Firebase Extensions erstellten Fehler) in der Console prüfen.
Auf dem Tab Verfügbarkeit des Dashboards „Funktionen“ finden Sie eine Übersicht über Fehler und Leistungsinformationen für alle Funktionen in Ihrem Projekt.
Wenn Sie Informationen zu einer bestimmten Erweiterung ansehen möchten, verwenden Sie den Filter oben auf der Seite, um eine bestimmte Funktion auszuwählen.
Prüfen, wie oft eine installierte Erweiterung ausgeführt wird
Suchen Sie auf dem Tab Dashboard Ihres Dashboards „Funktionen“ nach der Funktion für die Firebase Extension, die Sie prüfen möchten.
Klicken Sie rechts neben dem Eintrag auf
(das Dreipunkt-Menü) und wählen Sie Detaillierte Nutzungsstatistiken aus.In der angezeigten Google Cloud-Konsole können Sie verschiedene Aufrufe einer Funktion aufschlüsseln und sogar den Quellcode prüfen.
Logs für eine Erweiterung ansehen
Wenn Sie Ihr Projekt debuggen oder einen Fehlerbericht an Firebase senden möchten, ist es hilfreich, sich Protokolle der in Ihrem Projekt ausgeführten Funktionen anzusehen.
Wählen Sie auf dem Tab Protokolle Ihres Dashboards für Funktionen mit dem Filter oben auf der Seite die Funktionen aus, die von Ihrer Erweiterung erstellt wurden.
Eine installierte Erweiterungs-Instanz auf die neueste Version aktualisieren
Sie können eine installierte Instanz einer Erweiterung auf die neueste veröffentlichte Version aktualisieren. Möglicherweise möchten Sie eine installierte Instanz aktualisieren, da sie bereits aktiv ausgeführt oder in Ihrem Test-, Projekt- oder Anwendungsworkflow eingerichtet wird.
Wenn Sie eine Instanz aktualisieren, werden alle erweiterungsspezifischen Ressourcen und die Logik der Instanz überschrieben, um den Quellcode und die Dateien der neuen Version zu verwenden. Die Instanz-ID und das Dienstkonto der Erweiterung ändern sich nicht.
Während des Aktualisierungsvorgangs werden Sie über alle Änderungen an der neuen Version informiert und können Werte für alle neuen Parameter angeben.
Rufen Sie Ihr Firebase Extensions-Dashboard auf und klicken Sie auf der Karte der installierten Erweiterungs-Instanz auf Verwalten.
Klicken Sie rechts oben auf Erweiterung aktualisieren.
Wenn für die Erweiterung keine neue Version verfügbar ist, gibt es auf der Detailseite keine Schaltfläche zum Aktualisieren.
Sehen Sie sich die Neuigkeiten im Update an und konfigurieren Sie die Erweiterung bei Bedarf.
Klicken Sie auf Erweiterung aktualisieren.
Eine installierte Erweiterungsinstanz neu konfigurieren
Sie können die Werte der vom Nutzer konfigurierten Parameter für eine installierte Erweiterungs-Instanz ändern. Diese neuen Werte werden in allen zukünftigen Triggern der Instanz verwendet, aber alle vorherigen Artefakte oder Strukturelemente, die durch die Erweiterung erstellt wurden (z. B. gespeicherte Bilder oder vorhandene Storage-Buckets), bleiben unverändert.
Rufen Sie Ihr Firebase Extensions-Dashboard auf und klicken Sie auf der Karte der installierten Erweiterungs-Instanz auf Verwalten.
Klicken Sie rechts oben auf Erweiterung neu konfigurieren.
Folgen Sie der Anleitung auf dem Bildschirm, um die Parameterwerte für Ihre Erweiterung neu zu konfigurieren.
Klicken Sie auf Speichern.
Erweiterungsinstanzen deinstallieren
Sie können eine Instanz einer Erweiterung aus Ihrem Firebase-Projekt deinstallieren. Dadurch werden das Dienstkonto und alle Ressourcen (z. B. eine Reihe von Funktionen) gelöscht, die Firebase speziell für diese Instanz der Erweiterung erstellt hat. Folgendes wird jedoch nicht gelöscht:
Alle von der Erweiterung erstellten Artefakte (z. B. gespeicherte Bilder)
Alle anderen Ressourcen in Ihrem Projekt, z. B. eine Datenbankinstanz oder ein Cloud Storage-Bucket. Selbst wenn die Erweiterung mit diesen anderen Ressourcen interagiert hat, sind sie nicht erweiterungsspezifisch. Daher werden sie bei der Deinstallation der Erweiterung nicht gelöscht.
So deinstallieren Sie eine Erweiterung:
Rufen Sie das Firebase Extensions-Dashboard auf und klicken Sie auf der Karte der installierten Erweiterungsinstanz auf Verwalten.
Klicken Sie unten auf dem Bildschirm auf Erweiterung deinstallieren.
Prüfen Sie, was gelöscht wird, und klicken Sie dann auf Erweiterung deinstallieren, um den Löschvorgang zu bestätigen.