Verwalten Sie installierte Firebase-Erweiterungen

Um Erweiterungen zu installieren oder zu verwalten, muss Ihnen eine dieser Rollen zugewiesen sein: Besitzer oder Herausgeber oder Firebase-Administrator .

Details und Konfiguration einer installierten Erweiterungsinstanz anzeigen

  1. Gehen Sie in der Firebase-Konsole zu Ihrem Firebase Extensions-Dashboard .

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

Überwachen Sie eine installierte Erweiterungsinstanz

In der Firebase-Konsole können Sie die Aktivität einer installierten Erweiterung überwachen, einschließlich Überprüfungen ihres Zustands, ihrer Nutzung und Protokolle.

Legen Sie Budgetwarnungen fest

Das Festlegen von Budgetwarnungen ist im Allgemeinen eine bewährte Vorgehensweise. Warnungen können jedoch besonders wichtig sein, wenn Sie darauf vertrauen, dass der Code einer anderen Partei in Ihrem Projekt ausgeführt wird.

Stellen Sie sicher, dass Sie Budgetbenachrichtigungen für Ihr Firebase-Projekt einrichten.

Durch Erweiterungen erstellte Funktionen anzeigen

  1. Gehen Sie zu Ihrem Funktions-Dashboard der Firebase-Konsole.

  2. Auf der Registerkarte „Dashboard“ können Sie die Funktionen von Firebase Extensions anzeigen (zusammen mit allen anderen Funktionen, die Sie für Ihr Projekt bereitgestellt haben).

    Durch Erweiterungen erstellte Funktionen haben Namen im Format: ext- extension-instance-id - functionName

    Zum Beispiel: ext-awesome-task-simplifier-onUserCreate

Von Erweiterungen erstellte Cloud Scheduler-Jobs anzeigen

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

  2. In der Jobliste können Sie die Cloud Scheduler-Jobs von Firebase Extensions anzeigen (neben allen anderen Jobs, die Sie für Ihr Projekt erstellt haben).

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

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

Von Erweiterungen in die Warteschlange gestellte Cloud-Aufgaben anzeigen und verwalten

Einige Erweiterungen verwenden Cloud Tasks , um länger laufende Aufgaben auszuführen: Am häufigsten werden Aufgaben verarbeitet, die an verschiedenen Punkten im Lebenszyklus einer Erweiterung ausgeführt werden – Installation, Neukonfiguration und nach Upgrades.

Normalerweise werden diese Aufgaben ohne Ihr Eingreifen automatisch ausgeführt und abgeschlossen. Wenn Sie jedoch jemals die in der Warteschlange befindlichen Aufgaben einer Erweiterung manuell verwalten müssen, beispielsweise um die Warteschlange anzuhalten oder eine noch nicht gestartete Aufgabe aus der Warteschlange zu entfernen, führen Sie die folgenden Schritte aus:

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

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

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

Von Erweiterungen erstellte Cloud Secret Manager-Geheimnisse anzeigen

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

  2. In der Secrets-Liste können Sie die für Firebase Extensions erstellten Secrets anzeigen (zusammen mit allen anderen Secrets, die Sie für Ihr Projekt erstellt haben).

    Von Erweiterungen erstellte Geheimnisse haben Namen im Format: ext- extension-instance-id - paramnName

    Zum Beispiel: ext-awesome-task-simplifier-API_KEY

    Geheimnisse werden mit dem Schlüssel firebase-extensions-managed gekennzeichnet. Entfernen Sie diese Bezeichnung nicht, es sei denn, Sie möchten verhindern, dass Firebase das Geheimnis verwaltet.

Überprüfen Sie, ob eine installierte Erweiterung fehlerfrei ist

Sie können alle Fehler von Funktionen (einschließlich der von Firebase Extensions erstellten) in der Konsole überprüfen.

  1. Auf der Registerkarte „Zustand“ Ihres Funktions-Dashboards können Sie eine Übersicht über Fehler und Leistungsinformationen für alle Funktionen in Ihrem Projekt anzeigen.

  2. Um Informationen für eine bestimmte Erweiterung anzuzeigen, verwenden Sie den Filter oben auf der Seite, um eine bestimmte Funktion auszuwählen.

Überprüfen Sie, wie oft eine installierte Erweiterung ausgeführt wird

  1. Suchen Sie auf der Registerkarte „Dashboard“ Ihres Funktions-Dashboards nach der spezifischen Funktion für die Firebase-Erweiterung, die Sie überprüfen möchten.

  2. Klicken Sie ganz rechts im Eintrag auf (das Überlaufmenü) und wählen Sie dann Detaillierte Nutzungsstatistiken aus.

  3. In der angezeigten Google Cloud-Konsole können Sie einen Drilldown zu verschiedenen Aufrufen einer Funktion durchführen und sogar deren Quellcode überprüfen.

Sehen Sie sich die Protokolle für eine Erweiterung an

Wenn Sie versuchen, Ihr Projekt zu debuggen oder einen Fehlerbericht an Firebase zu senden, ist es hilfreich, Protokolle der in Ihrem Projekt ausgeführten Funktionen anzuzeigen.

Verwenden Sie auf der Registerkarte „Protokolle“ Ihres Funktions-Dashboards den Filter oben auf der Seite, um die von Ihrer Erweiterung erstellten Funktionen auszuwählen.

Aktualisieren Sie eine installierte Erweiterungsinstanz auf die neueste Version

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 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 ändern sich nicht.

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

  1. Gehen Sie zu Ihrem Firebase Extensions-Dashboard und klicken Sie dann auf der Karte der installierten Erweiterungsinstanz auf Verwalten .

  2. Klicken Sie in der oberen rechten Ecke auf „Erweiterung aktualisieren“ .

    Wenn für die Erweiterung keine neue Version verfügbar ist, verfügt die Detailseite nicht über eine Schaltfläche zum Aktualisieren.

  3. Überprüfen Sie, was im Update neu ist, und konfigurieren Sie die Erweiterung (falls erforderlich).

  4. Klicken Sie auf Erweiterung aktualisieren .

Konfigurieren Sie eine installierte Erweiterungsinstanz neu

Sie können die Werte der vom Benutzer konfigurierten Parameter für eine installierte Erweiterungsinstanz ändern. Diese neuen Werte werden in allen zukünftigen Triggern der Instanz verwendet, aber alle vorherigen Artefakte oder Strukturelemente, die von der Erweiterung erstellt wurden (wie gespeicherte Bilder oder vorhandene Speicher-Buckets), werden nicht geändert.

  1. Gehen Sie zu Ihrem Firebase Extensions-Dashboard und klicken Sie dann auf der Karte der installierten Erweiterungsinstanz auf Verwalten .

  2. Klicken Sie in der oberen rechten Ecke auf Erweiterung neu konfigurieren .

  3. Befolgen Sie die Anweisungen auf dem Bildschirm, um die Parameterwerte für Ihre Nebenstelle neu zu konfigurieren.

  4. Klicken Sie auf Speichern .

Deinstallieren Sie eine Erweiterungsinstanz

Sie können eine Instanz einer Erweiterung aus Ihrem Firebase-Projekt deinstallieren. Diese Aktion löscht das Dienstkonto und alle Ressourcen (z. B. eine Reihe von Funktionen), 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, sind sie nicht erweiterungsspezifisch und werden daher nicht gelöscht, wenn die Erweiterung deinstalliert wird.

So deinstallieren Sie eine Erweiterung:

  1. Gehen Sie zu Ihrem Firebase Extensions-Dashboard und klicken Sie dann auf der Karte der installierten Erweiterungsinstanz auf Verwalten .

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

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