Catch up on highlights from Firebase at Google I/O 2023. Learn more

Zarządzaj zainstalowanymi rozszerzeniami Firebase

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

Zobacz szczegóły i konfigurację zainstalowanej instancji rozszerzenia

  1. Przejdź do pulpitu nawigacyjnego rozszerzeń Firebase w konsoli Firebase.

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

Monitoruj zainstalowaną instancję rozszerzenia

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

Ustaw alerty dotyczące budżetu

Ustawianie alertów budżetowych jest ogólnie dobrą praktyką, ale alerty mogą być szczególnie ważne, gdy ufasz, że kod innej firmy będzie działał w Twoim projekcie.

Upewnij się, że skonfigurowałeś alerty budżetowe dla swojego projektu Firebase.

Zobacz funkcje utworzone przez rozszerzenia

  1. Przejdź do pulpitu nawigacyjnego Functions w konsoli Firebase.

  2. Na karcie Pulpit nawigacyjny możesz wyświetlić funkcje rozszerzeń Firebase (wraz z innymi funkcjami wdrożonymi w projekcie).

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

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

Zobacz zadania Cloud Scheduler utworzone przez rozszerzenia

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

  2. Na liście Zadania możesz przeglądać zadania Cloud Scheduler z Firebase Extensions (obok innych zadań utworzonych dla Twojego projektu).

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

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

Przeglądaj zadania w chmurze kolejkowane przez rozszerzenia i zarządzaj nimi

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

Zwykle te zadania są uruchamiane i wykonywane automatycznie, bez Twojej interwencji. Jeśli jednak kiedykolwiek zajdzie potrzeba ręcznego zarządzania kolejkowanymi zadaniami rozszerzenia — na przykład wstrzymania kolejki lub usunięcia z kolejki zadania, które jeszcze się nie rozpoczęło — wykonaj następujące kroki:

  1. W sekcji Rozszerzenia konsoli Firebase otwórz stronę szczegółów instancji rozszerzenia.

  2. Na stronie szczegółów otwórz sekcję API i zasoby . Jeśli rozszerzenie korzysta z zadań w chmurze, będzie dostępna sekcja kolejek zadań w chmurze z co najmniej jednym wpisem.

  3. Kliknij Wyświetl kolejkę dla kolejki, którą chcesz zarządzać. Spowoduje to otwarcie strony Szczegóły kolejki w Google Cloud Console, na której możesz przeglądać zadania w kolejce, wstrzymywać kolejkę, usuwać zadania z kolejki itd. Zobacz Zarządzanie kolejkami i zadaniami w dokumentacji Cloud Tasks.

Zobacz wpisy tajne Cloud Secret Manager utworzone przez rozszerzenia

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

  2. Na liście Sekrety możesz przeglądać sekrety utworzone dla rozszerzeń Firebase (obok wszelkich innych sekretów utworzonych dla Twojego projektu).

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

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

    Sekrety są oznaczone kluczem firebase-extensions-managed . Nie usuwaj tej etykiety, chyba że chcesz uniemożliwić Firebase zarządzanie kluczem tajnym.

Sprawdź, czy zainstalowane rozszerzenie jest w dobrej kondycji

Możesz przejrzeć wszystkie błędy funkcji (w tym utworzone przez Firebase Extensions) w konsoli.

  1. Na karcie Kondycja pulpitu nawigacyjnego funkcji możesz wyświetlić przegląd błędów i informacje o wydajności wszystkich funkcji w projekcie.

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

Sprawdź, jak często działa zainstalowane rozszerzenie

  1. Na karcie Pulpit nawigacyjny na pulpicie nawigacyjnym funkcji znajdź konkretną funkcję rozszerzenia Firebase, którą chcesz sprawdzić.

  2. Kliknij (przepełnione menu) po prawej stronie wpisu, a następnie wybierz opcję Szczegółowe statystyki użytkowania .

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

Wyświetl dzienniki rozszerzenia

Jeśli próbujesz debugować swój projekt lub przesyłasz raport o błędzie do Firebase, warto przejrzeć dzienniki funkcji uruchomionych w twoim projekcie.

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

Zaktualizuj zainstalowaną instancję rozszerzenia do najnowszej wersji

Zainstalowane wystąpienie rozszerzenia można zaktualizować do jego najnowszej wydanej wersji. Możesz chcieć zaktualizować zainstalowaną instancję, ponieważ instancja jest już aktywnie uruchomiona lub skonfigurowana w przepływie pracy testowania, projektu lub aplikacji.

Gdy aktualizujesz instancję, wszystkie zasoby i logika specyficzne dla instancji są zastępowane, aby korzystać z kodu źródłowego i plików nowej wersji. Identyfikator instancji rozszerzenia i konto usługi nie ulegną zmianie.

Podczas procesu aktualizacji zostaniesz powiadomiony o wszelkich zmianach dotyczących nowej wersji i będziesz mógł określić wartości dla dowolnych nowych parametrów.

  1. Przejdź do pulpitu rozszerzeń Firebase , a następnie na karcie zainstalowanej instancji rozszerzenia kliknij Zarządzaj .

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

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

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

  4. Kliknij Aktualizuj rozszerzenie .

Ponownie skonfiguruj zainstalowaną instancję rozszerzenia

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

  1. Przejdź do pulpitu rozszerzeń Firebase , 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 swojego numeru wewnętrznego.

  4. Kliknij Zapisz .

Odinstaluj wystąpienie rozszerzenia

Możesz odinstalować wystąpienie rozszerzenia z projektu Firebase. Ta czynność usuwa konto usługi i wszystkie zasoby (takie jak zestaw funkcji), które Firebase utworzyła specjalnie dla tego wystąpienia rozszerzenia. Nie usuwa się jednak:

  • Wszelkie artefakty utworzone przez rozszerzenie (takie jak przechowywane obrazy).

  • Wszelkie inne zasoby w Twoim projekcie, takie jak instancja bazy danych lub zasobnik Cloud Storage. 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.

Oto jak odinstalować rozszerzenie:

  1. Przejdź do pulpitu rozszerzeń Firebase , 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.