Zarządzanie zainstalowanymi rozszerzeniami w Firebase

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

Wyświetlanie listy zainstalowanych instancji rozszerzeń w projekcie

Możesz wyświetlić listę wszystkich instancji zainstalowanych rozszerzeń.

Uruchom polecenie extensions-list:

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

Wyświetlanie szczegółów i konfiguracji zainstalowanej instancji rozszerzenia

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

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

Monitorowanie zainstalowanej instancji rozszerzenia

W konsoli Firebase możesz monitorować aktywność zainstalowanego rozszerzenia, w tym sprawdzać jego stan, wykorzystanie i logi.

Konfigurowanie alertów budżetu

Konfigurowanie alertów budżetu to ogólnie dobra praktyka, ale alerty mogą być szczególnie ważne, gdy powierzasz kod innej firmy do uruchomienia w swoim projekcie.

Upewnij się, że masz skonfigurowane alerty budżetu dla projektu w Firebase.

Wyświetlanie funkcji utworzonych przez rozszerzenia

1. Otwórz panel Funkcje w konsoli Firebase.

2. Na karcie Panel możesz wyświetlić funkcje z Firebase Extensions (obok innych funkcji wdrożonych w projekcie).

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

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

Wyświetlanie zadań Cloud Scheduler utworzonych przez rozszerzenia

1. W konsoli Google Cloud otwórz stronę Cloud Scheduler projektu.

2. Na liście Zadania możesz wyświetlić zadania Cloud Scheduler z Firebase Extensions (obok innych zadań utworzonych w projekcie).

   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 dodanych do kolejki przez rozszerzenia i zarządzanie nimi

Niektóre rozszerzenia używają Cloud Tasks do wykonywania zadań długotrwałych, najczęściej zadań przetwarzania, które są uruchamiane w różnych momentach cyklu życia rozszerzenia – podczas instalacji, ponownej konfiguracji i po uaktualnieniu.

Zwykle te zadania są wykonywane i kończone automatycznie, bez Twojej interwencji. Jeśli jednak kiedykolwiek będziesz musiał ręcznie zarządzać zadaniami w kolejce rozszerzenia (np. wstrzymać kolejkę lub usunąć z niej zadanie, które jeszcze się nie rozpoczęło), wykonaj te czynności:

1. W konsoli Firebase w sekcji Rozszerzenia otwórz stronę z informacjami o instancji rozszerzenia.

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

3. W przypadku kolejki, którą chcesz zarządzać, kliknij Wyświetl kolejkę. Spowoduje to otwarcie strony z informacjami o kolejce w konsoli Google Cloud, na której możesz wyświetlać zadania w kolejce, wstrzymywać kolejkę, usuwać z niej zadania itp. Więcej informacji znajdziesz w dokumentacji Cloud Tasks w sekcji Zarządzanie kolejkami i zadaniami.

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

1. W konsoli Google Cloud otwórz stronę Secret Manager projektu.

2. Na liście Obiekty tajne możesz wyświetlić obiekty tajne utworzone dla Firebase Extensions (obok innych obiektów tajnych utworzonych w projekcie).

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

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

   Obiekty tajne są oznaczone etykietą firebase-extensions-managed. Nie usuwaj tej etykiety, chyba że chcesz, aby Firebase przestało zarządzać obiektem tajnym.

Sprawdzanie, czy zainstalowane rozszerzenie jest w dobrym stanie

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

1. Na karcie Stan 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 jest uruchamiane zainstalowane rozszerzenie

1. Na karcie Panel panelu Funkcje, znajdź konkretną funkcję rozszerzenia Firebase Extension, którą chcesz sprawdzić.

2. Po prawej stronie wpisu kliknij more_vert (rozszerzone menu), a następnie wybierz Szczegółowe statystyki wykorzystania.

3. W wyświetlonej Google Cloud konsoli możesz szczegółowo sprawdzić różne wywołania funkcji, a nawet jej kod źródłowy.

Wyświetlanie logów rozszerzenia

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

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

Aktualizowanie zainstalowanej instancji rozszerzenia do najnowszej wersji

Zainstalowaną instancję rozszerzenia możesz zaktualizować do najnowszej opublikowanej wersji. Możesz zaktualizować zainstalowaną instancję, ponieważ jest ona już aktywnie uruchomiona lub skonfigurowana w testowaniu, projekcie lub przepływie pracy aplikacji.

Podczas aktualizacji wszystkie zasoby i logika specyficzne dla instancji rozszerzenia zostaną zastąpione kodem źródłowym i plikami nowej wersji. Identyfikator instancji i konto usługi rozszerzenia 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 Extensionsdashboard, a następnie na karcie zainstalowanej instancji rozszerzenia kliknij Zarządzaj.

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

   Jeśli rozszerzenie nie ma dostępnej nowej wersji, na stronie z informacjami nie będzie przycisku aktualizacji.

3. Sprawdź, co nowego zawiera aktualizacja, i skonfiguruj rozszerzenie (jeśli to konieczne).

4. Kliknij Zaktualizuj rozszerzenie.

Ponowne konfigurowanie zainstalowanej instancji rozszerzenia

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

1. Otwórz panel Firebase Extensionsdashboard, a następnie na karcie zainstalowanej instancji rozszerzenia kliknij Zarządzaj.

2. W prawym górnym rogu kliknij Zmień konfigurację rozszerzenia.

3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby ponownie skonfigurować wartości parametrów rozszerzenia.

4. Kliknij Zapisz.

Odinstalowywanie instancji rozszerzenia

Możesz odinstalować instancję rozszerzenia z projektu w Firebase. Ta czynność powoduje usunięcie konta usługi i wszystkich zasobów (np. zestawu funkcji), które Firebase utworzyło specjalnie dla tej instancji rozszerzenia. Jednak nie są usuwane:

• artefakty utworzone przez rozszerzenie (np. zapisane obrazy);

• inne zasoby w projekcie, takie jak instancja bazy danych lub Cloud Storage zasobnik. Nawet jeśli rozszerzenie wchodziło w interakcję z tymi innymi zasobami, nie są one specyficzne dla rozszerzenia, więc nie są usuwane po odinstalowaniu rozszerzenia.

Aby odinstalować rozszerzenie:

1. Otwórz panel Firebase Extensionsdashboard, a następnie na karcie zainstalowanej instancji 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.