Installierte Firebase Extensions verwalten

Wenn Sie Erweiterungen installieren oder verwalten möchten, muss Ihnen eine der folgenden Rollen zugewiesen sein: Inhaber oder Bearbeiter oder Firebase-Administrator.

Firebase-Konsole Firebase-Befehlszeile Automatisch generiertes SDK

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 Console 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äten einer installierten Erweiterung überwachen, einschließlich der Überprüfung von Status, Nutzung und Logs.

Budgetbenachrichtigungen festlegen

Budgetbenachrichtigungen sind generell eine gute Idee, aber sie können 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 das Funktions-Dashboard der Firebase-Konsole auf.

2. Auf dem Tab Dashboard können Sie die Funktionen aus Firebase Extensions sowie alle 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

Cloud Scheduler-Jobs ansehen, die von Erweiterungen erstellt wurden

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

2. In der Jobliste können Sie die Cloud Scheduler-Jobs aus 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 ansehen und verwalten

Einige Erweiterungen verwenden Cloud Tasks, um länger laufende Aufgaben auszuführen. Das sind in der Regel Verarbeitungsaufgaben, die zu verschiedenen Zeitpunkten im Lebenszyklus einer Erweiterung ausgeführt werden – bei der Installation, bei der Neukonfiguration und nach Upgrades.

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

1. Öffnen Sie in der Firebase-Konsole im Bereich Erweiterungen die Detailseite der Erweiterungsinstanz.

2. Öffnen Sie auf der Detailseite den Bereich APIs und Ressourcen. Wenn die Erweiterung Cloud Tasks verwendet, gibt es einen Bereich Cloud Task queues (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-Konsole geöffnet. Dort können Sie Aufgaben in der Warteschlange ansehen, die Warteschlange anhalten, Aufgaben aus der Warteschlange entfernen usw. Weitere Informationen finden Sie in der Cloud Tasks-Dokumentation unter Warteschlangen und Aufgaben verwalten.

   Hinweis :Sie können eine Warteschlange pausieren. Wenn Sie sie jedoch zu lange pausiert lassen, können bei der Wiederaufnahme der Warteschlange Authentifizierungsfehler auftreten. Die Aufgabenauthentifizierung läuft eine Stunde nach dem Eintreffen in der Warteschlange ab.
   Warnung:Löschen Sie die Warteschlange nicht. Die Erweiterung benötigt sie für den Betrieb. Wenn Sie die Warteschlange versehentlich löschen, müssen Sie so vorgehen:

   1. Installieren Sie eine neue Instanz der Erweiterung.
   2. Deinstallieren Sie die alte Instanz erst, nachdem Sie die neue installiert haben.

Von Erweiterungen erstellte Cloud Secret Manager-Secrets ansehen

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

2. In der Liste „Secrets“ können Sie die für Firebase Extensions erstellten Secrets sowie alle anderen Secrets sehen, 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 werden 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 funktioniert

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

1. Auf dem Tab Status Ihres 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 aufrufen möchten, wählen Sie oben auf der Seite eine bestimmte Funktion aus.

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

1. Suchen Sie auf dem Tab Dashboard Ihres Funktions-Dashboards nach der Funktion für 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 sich verschiedene Aufrufe einer Funktion genauer ansehen 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 die Logs der Funktionen anzusehen, die in Ihrem Projekt ausgeführt werden.

Verwenden Sie auf dem Tab Logs Ihres Funktions-Dashboards den Filter oben auf der Seite, um die von Ihrer Erweiterung erstellten Funktionen auszuwählen.

Installierte Erweiterungsinstanz auf die neueste Version aktualisieren

Sie können eine installierte Instanz einer Erweiterung auf die zuletzt veröffentlichte Version aktualisieren. Möglicherweise möchten Sie eine installierte Instanz aktualisieren, weil sie bereits aktiv ausgeführt wird oder in Ihrem Test-, Projekt- oder App-Workflow eingerichtet ist.

Hinweis: Wenn Sie eine Erweiterung mit einem automatisch generierten SDK installiert haben, verwenden Sie dieselbe Methode, um sie zu aktualisieren, und nicht die Console oder die CLI.

Wenn Sie eine Instanz aktualisieren, werden alle extensionspezifischen Ressourcen und die Logik der Instanz überschrieben, sodass der Quellcode und die Dateien der neuen Version verwendet werden. 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 Ihr 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, wird auf der Detailseite keine Schaltfläche zum Aktualisieren angezeigt.

3. Sehen Sie sich die Neuerungen im Update an 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 bei allen zukünftigen Triggern der Instanz verwendet. Alle vorherigen Artefakte oder Strukturelemente, die von der Erweiterung erstellt wurden (z. B. gespeicherte Bilder oder vorhandene Speicher-Buckets), werden jedoch nicht geändert.

Hinweis: Wenn Sie eine Erweiterung mit einem automatisch generierten SDK installiert haben, verwenden Sie dieselbe Methode, um sie neu zu konfigurieren, und nicht die Console oder die CLI.

1. Rufe dein Firebase Extensions-Dashboard auf und klicke auf der Karte der installierten Erweiterungsinstanz 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.

Hinweis :Es kann 3 bis 5 Minuten dauern, bis Änderungen an einer Erweiterung gespeichert werden.

Erweiterungsinstanz deinstallieren

Sie können eine Instanz einer Erweiterung aus Ihrem Firebase-Projekt deinstallieren. Bei dieser Aktion werden das Dienstkonto und alle Ressourcen (z. B. eine Reihe von Funktionen) gelöscht, die von Firebase speziell für diese Instanz der Erweiterung erstellt wurden. Die folgenden Elemente werden 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. Sie werden daher nicht gelöscht, wenn die Erweiterung deinstalliert wird.

So deinstallieren Sie eine Erweiterung:

1. Rufe dein Firebase Extensions-Dashboard auf und klicke 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.

Hinweis :Wenn Sie die Erweiterung mit dem automatisch generierten SDK installiert haben, müssen Sie auch die Instanzkonfiguration aus Ihrem Cloud Functions-Code entfernen.