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.

Firebase Console Firebase CLI Automatisch generiertes SDK

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

   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. Am häufigsten sind dies Verarbeitungsaufgaben, die zu verschiedenen Zeitpunkten im Lebenszyklus einer Erweiterung ausgeführt werden – bei der Installation, Neukonfiguration und nach Upgrades.

Normalerweise werden diese Aufgaben automatisch und ohne Ihr Zutun ausgeführt. 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, gibt es den Abschnitt Cloud Tasks-Warteschlangen mit einem oder mehreren Einträgen.

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.

   Hinweis: Sie können eine Warteschlange pausieren. Wenn Sie sie jedoch zu lange pausieren, können Aufgaben beim Fortsetzen der Warteschlange mit Authentifizierungsfehlern fehlschlagen. Die Aufgabenauthentifizierung läuft eine Stunde nach dem Einfügen in die Warteschlange ab.
   Warnung:Löschen Sie die Warteschlange nicht. Sie ist für die Funktion der Erweiterung erforderlich. Wenn Sie die Warteschlange versehentlich löschen, gehen Sie so vor:

   1. Installieren Sie eine neue Instanz der Erweiterung.
   2. Deinstallieren Sie die alte Instanz erst nach der Installation der neuen Instanz.

Von Erweiterungen erstellte Cloud Secret Manager-Secrets aufrufen

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

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 intakt ist

Sie können alle Fehler von Funktionen (einschließlich der von Firebase Extensions erstellten) 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 aufrufen 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 des Dashboards für Funktionen mit dem Filter oben auf der Seite die von Ihrer Erweiterung erstellten Funktionen aus.

Eine installierte Erweiterungs-Instanz auf die neueste Version aktualisieren

Sie können eine installierte Instanz einer Erweiterung auf die neueste veröffentlichte Version aktualisieren. Sie können eine installierte Instanz aktualisieren, wenn sie bereits aktiv ausgeführt 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 Befehlszeile.

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, wird auf der Detailseite keine Schaltfläche zum Aktualisieren angezeigt.

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. Alle vorherigen Artefakte oder strukturellen Elemente, 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 Befehlszeile.

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.

Hinweis :Es kann 3 bis 5 Minuten dauern, bis die Änderungen für eine Erweiterung im System gespeichert sind.

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

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