Zarządzaj zainstalowanymi rozszerzeniami Firebase

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

Wyświetl listę zainstalowanych instancji rozszerzeń projektu

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

Uruchom polecenie extensions-list:

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

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

Ustawienie alertów budżetowych jest ogólnie dobrą praktyką, ale alerty mogą być szczególnie ważne, gdy ufasz, że kod innej firmy zostanie uruchomiony w Twoim projekcie.

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

Zobacz funkcje stworzone przez rozszerzenia

  1. Przejdź do panelu funkcji w konsoli Firebase.

  2. Na karcie Pulpit nawigacyjny możesz wyświetlić funkcje z 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

Wyświetl zadania Cloud Scheduler utworzone przez rozszerzenia

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

  2. Na liście zadań możesz wyświetlić zadania Cloud Scheduler z Rozszerzeń Firebase (wraz z innymi zadaniami utworzonymi dla Twojego projektu).

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

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

Wyświetl klucze tajne Cloud Secret Manager utworzone przez rozszerzenia

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

  2. Na liście obiektów tajnych możesz wyświetlić obiekty tajne utworzone dla rozszerzeń Firebase (wraz z innymi obiektami tajnymi utworzonymi dla projektu).

    Sekrety tworzone 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 sprawne

Możesz przejrzeć wszystkie błędy funkcji (w tym te utworzone przez rozszerzenia Firebase) 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ć określoną funkcję.

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

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

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

  3. W wyświetlanej konsoli Google Cloud Console możesz zagłębić się w różne wywołania 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 wyświetlić dzienniki funkcji uruchomionych w projekcie.

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

Zaktualizuj zainstalowaną instancję rozszerzenia do najnowszej wersji

Możesz zaktualizować zainstalowane wystąpienie rozszerzenia 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.

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

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

  1. Aby zaktualizować wystąpienie rozszerzenia w manifeście rozszerzeń do najnowszej wersji, uruchom polecenie extension update:

    firebase ext:update extensionInstanceId

    Aby zaktualizować do określonej wersji, podaj wersję, do której chcesz zaktualizować:

    firebase ext:update extensionInstanceId versionNumber
  2. Następnie, aby wdrożyć rozszerzenia z manifestu w projekcie Firebase, uruchom:

    firebase deploy --only extensions --project=projectId-or-alias

Ponownie skonfiguruj zainstalowaną instancję rozszerzenia

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

  1. Aby interaktywnie ponownie skonfigurować rozszerzenie w manifeście rozszerzeń , uruchom polecenie extension configure:

    firebase ext:configure extensionInstanceId
  2. Następnie, aby wdrożyć rozszerzenia z manifestu w projekcie Firebase, uruchom:

    firebase deploy --only extensions --project=projectId-or-alias

Odinstaluj instancję rozszerzenia

Możesz odinstalować wystąpienie rozszerzenia z projektu Firebase. Ta czynność powoduje usunięcie konta usługi i wszystkich zasobów (takich jak zestaw funkcji) utworzonych przez Firebase specjalnie dla tego wystąpienia rozszerzenia. Nie usuwa się jednak:

  • Wszelkie artefakty utworzone przez rozszerzenie (np. zapisane 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 związane z rozszerzeniem , więc nie są usuwane po odinstalowaniu rozszerzenia.

Oto jak odinstalować rozszerzenie:

  1. Aby usunąć wystąpienie rozszerzenia z manifestu rozszerzeń , uruchom polecenie odinstaluj rozszerzenie:

    firebase ext:uninstall extensionInstanceId
  2. Następnie, aby wdrożyć zmiany z manifestu w projekcie Firebase, uruchom:

    firebase deploy --only extensions --project=projectId-or-alias