Installierte Firebase Extensions verwalten

Zum Installieren oder Verwalten von Erweiterungen muss Ihnen eine der folgenden Rollen zugewiesen sein: Inhaber oder Bearbeiter oder Firebase-Administrator.


Installierte Erweiterungsinstanzen eines Projekts auflisten

Sie können alle Instanzen der von Ihnen installierten Erweiterungen auflisten.

Führen Sie den Befehl extensions-list aus:

firebase ext:list --project=projectId-or-alias

Details und Konfiguration einer installierten Erweiterungsinstanz ansehen

  1. Rufen Sie in der Firebase Konsole das Firebase Extensions Dashboard auf.

  2. Klicken Sie auf der Karte der installierten Erweiterungsinstanz auf Verwalten.

Installierte Erweiterungsinstanz überwachen

In der Firebase Konsole können Sie die Aktivität einer installierten Erweiterung überwachen, einschließlich Prüfungen auf Status, Nutzung und Logs.

Budgetbenachrichtigungen festlegen

Das Festlegen von Budgetbenachrichtigungen ist im Allgemeinen eine gute Idee. Sie sind aber besonders wichtig, wenn Sie Code einer anderen Partei in Ihrem Projekt ausführen lassen.

Richten Sie Budgetbenachrichtigungen für Ihr Firebase-Projekt ein.

Von Erweiterungen erstellte Funktionen ansehen

  1. Rufen Sie in der Firebase Konsole das Functions-Dashboard auf.

  2. Auf dem Tab Dashboard können Sie die Funktionen von Firebase Extensions zusammen mit allen anderen Funktionen sehen, 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

  1. Öffnen Sie in der Google Cloud Konsole die Cloud Scheduler Seite Ihres Projekts.

  2. In der Liste „Jobs“ können Sie die Cloud Scheduler Jobs von Firebase Extensions zusammen mit allen anderen Jobs sehen, die Sie für Ihr Projekt erstellt haben.

    Von Erweiterungen erstellte Jobs haben Namen im Format: firebase-ext-extension-instance-id-functionName

    Beispiel: firebase-ext-awesome-task-simplifier-doTask

Von Erweiterungen in die Warteschlange gestellte Cloud Tasks-Aufgaben ansehen und verwalten

Einige Erweiterungen verwenden Cloud Tasks um länger laufende Aufgaben auszuführen. Das sind meistens Verarbeitungsaufgaben, die an verschiedenen Punkten im Lebenszyklus einer Erweiterung ausgeführt werden, z. B. bei der Installation, Neukonfiguration und nach Upgrades.

Normalerweise werden diese Aufgaben automatisch ausgeführt und abgeschlossen, ohne dass Sie eingreifen müssen. Wenn Sie die in die Warteschlange gestellten Aufgaben einer Erweiterung jedoch manuell verwalten müssen, z. B. um die Warteschlange anzuhalten oder eine Aufgabe aus der Warteschlange zu entfernen, die noch nicht gestartet wurde, gehen Sie so vor:

  1. Öffnen Sie im Bereich „Erweiterungen“ der Firebase Konsole die Detailseite der Erweiterungsinstanz.

  2. Öffnen Sie auf der Detailseite den APIs und Ressourcen Bereich. Wenn die Erweiterung Cloud Tasks verwendet, gibt es einen Bereich Cloud Tasks-Warteschlangen mit einem oder mehreren Einträgen.

  3. Klicken Sie für die Warteschlange, die Sie verwalten möchten, auf Warteschlange ansehen. Dadurch wird die Seite „Warteschlangendetails“ in der Google Cloud Console geöffnet. Hier können Sie in die Warteschlange gestellte Aufgaben ansehen, die Warteschlange anhalten, Aufgaben aus der Warteschlange entfernen usw. Weitere Informationen finden Sie unter Warteschlangen und Aufgaben in der Cloud Tasks-Dokumentation verwalten.

Von Erweiterungen erstellte Cloud Secret Manager-Secrets ansehen

  1. Öffnen Sie in der Google Cloud Console die Secret Manager-Seite Ihres Projekts.

  2. In der Liste „Secrets“ können Sie die für Firebase Extensions erstellten Secrets zusammen mit allen anderen Secrets sehen, die Sie für Ihr Projekt erstellt haben.

    Von Erweiterungen erstellte Secrets haben Namen im 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.

