Zainstaluj rozszerzenie Firebase

Możesz zainstalować (i zarządzać ) dowolnym oficjalnym rozszerzeniem Firebase za pomocą konsoli Firebase lub interfejsu wiersza poleceń Firebase (interfejs wiersza poleceń).

Pamiętaj, aby zapoznać się z różnicami w obsługiwanych akcjach dla Firebase CLI i konsoli 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 .

Aby zainstalować rozszerzenie, Twój projekt musi być objęty planem Blaze (płatność zgodnie z rzeczywistym użyciem). Chociaż instalacja rozszerzenia nie jest płatna, możesz zostać obciążony opłatą za korzystanie z usług Firebase lub usług w chmurze, takich jak Cloud Secret Manager , jeśli wykorzystanie przekroczy poziom bezpłatny usług.

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu .

  2. Jeśli jeszcze tego nie zrobiłeś, uaktualnij swój projekt do planu Blaze (płatność zgodnie z rzeczywistym użyciem).

  3. Zainstaluj lub zaktualizuj do najnowszej wersji Firebase CLI.

  4. Zanotuj identyfikator projektu Firebase lub wcześniej skonfigurowany alias projektu.

Krok 1 : Wyświetl szczegółowe informacje o rozszerzeniu

Ten krok jest opcjonalny, ale zdecydowanie zalecany.

Przed zainstalowaniem rozszerzenia Firebase zalecamy zapoznanie się ze szczegółowymi informacjami na temat rozszerzenia, w tym:

  • Jak działa rozszerzenie, wszelkie zadania przed instalacją i szczegóły dotyczące rozszerzenia
  • Ogólne informacje identyfikacyjne i opis
  • Czy zadania rozszerzenia wymagają konta rozliczeniowego
  • Usługi Google (API) i role dostępu wymagane do działania
  • Zasoby utworzone dla rozszerzenia (jak funkcje)
  • Opisy parametrów konfigurowanych przez użytkownika

Aby wyświetlić szczegółowe informacje o rozszerzeniu:

  1. Upewnij się, że skonfigurowałeś środowisko i wybrałeś rozszerzenie .

  2. Uruchom polecenie Extension-info z dowolnego miejsca na komputerze:

    firebase ext:info publisher-id/extension-id

    Argumenty publisher-id i extension-id są wymagane i można je znaleźć na stronie szczegółów przedinstalacji rozszerzenia .

Krok 2 : Zainstaluj rozszerzenie

Podczas procesu instalacji zostaniesz poproszony o przejrzenie podstawowych specyfikacji rozszerzenia (takich jak włączone interfejsy API, utworzone zasoby , przyznany dostęp itp.). Zostaniesz powiadomiony o wszelkich wymaganiach rozliczeniowych, a także poproszony o podanie wartości konfigurowalnych parametrów rozszerzenia.

  1. Upewnij się, że skonfigurowałeś środowisko i wybrałeś rozszerzenie .

  2. Z lokalnego katalogu Firebase uruchom polecenie instalacji rozszerzenia. Jeśli pojawi się monit, wprowadź wartości parametrów, aby dostosować instancję rozszerzenia.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    Argumenty publisher-id i extension-id są wymagane i można je znaleźć na stronie szczegółów przedinstalacji rozszerzenia .

    Uruchomienie tego polecenia dodaje instancję rozszerzenia do manifestu rozszerzeń .

  3. Następnie, aby wdrożyć rozszerzenia w manifeście w projekcie Firebase, uruchom:

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

Krok 3 : Zakończ konfigurację po instalacji

Niektóre rozszerzenia wymagają wykonania wymaganych lub opcjonalnych kroków przed ich użyciem. Znajdź te instrukcje na stronie szczegółów po instalacji rozszerzenia w panelu rozszerzeń konsoli Firebase (konkretny link do pulpitu nawigacyjnego zostanie wyświetlony w terminalu po instalacji).

Instrukcje te można także znaleźć w pliku POSTINSTALL.md znajdującym się w katalogu źródłowym rozszerzenia .

Utwórz zasoby Firebase

Jeśli skonfigurowałeś rozszerzenie do korzystania z zasobów Firebase (kolekcji Cloud Firestore, ścieżek bazy danych czasu rzeczywistego, zasobników Cloud Storage), które jeszcze nie istnieją, utwórz je przed użyciem rozszerzenia.

Utwórz procedury obsługi zdarzeń Eventarc

Niektóre rozszerzenia publikują się w Eventarc , gdy podczas wykonywania mają miejsce ważne zdarzenia. Jeśli rozszerzenie publikuje zdarzenia i włączyłeś je podczas instalacji, możesz napisać funkcje, które będą reagować na te zdarzenia, korzystając z własnej, niestandardowej logiki. Może to być przydatne na przykład do powiadamiania użytkowników o zakończeniu długotrwałych zadań lub do późniejszego przetwarzania danych wyjściowych funkcji rozszerzenia.

Zobacz dokumentację rozszerzenia, aby zapoznać się z listą publikowanych przez nie wydarzeń (jeśli takie istnieją). Na przykład zobacz typy zdarzeń dla rozszerzenia Uruchom płatności z paskiem .

Następnie zobacz Niestandardowe wyzwalacze zdarzeń , aby uzyskać informacje na temat pisania procedur obsługi zdarzeń Eventarc.

Zainstaluj wiele wystąpień rozszerzeń

Możesz zainstalować to samo rozszerzenie więcej niż raz w tym samym projekcie. Każda zainstalowana instancja może mieć własną, dostosowaną konfigurację i własne zasoby rozszerzeń. Każdą zainstalowaną instancję identyfikujesz i odnosisz się do niej za pomocą jej identyfikatora instancji , który jest unikalny w ramach Twojego projektu. Zostaniesz poproszony o potwierdzenie lub edycję identyfikatora każdej dodatkowej instancji instalowanego rozszerzenia.

Następne kroki

  • Wyświetl szczegóły i konfigurację zainstalowanego rozszerzenia w konsoli Firebase.

  • Monitoruj aktywność zainstalowanego rozszerzenia, w tym sprawdzaj jego stan, użycie i dzienniki.

  • Korzystając z interfejsu Firebase CLI, zarządzaj zainstalowanym rozszerzeniem. Możesz ponownie skonfigurować lub odinstalować rozszerzenie, a także zaktualizować je do najnowszej wersji.

  • Za pomocą konsoli Firebase zarządzaj zainstalowanym rozszerzeniem. W przypadku oficjalnych rozszerzeń Firebase możesz ponownie skonfigurować lub odinstalować rozszerzenie, a także zaktualizować je do najnowszej wersji.

  • Jako najlepszą praktykę w przypadku wszystkich projektów należy skonfigurować alerty budżetowe dla swojego projektu i monitorować pulpit nawigacyjny Wykorzystanie i rozliczenia w konsoli Firebase.