Możesz zainstalować dowolne z oficjalnych rozszerzeń Firebase (i zarządzać nimi ) za pomocą konsoli Firebase lub interfejsu wiersza poleceń Firebase .
Sprawdź różnice w obsługiwanych akcjach dla Firebase CLI i Firebase Console.
Aby instalować rozszerzenia lub nimi zarządzać, 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 (płatność na bieżąco). Chociaż za instalowanie rozszerzenia nie jest pobierana opłata, możesz zostać obciążony opłatą za korzystanie z usług Firebase lub usług w chmurze, takich jak [Cloud Secret Manager][secret-price], jeśli wykorzystanie przekracza poziom bezpłatnych usług.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu i uaktualnij swój projekt Firebase do planu Blaze (płatność w miarę korzystania).
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 o rozszerzeniu, w tym:
- Jak działa rozszerzenie, wszelkie zadania przedinstalacyjne i szczegóły dotyczące rozszerzenia
- Ogólne informacje identyfikujące i opis
- Czy zadania rozszerzenia wymagają konta rozliczeniowego
- Usługi Google (API) i role dostępu wymagane do działania
- Zasoby utworzone dla rozszerzenia (np. funkcje)
- Opisy parametrów konfigurowalnych przez użytkownika
Aby wyświetlić szczegółowe informacje o rozszerzeniu:
Przeglądaj oficjalne rozszerzenia Firebase z następujących źródeł:
- Strona produktu Rozszerzenia Firebase
- Panel rozszerzeń Firebase w konsoli Firebase
Kliknij kartę rozszerzenia, aby:
Wyświetl szczegółowe informacje o rozszerzeniu.
Znajdź link do kodu źródłowego rozszerzenia w repozytorium źródłowym rozszerzeń Firebase .
W katalogu rozszerzeń rozszerzenia możesz wyświetlić te szczegółowe informacje w pliku
README
.
Krok 2 : Zainstaluj rozszerzenie
Podczas procesu instalacji zostaniesz poproszony o sprawdzenie podstawowych specyfikacji rozszerzenia (takich jak włączone interfejsy API, utworzone zasoby , przyznany dostęp itp.). Otrzymasz powiadomienie o wszelkich wymaganiach dotyczących płatności, a także zostaniesz poproszony o określenie wartości konfigurowalnych parametrów rozszerzenia.
Przeglądaj oficjalne rozszerzenia Firebase z następujących źródeł:
- Strona produktu Rozszerzenia Firebase
- Panel rozszerzeń Firebase w konsoli Firebase
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 czynności, które należy wykonać przed ich użyciem. Instrukcje te można znaleźć na stronie szczegółów poinstalacyjnych rozszerzenia w panelu rozszerzeń konsoli Firebase (konkretny link do panelu 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 .
Utwórz zasoby Firebase
Jeśli skonfigurowałeś rozszerzenie do korzystania z zasobów Firebase (kolekcje Cloud Firestore, ścieżki Bazy danych czasu rzeczywistego, zasobniki Cloud Storage), które jeszcze nie istnieją, utwórz je przed użyciem rozszerzenia.
Utwórz obsługę zdarzeń Eventarc
Niektóre rozszerzenia publikują w Eventarc , gdy podczas wykonywania wydarzą się ważne zdarzenia. Jeśli rozszerzenie publikuje zdarzenia, a zdarzenia zostały włączone podczas instalacji, możesz napisać funkcje, które reagują 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 rozszerzenia.
Zapoznaj się z dokumentacją rozszerzenia, aby uzyskać listę zdarzeń (jeśli istnieją), które publikuje.
Następnie zobacz Niestandardowe wyzwalacze zdarzeń, aby uzyskać informacje na temat pisania programów obsługi zdarzeń Eventarc.
Zainstaluj wiele instancji rozszerzeń
Możesz zainstalować to samo rozszerzenie więcej niż raz w tym samym projekcie. Każde zainstalowane wystąpienie może mieć własną dostosowaną konfigurację i własne zasoby rozszerzeń. Identyfikujesz każdą zainstalowaną instancję i odwołujesz się do niej za pomocą jej identyfikatora , który jest unikalny w ramach Twojego projektu. Zostaniesz poproszony o potwierdzenie lub zmianę identyfikatora wystąpienia 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 sprawdzaj jego stan, użycie i dzienniki.
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.
Najlepszym rozwiązaniem dla wszystkich projektów jest skonfigurowanie alertów budżetowych dla projektu i monitorowanie pulpitu nawigacyjnego użytkowania i rozliczeń w konsoli Firebase.