Zarządzanie zainstalowanymi rozszerzeniami w Firebase

Aby instalować rozszerzenia lub nimi zarządzać, musisz mieć jedną z tych ról: Właściciel lub Edytujący lub Administrator Firebase.


Wyświetlanie listy zainstalowanych instancji rozszerzeń projektu

Możesz wyświetlić wszystkie instancje zainstalowanych rozszerzeń.

Uruchom polecenie extensions-list:

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

Wyświetlanie szczegółów i konfiguracji zainstalowanego wystąpienia rozszerzenia

  1. Otwórz panel Firebase Extensions w konsoli Firebase.

  2. Na karcie instancji zainstalowanego rozszerzenia kliknij Zarządzaj.

Monitorowanie zainstalowanej instancji rozszerzenia

W konsoli Firebase możesz monitorować aktywność zainstalowanego rozszerzenia, w tym sprawdzać jego stan, sposób używania i dzienniki.

Konfigurowanie alertów budżetu

Ustawianie alertów dotyczących budżetu jest ogólnie dobrą praktyką, ale alerty mogą być szczególnie ważne, gdy ufasz, że kod innej osoby jest uruchamiany w Twoim projekcie.

Sprawdź, czy w projekcie Firebase masz skonfigurowane alerty dotyczące budżetu.

Wyświetlanie funkcji utworzonych przez rozszerzenia

  1. Otwórz panel Functions w konsoli Firebase.

  2. Na karcie Panel możesz wyświetlić funkcje z Firebase Extensions (oraz inne funkcje wdrożone w Twoim projekcie).

    Funkcje utworzone przez rozszerzenia mają nazwy w formacie:ext-extension-instance-id-functionName

    Na przykład: ext-awesome-task-simplifier-onUserCreate

Wyświetl Cloud Scheduler zadań utworzonych przez rozszerzenia

  1. Otwórz stronę Cloud Scheduler projektu w konsoli Google Cloud.

  2. Na liście Zadania możesz wyświetlić zadania Cloud Scheduler z Firebase Extensions (oraz inne zadania utworzone przez Ciebie w ramach projektu).

    Zadania utworzone przez rozszerzenia mają nazwy w formacie:firebase-ext-extension-instance-id-functionName

    Na przykład: firebase-ext-awesome-task-simplifier-doTask

Wyświetlanie zadań Cloud Tasks umieszczonych w kolejce przez rozszerzenia i zarządzanie nimi

Niektóre rozszerzenia korzystają z zdań w chmurze do wykonywania dłuższych zadań. Najczęściej są to zadania przetwarzania, które są wykonywane w różnych punktach cyklu życia rozszerzenia: instalacji, rekonfiguracji i po uaktualnieniu.

Zwykle te zadania są wykonywane automatycznie, bez Twojej ingerencji. Jeśli jednak chcesz ręcznie zarządzać zadaniami oczekującymi w kole rozszerzenia (np. wstrzymać kolejkę lub usunąć z niej zadanie, które jeszcze się nie rozpoczęło), wykonaj te czynności:

  1. W konsoli Firebase otwórz sekcję Extensions i przejdź na stronę szczegółów instancji rozszerzenia.

  2. Na stronie z informacjami otwórz sekcję Interfejsy API i zasoby. Jeśli rozszerzenie korzysta z Cloud Tasks, pojawi się sekcja Kolejek Cloud Tasks z co najmniej 1 pozycją.

  3. Kliknij Wyświetl kolejkę obok kolejki, którą chcesz zarządzać. Otworzy się strona Szczegóły kolejki w konsoli Google Cloud, na której możesz wyświetlać kolejkowane zadania, wstrzymywać kolejkę, usuwać zadania z kolejki itp. Więcej informacji na temat zarządzania kolejkami i zadaniami znajdziesz w dokumentacji Cloud Tasks.

Wyświetlanie obiektów tajnych usługi Cloud Secret Manager utworzonych przez rozszerzenia

  1. Otwórz stronę Menedżer tajnych kluczy w konsoli Google Cloud.

  2. Na liście sekretów możesz wyświetlić sekrety utworzone dla Firebase Extensions (oraz inne sekrety utworzone przez Ciebie w ramach projektu).

    Obiekty tajne utworzone przez rozszerzenia mają nazwy w formacie:ext-extension-instance-id-paramnName

    Na przykład: ext-awesome-task-simplifier-API_KEY

    Tajne obiekty są oznaczone kluczem firebase-extensions-managed. Nie usuwaj tej etykiety, chyba że chcesz zatrzymać Firebase w zarządzaniu obiektem tajnym.