Status einer installierten Erweiterung prüfen

Sie können alle Fehler von Funktionen (einschließlich der von Firebase Extensions) in der Konsole ansehen.

  1. Auf dem Tab Status des Functions-Dashboards finden Sie eine Übersicht über Fehler und Leistungsinformationen für alle Funktionen in Ihrem Projekt.

  2. Wenn Sie Informationen zu einer bestimmten Erweiterung sehen möchten, wählen Sie oben auf der Seite mit dem Filter eine bestimmte Funktion aus.

Prüfen, wie oft eine installierte Erweiterung ausgeführt wird

  1. Suchen Sie auf dem Tab Dashboard Ihres Functions-Dashboards die spezifische Funktion für die Firebase Extension, die Sie prüfen möchten.

  2. Klicken Sie ganz rechts neben dem Eintrag auf „“ (das Dreipunkt-Menü) und wählen Sie dann Detaillierte Nutzungsstatistiken aus.

  3. 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 Fehler in Ihrem Projekt beheben oder einen Fehlerbericht an Firebase senden möchten, ist es hilfreich, die Logs der in Ihrem Projekt ausgeführten Funktionen anzusehen.

Wählen Sie auf dem Tab Logs des Functions-Dashboards oben auf der Seite mit dem Filter die Funktionen aus, die von Ihrer Erweiterung erstellt wurden.

Installierte Erweiterungsinstanz auf die neueste Version aktualisieren

Sie können eine installierte Instanz einer Erweiterung auf die neueste veröffentlichte Version aktualisieren. Das kann sinnvoll sein, wenn die Instanz bereits aktiv ausgeführt wird oder in Ihrem Test-, Projekt- oder App-Workflow eingerichtet ist.

Wenn Sie eine Instanz aktualisieren, werden alle erweiterungsspezifischen Ressourcen und Logik der Instanz überschrieben, um den Quellcode und die Dateien der neuen Version zu verwenden. Die Instanz-ID und das Dienstkonto der Erweiterung bleiben unverändert.

Während des Aktualisierungsvorgangs werden Sie über alle Änderungen für die neue Version informiert und können Werte für alle neuen Parameter angeben.

  1. Rufen Sie das Firebase Extensions Dashboard auf und klicken Sie dann auf der Karte der installierten Erweiterungsinstanz auf Verwalten.

  2. Klicken Sie rechts oben auf Erweiterung aktualisieren.

    Wenn für die Erweiterung keine neue Version verfügbar ist, enthält die Detailseite keine Schaltfläche zum Aktualisieren.

  3. Prüfen Sie die Neuerungen im Update und konfigurieren Sie die Erweiterung bei Bedarf.

  4. Klicken Sie auf Erweiterung aktualisieren.

Installierte Erweiterungsinstanz neu konfigurieren

Sie können die Werte der vom Nutzer konfigurierten Parameter für eine installierte Erweiterungsinstanz ändern. Diese neuen Werte werden in allen zukünftigen Triggern der Instanz verwendet. Alle vorherigen Artefakte oder Strukturelemente, die von der Erweiterung erstellt wurden (z. B. gespeicherte Bilder oder vorhandene Storage-Buckets), bleiben jedoch unverändert.

  1. Rufen Sie das Firebase Extensions Dashboard auf und klicken Sie dann auf der Karte der installierten Erweiterungs instanz auf Verwalten.

  2. Klicken Sie rechts oben auf Erweiterung neu konfigurieren.

  3. Folgen Sie der Anleitung auf dem Bildschirm, um die Parameterwerte für Ihre Erweiterung neu zu konfigurieren.

  4. Klicken Sie auf Speichern.

Erweiterungsinstanz 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. Auch wenn die Erweiterung mit diesen anderen Ressourcen interagiert hat, sind sie nicht erweiterungsspezifisch und werden daher nicht gelöscht, wenn die Erweiterung deinstalliert wird.

So deinstallieren Sie eine Erweiterung:

  1. Rufen Sie das Firebase Extensions Dashboard auf und klicken Sie dann auf der Karte der installierten Erweiterungs instanz auf Verwalten.

  2. Klicken Sie unten auf dem Bildschirm auf Erweiterung deinstallieren.

  3. Prüfen Sie, was gelöscht wird, und klicken Sie dann auf Erweiterung deinstallieren , um den Löschvorgang zu bestätigen.