Możesz zainstalować dowolne oficjalne rozszerzenie Firebase (i zarządzać nim ) za pomocą konsoli Firebase lub Firebase CLI (interfejs wiersza poleceń).
Zapoznaj się z różnicami w obsługiwanych działaniach interfejsu wiersza polecenia Firebase i konsoli Firebase.
Aby zainstalować rozszerzenia lub zarządzać nimi, musisz mieć przypisaną jedną z tych ról: Właściciel, Edytor lub Administrator Firebase .
Aby zainstalować rozszerzenie, Twój projekt musi być objęty planem Blaze (pay as you go). Mimo że instalacja rozszerzenia jest bezpł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 przekraczasz bezpłatny poziom usług.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu i zaktualizuj swój projekt Firebase do planu Blaze (pay as you go).
Krok 1 : Wyświetl szczegółowe informacje o rozszerzeniu
Ten krok jest opcjonalny, ale zdecydowanie zalecany.
Przed zainstalowaniem rozszerzenia Firebase zalecamy przejrzenie szczegółowych informacji o rozszerzeniu, w tym:
- Jak działa rozszerzenie, wszelkie zadania przedinstalacyjne i szczegółowe informacje o rozszerzeniu
- Ogólne informacje identyfikacyjne i opis
- Czy zadania rozszerzenia wymagają konta rozliczeniowego
- Usługi Google (interfejsy API) i role dostępu wymagane do działania
- Zasoby utworzone dla rozszerzenia (takie jak funkcje)
- Opisy parametrów konfigurowanych przez użytkownika
Aby wyświetlić szczegółowe informacje o rozszerzeniu:
Przeglądaj oficjalne rozszerzenia Firebase w Centrum rozszerzeń .
Kliknij kartę rozszerzenia, aby:
Wyświetl szczegółowe informacje o rozszerzeniu.
Znajdź link do kodu źródłowego rozszerzenia w repozytorium źródłowym Firebase Extensions .
W katalogu rozszerzeń możesz wyświetlić te szczegółowe informacje w pliku
README.
Krok 2 : Zainstaluj rozszerzenie
Podczas procesu instalacji pojawi się monit o przejrzenie podstawowych specyfikacji rozszerzenia (takich jak włączone interfejsy API, utworzone zasoby , udzielony dostęp itp.). Otrzymasz powiadomienie o wszelkich wymaganiach dotyczących rozliczeń, a także monit o podanie wartości konfigurowalnych parametrów rozszerzenia.
Przeglądaj oficjalne rozszerzenia Firebase w Centrum rozszerzeń .
Kliknij kartę rozszerzenia, a następnie przejrzyj szczegółowe informacje o rozszerzeniu, które mogą zawierać szczegółowe instrukcje użytkowania i wszelkie zadania przedinstalacyjne.
Kliknij Zainstaluj , a następnie postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować rozszerzenie.
Krok 3 : Zakończ konfigurację po instalacji
Niektóre rozszerzenia mają wymagane lub opcjonalne kroki, które należy wykonać przed ich użyciem. Znajdź te instrukcje na stronie szczegółów poinstalacyjnych swojego rozszerzenia w panelu rozszerzeń w konsoli Firebase (konkretny link do pulpitu nawigacyjnego jest wyświetlany w terminalu po instalacji).
Instrukcje te można również znaleźć w pliku POSTINSTALL.md znajdującym się w katalogu źródłowym rozszerzenia .
Twórz zasoby Firebase
Jeśli rozszerzenie zostało skonfigurowane 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, a zdarzenia zostały włączone podczas instalacji, możesz napisać funkcje reagujące na te zdarzenia za pomocą 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 przetwarzania końcowego danych wyjściowych funkcji rozszerzającej.
Zobacz dokumentację rozszerzenia, aby zapoznać się z listą publikowanych przez nie wydarzeń (jeśli istnieją). Zobacz na przykład 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 odwołujesz się do niej za pomocą jej identyfikatora instancji , który jest unikalny w ramach Twojego projektu. Zostanie wyświetlony monit o potwierdzenie lub edycję identyfikatora instancji każdego dodatkowego wystąpienia instalowanego rozszerzenia.
Następne kroki
Wyświetl szczegóły i konfigurację zainstalowanego rozszerzenia w konsoli Firebase.
Monitoruj aktywność zainstalowanego rozszerzenia, w tym sprawdzanie jego kondycji, użycia i dzienników.
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.
Sprawdzoną praktyką we wszystkich projektach jest skonfigurowanie alertów budżetowych dla projektu i monitorowanie pulpitu nawigacyjnego użytkowania i rozliczeń w konsoli Firebase.