Installierte Firebase Extensions verwalten

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

  1. Rufe in der Firebase-Konsole dein Firebase Extensions-Dashboard auf.

  2. 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

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

  2. 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

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

  2. 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:

  1. Öffnen Sie in der Firebase Console im Bereich Erweiterungen die Seite mit den Details zur Erweiterungs-Instanz.

  2. Ö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.

  3. 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

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

  2. 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.

  1. Auf dem Tab Verfügbarkeit des Dashboards „Funktionen“ finden Sie eine Übersicht über Fehler und Leistungsinformationen für alle Funktionen in Ihrem Projekt.

  2. 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

  1. Suchen Sie auf dem Tab Dashboard Ihres Dashboards „Funktionen“ nach der Funktion für die Firebase Extension, die Sie prüfen möchten.

  2. Klicken Sie rechts neben dem Eintrag auf  (das Dreipunkt-Menü) und wählen Sie 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 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.

  1. Rufen Sie Ihr Firebase Extensions-Dashboard auf und klicken Sie auf der Karte der installierten Erweiterungs-Instanz auf Verwalten.

  2. 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.

  3. Sehen Sie sich die Neuigkeiten im Update an und konfigurieren Sie die Erweiterung bei Bedarf.

  4. 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.

  1. Rufen Sie Ihr Firebase Extensions-Dashboard auf und klicken Sie 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.

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:

  1. Rufen Sie das Firebase Extensions-Dashboard auf und klicken Sie auf der Karte der installierten Erweiterungsinstanz 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.