Sprawdzanie, czy zainstalowane rozszerzenie działa prawidłowo

W konsoli możesz sprawdzić wszystkie błędy funkcji (w tym te utworzone przez Firebase Extensions).

  1. Na karcie Stan w panelu Funkcje możesz wyświetlić przegląd błędów i informacji o wydajności wszystkich funkcji w projekcie.

  2. Aby wyświetlić informacje o konkretnym rozszerzeniu, użyj filtra u góry strony, aby wybrać konkretną funkcję.

Sprawdzanie, jak często działa zainstalowane rozszerzenie

  1. Na karcie Panel w panelu Funkcje odszukaj funkcję Firebase Extension, którą chcesz sprawdzić.

  2. Kliknij  (menu przepełnienia) po prawej stronie pozycji, a potem wybierz Szczegółowe statystyki wykorzystania.

  3. W wyświetlonej konsoli Google Cloud możesz przejść do różnych wywołań funkcji, a nawet sprawdzić jej kod źródłowy.

Wyświetlanie logów rozszerzenia

Jeśli próbujesz debugować projekt lub przesłać do Firebase raport o błędzie, warto wyświetlić logi funkcji działających w projekcie.

Na karcie Logi na panelu funkcji użyj filtra u góry strony, aby wybrać funkcje utworzone przez Twoje rozszerzenie.

Aktualizowanie zainstalowanej instancji rozszerzenia do najnowszej wersji

Zainstalowaną instancję rozszerzenia możesz zaktualizować do najnowszej wersji. Możesz chcieć zaktualizować zainstalowaną instancję, ponieważ jest ona już aktywna lub skonfigurowana w ramach testów, projektu lub przepływu pracy aplikacji.

Podczas aktualizowania instancji wszystkie zasoby i logika specyficzna dla rozszerzenia są zastępowane, aby używać kodu źródłowego i plików nowej wersji. Identyfikator instancji rozszerzenia i konto usługi nie ulegną zmianie.

Podczas procesu aktualizacji otrzymasz powiadomienie o wszelkich zmianach w nowej wersji i będziesz mieć możliwość określenia wartości nowych parametrów.

  1. Otwórz panel Firebase Extensions, a na karcie zainstalowanego rozszerzenia kliknij Zarządzaj.

  2. W prawym górnym rogu kliknij Zaktualizuj rozszerzenie.

    Jeśli rozszerzenie nie ma dostępnej nowej wersji, na stronie ze szczegółami nie będzie przycisku aktualizacji.

  3. Sprawdź, co nowego w aktualizacji, i skonfiguruj rozszerzenie (w razie potrzeby).

  4. Kliknij Zaktualizuj rozszerzenie.

Zmiana konfiguracji zainstalowanej instancji rozszerzenia

Możesz zmienić wartości parametrów skonfigurowanych przez użytkownika w przypadku zainstalowanej instancji rozszerzenia. Te nowe wartości będą używane w przyszłych aktywatorach instancji, ale wszystkie poprzednie artefakty lub elementy strukturalne utworzone przez rozszerzenie (np. zapisane obrazy lub istniejące kontenery) nie ulegną zmianie.

  1. Otwórz panel Firebase Extensions, a na karcie zainstalowanego rozszerzenia kliknij Zarządzaj.

  2. W prawym górnym rogu kliknij Skonfiguruj ponownie rozszerzenie.

  3. Aby zmienić konfigurację wartości parametrów rozszerzenia, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

  4. Kliknij Zapisz.

Odinstalowywanie instancji rozszerzenia

Możesz odinstalować instancję rozszerzenia z projektu Firebase. To działanie powoduje usunięcie konta usługi i wszystkich zasobów (np. zestawu funkcji), które Firebase utworzyło specjalnie dla tej instancji rozszerzenia. Jednak te elementy nie zostaną usunięte:

  • Artefakty utworzone przez rozszerzenie (np. zapisane obrazy).

  • inne zasoby w projekcie, takie jak instancja bazy danych czy folder Cloud Storage Nawet jeśli rozszerzenie wchodziło w interakcję z tymi innymi zasobami, nie są one specyficzne dla rozszerzenia, więc nie zostaną usunięte, jeśli rozszerzenie zostanie odinstalowane.

Aby odinstalować rozszerzenie:

  1. Otwórz panel Firebase Extensions, a na karcie zainstalowanego rozszerzenia kliknij Zarządzaj.

  2. U dołu ekranu kliknij Odinstaluj rozszerzenie.

  3. Sprawdź, co zostanie usunięte, a następnie kliknij Odinstaluj rozszerzenie, aby potwierdzić usunięcie.