Catch up on everthing we announced at this year's Firebase Summit. Learn more

Zarządzaj zainstalowanymi rozszerzeniami Firebase

Aby zainstalować lub zarządzać rozszerzeniami, musi być przypisana jedna z tych ról: Właściciel albo Editor lub Firebase Admin .

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 skonfigurować alerty budżetu dla projektu Firebase.

Zobacz funkcje stworzone przez rozszerzenia

  1. Przejdź do Functions dashboard konsoli Firebase.

  2. W zakładce Dashboard można wyświetlać funkcje z Firebase Extensions (obok innych funkcji, które zostały wdrożone do projektu).

    Funkcje stworzone 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 projekt w chmurze Harmonogram stronę w konsoli Google Cloud.

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

    Praca 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 swój projekt za Tajny Menedżer stronę w konsoli Google Cloud.

  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

    Tajemnice są oznakowane kluczowych 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. W zakładce Health swojej Funkcje deski rozdzielczej , można zobaczyć przegląd błędów oraz informacje o wydajności dla 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. W zakładce Dashboard swojej Funkcje desce rozdzielczej , znajdź funkcję specyficzną dla Firebase rozszerzenie, które chcesz sprawdzić.

  2. Kliknij (rozszerzone menu) po drugiej stronie prawej od wejścia, 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.

W zakładce Logs swojej Funkcje desce rozdzielczej , użyć filtru w górnej części strony, aby wybrać funkcje stworzone 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. Uruchom polecenie extensions-list, aby uzyskać identyfikator wystąpienia rozszerzenia:

    firebase ext:list --project=projectId-or-alias
  2. Uruchom polecenie aktualizacji rozszerzenia:

    firebase ext:update extensionInstanceId --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 zostaną wykorzystane w żadnym wyzwalaczy przyszłych instancji, ale wszystkie poprzednie artefakty lub elementy konstrukcyjne utworzone przez rozszerzenie (np zapisanych obrazów lub istniejących schowki) nie zostaną zmienione.

  1. Uruchom polecenie extensions-list, aby uzyskać identyfikator wystąpienia rozszerzenia:

    firebase ext:list --project=projectId-or-alias
  2. Uruchom polecenie konfiguracji rozszerzenia:

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    Gdzie --params jest opcjonalna flaga dostarczyć plik definiujący wartości parametrów użytkownika konfigurowalny i pozwala na ominięcie interaktywnych terminali podpowiedzi dla tych wartości. Określ swoje wartości w .env pliku, który następuje po dotenv składnię.

  3. Jeśli zostanie wyświetlony monit (albo nie dostarczy .env plik), wprowadź wartości konfiguracji, aby dostosować rozszerzenie dla swojego projektu.

Odinstaluj instancję rozszerzenia

Możesz odinstalować wystąpienie rozszerzenia z projektu Firebase. Ta czynność powoduje usunięcie konta usługi i wszystkich zasobów (jak zestaw funkcji), które Firebase stworzony specjalnie dla tej instancji przedłużenia. Jednak dodaje nie są usuwane:

  • 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 interakcje z innych źródeł, nie są one specyficzne rozszerzenie, więc nie są one usunięte, jeśli rozszerzenie jest odinstalowane.

Oto jak odinstalować rozszerzenie:

  1. Uruchom polecenie extensions-list, aby uzyskać identyfikator wystąpienia rozszerzenia:

    firebase ext:list --project=projectId-or-alias
  2. Uruchom polecenie rozszerzenia-odinstaluj:

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias