Zarządzaj zainstalowanymi rozszerzeniami Firebase

Aby instalować rozszerzenia lub zarządzać nimi, musisz mieć przypisaną jedną z następujących ról: Właściciel, Edytor lub Administrator Firebase .

Wyświetl szczegóły i konfigurację zainstalowanej instancji rozszerzenia

  1. Przejdź do panelu 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 logi.

Ustaw alerty budżetowe

Ustawianie alertów budżetowych jest ogólnie dobrą praktyką, ale alerty mogą być szczególnie ważne, jeśli ufasz, że kod innej strony będzie uruchamiany w Twoim projekcie.

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

Wyświetl funkcje utworzone przez rozszerzenia

  1. Przejdź do panelu funkcji w konsoli Firebase.

  2. Na karcie Panel kontrolny możesz przeglądać funkcje z rozszerzeń Firebase (wraz z innymi funkcjami wdrożonymi w Twoim projekcie).

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

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

Wyświetl zadania Cloud Scheduler utworzone przez rozszerzenia

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

  2. Na liście Zadania możesz przeglądać zadania Cloud Scheduler z rozszerzeń Firebase (wraz z innymi zadaniami utworzonymi 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

Wyświetlaj zadania w chmurze kolejkowane przez rozszerzenia i zarządzaj nimi

Niektóre rozszerzenia wykorzystują Zadania w chmurze do wykonywania dłuższych zadań: najczęściej przetwarzania zadań uruchamianych w różnych momentach cyklu życia rozszerzenia — instalacji, rekonfiguracji i po aktualizacjach.

Zwykle zadania te są uruchamiane i kończone automatycznie, bez Twojej interwencji. Jeśli jednak kiedykolwiek będziesz musiał ręcznie zarządzać zadaniami umieszczonymi w kolejce rozszerzenia — na przykład aby wstrzymać kolejkę lub usunąć z kolejki zadanie, 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ę Interfejsy API i zasoby . Jeśli rozszerzenie korzysta z Cloud Tasks, pojawi się sekcja kolejek Cloud Task z jednym lub większą liczbą wpisów.

  3. Kliknij opcję 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 przeglądać zadania w kolejce, wstrzymywać kolejkę, usuwać zadania z kolejki i tak dalej. Zobacz Zarządzanie kolejkami i zadaniami w dokumentacji Cloud Tasks.

Wyświetl sekrety Cloud Secret Manager utworzone przez rozszerzenia

  1. Otwórz stronę Menedżera tajnych obiektów swojego projektu w konsoli Google Cloud.

  2. Na liście Sekrety możesz przeglądać sekrety utworzone dla rozszerzeń Firebase (wraz z innymi sekretami utworzonymi 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 sekretem.

Sprawdź, czy zainstalowane rozszerzenie jest w dobrym stanie

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

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

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

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

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

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

  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świetl logi rozszerzenia

Jeśli próbujesz debugować swój projekt lub przesłać raport o błędzie do Firebase, przydatne jest przejrzenie dzienników funkcji uruchomionych w 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

Możesz zaktualizować zainstalowaną instancję rozszerzenia do najnowszej wydanej wersji. Możesz chcieć zaktualizować zainstalowaną instancję, ponieważ instancja jest już aktywnie uruchomiona lub skonfigurowana w przepływie pracy związanym z testowaniem, projektem lub aplikacją.

Kiedy aktualizujesz instancję, wszystkie zasoby i logika specyficzne dla rozszerzenia instancji są zastępowane w celu użycia kodu źródłowego i plików nowej wersji. Identyfikator instancji rozszerzenia i konto usługi nie ulegną zmianie.

Podczas procesu aktualizacji będziesz powiadamiany o wszelkich zmianach w nowej wersji i będziesz mógł określić wartości nowych parametrów.

  1. Przejdź do panelu 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. Przejrzyj nowości w aktualizacji i skonfiguruj rozszerzenie (w razie potrzeby).

  4. Kliknij Aktualizuj rozszerzenie .

Skonfiguruj ponownie zainstalowaną instancję rozszerzenia

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

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

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

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

  4. Kliknij Zapisz .

Odinstaluj instancję rozszerzenia

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

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

  • Wszelkie inne zasoby w 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 zostaną usunięte w przypadku odinstalowania rozszerzenia.

Oto jak odinstalować rozszerzenie:

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

  2. Na dole ekranu kliknij Odinstaluj rozszerzenie .

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