Zarządzanie zainstalowanymi rozszerzeniami w Firebase

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

Wyświetlanie listy zainstalowanych instancji rozszerzeń projektu

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 Firebase Extensionspanel w konsoli Firebase.

2. Na karcie zainstalowanego rozszerzenia kliknij Zarządzaj.

Monitorowanie zainstalowanej instancji rozszerzenia

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

Konfigurowanie alertów budżetu

Ustawianie alertów budżetowych jest ogólnie dobrą praktyką, ale alerty mogą być szczególnie ważne, gdy w projekcie używasz kodu innej firmy.

Upewnij się, że masz skonfigurowane alerty budżetowe w projekcie Firebase.

Wyświetlanie funkcji utworzonych przez rozszerzenia

1. Otwórz panel funkcji w konsoli Firebase.

2. Na karcie Panel możesz wyświetlić funkcje z Firebase Extensions (oraz inne funkcje wdrożone 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. Otwórz stronę Cloud Scheduler projektu w Google Cloud konsoli.

2. Na liście Zadania możesz wyświetlić zadania Cloud Scheduler z Firebase Extensions (oraz inne zadania utworzone 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 umieszczonych w kolejce przez rozszerzenia i zarządzanie nimi

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

Zwykle te zadania są wykonywane automatycznie bez Twojej interwencji. Jeśli jednak chcesz 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 sekcji Rozszerzenia konsoli Firebase otwórz stronę szczegółów instancji rozszerzenia.

2. Na stronie szczegółów 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. Kliknij Wyświetl kolejkę obok kolejki, którą chcesz zarządzać. Spowoduje to otwarcie strony Szczegóły kolejki 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 artykule Zarządzanie kolejkami i zadaniami w dokumentacji Cloud Tasks.

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

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

2. Na liście wpisów tajnych możesz wyświetlić wpisy tajne utworzone dla Firebase Extensions (wraz z innymi wpisami tajnymi utworzonymi dla Twojego projektu).

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

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

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

Sprawdzanie, czy zainstalowane rozszerzenie działa prawidłowo

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

1. Na karcie Stan w panelu funkcji 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ć określoną funkcję.

Sprawdzanie, jak często działa zainstalowane rozszerzenie

1. Na karcie Panel w panelu funkcji znajdź konkretną funkcję, dla której chcesz sprawdzić Firebase Extension.

2. Kliknij more_vert (menu dodatkowe) po prawej stronie wpisu, a następnie wybierz Szczegółowe statystyki wykorzystania.

3. W wyświetlonej konsoli Google Cloud możesz szczegółowo przeanalizować różne wywołania 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 Dzienniki na panelu funkcji 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 ramach testowania, projektu lub przepływu pracy aplikacji.

Gdy zaktualizujesz instancję, wszystkie zasoby i logika specyficzne dla rozszerzenia zostaną zastąpione kodem źródłowym i plikami nowej wersji. Identyfikator instancji rozszerzenia i konto usługi nie ulegną zmianie.

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

1. Otwórz Firebase Extensions panel, a potem 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 szczegółów nie będzie przycisku aktualizacji.

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

4. Kliknij Zaktualizuj rozszerzenie.

Zmiana konfiguracji zainstalowanej instancji rozszerzenia

Możesz zmieniać 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 zasobniki pamięci) nie zostaną zmienione.

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

2. W prawym górnym rogu kliknij Ponownie skonfiguruj rozszerzenie.

3. Aby ponownie skonfigurować 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. Ta czynność spowoduje usunięcie konta usługi i wszystkich zasobów (np. zestawu funkcji), które Firebase utworzył specjalnie dla tej instancji rozszerzenia. Nie zostaną jednak usunięte te elementy:

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

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

Aby odinstalować rozszerzenie:

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

2. U dołu ekranu kliknij Odinstaluj rozszerzenie.

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