Możesz zainstalować (i zarządzać) dowolne oficjalne rozszerzenia Firebase za pomocą konsoli Firebase, Firebase interfejsu wiersza poleceń lub automatycznie wygenerowanego pakietu SDK.
Zapoznaj się z różnicami w obsługiwanych działaniach w przypadku każdej metody instalacji.
Aby instalować rozszerzenia i nimi zarządzać, musisz mieć jedną z tych ról: Właściciel lub Edytujący albo Administrator Firebase.
Zanim zaczniesz
Dodaj Firebase do projektu, jeśli nie korzystasz w nim jeszcze z tej usługi.
Jeśli jeszcze tego nie zrobisz, przejdź na abonament Blaze z płatnością według wykorzystania.
Instalacja rozszerzenia jest bezpłatna, ale za korzystanie z usług Firebase lub usług w chmurze (np. Cloud Secret Manager) mogą być naliczane opłaty, jeśli wykorzystanie przekroczy bezpłatny poziom tych usług.
Krok 1. Wyświetl szczegółowe informacje o rozszerzeniu
Ten krok jest opcjonalny, ale zdecydowanie zalecany.
Zanim zainstalujesz Firebase Extension, zapoznaj się ze szczegółowymi informacjami o rozszerzeniu, w tym:
- Jak działa rozszerzenie, jakie zadania należy wykonać przed jego instalacją i szczegóły dotyczące rozszerzenia.
- Ogólne informacje umożliwiające identyfikację i opis
- Czy zadania rozszerzenia wymagają konta rozliczeniowego.
- Usługi Google (interfejsy API) i role dostępu wymagane do działania
- Zasoby utworzone na potrzeby rozszerzenia (np. funkcje)
- Opisy parametrów konfigurowanych przez użytkownika
Aby wyświetlić szczegółowe informacje o rozszerzeniu:
Przeglądaj oficjalne rozszerzenia Firebase w Extensions Hub.
Kliknij kartę rozszerzenia, aby:
Wyświetl szczegółowe informacje o rozszerzeniu.
Znajdź link do kodu źródłowego rozszerzenia w Firebase Extensionsrepozytorium źródłowym.
W katalogu rozszerzeń rozszerzenia możesz wyświetlić te szczegółowe informacje w
README.
Krok 2. Zainstaluj rozszerzenie
Podczas instalacji pojawi się prośba o sprawdzenie podstawowych specyfikacji rozszerzenia (np. włączonych interfejsów API, utworzonych zasobów, przyznanego dostępu itp.). Otrzymasz powiadomienie o wszystkich wymaganiach dotyczących płatności, a także prośbę o podanie wartości konfigurowalnych parametrów rozszerzenia.
Przeglądaj oficjalne rozszerzenia Firebase w Extensions Hub.
Kliknij kartę rozszerzenia, a następnie zapoznaj się ze szczegółowymi informacjami o nim. Mogą one zawierać konkretne instrukcje użytkowania i zadania do wykonania przed instalacją.
Kliknij Zainstaluj, a potem postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować rozszerzenie.
Krok 3. Dokończ konfigurację po instalacji
Niektóre rozszerzenia wymagają wykonania określonych czynności przed rozpoczęciem korzystania z nich. Instrukcje te znajdziesz na stronie z informacjami po instalacji rozszerzenia na Extensions panelu Firebase konsoli (konkretny link do panelu wyświetla się w terminalu po instalacji).
Instrukcje znajdziesz też w POSTINSTALL.mdpliku w katalogu źródłowym rozszerzenia.
Tworzenie zasobów Firebase
Jeśli rozszerzenie zostało skonfigurowane do korzystania z zasobów Firebase (Cloud Firestorekolekcji, Realtime Database ścieżek, Cloud Storage zasobników), które jeszcze nie istnieją, utwórz je przed użyciem rozszerzenia.
Tworzenie modułów obsługi zdarzeń Eventarc
Niektóre rozszerzenia publikują informacje w Eventarc, gdy podczas wykonywania wystąpią ważne zdarzenia. Jeśli rozszerzenie publikuje zdarzenia i podczas instalacji włączysz zdarzenia, możesz napisać funkcje, które będą reagować na te zdarzenia za pomocą własnej logiki niestandardowej. Może to być przydatne np. do powiadamiania użytkowników o zakończeniu długotrwałych zadań lub do przetwarzania końcowego danych wyjściowych funkcji rozszerzenia.
Listę zdarzeń publikowanych przez rozszerzenie (jeśli takie istnieją) znajdziesz w jego dokumentacji. Na przykład sprawdź typy zdarzeń w przypadku rozszerzenia Run Payments with Stripe.
Następnie zapoznaj się z sekcją Aktywatory zdarzeń niestandardowych, aby dowiedzieć się, jak pisać moduły obsługi zdarzeń Eventarc.
Instalowanie wielu instancji rozszerzenia
Tę samą usługę możesz zainstalować w tym samym projekcie więcej niż raz. Każda zainstalowana instancja może mieć własną konfigurację i własne zasoby rozszerzeń. Każda zainstalowana instancja jest identyfikowana i przywoływana za pomocą identyfikatora instancji, który jest unikalny w Twoim projekcie.
Pojawi się prośba o potwierdzenie lub edytowanie identyfikatora instancji każdej dodatkowej instancji rozszerzenia, które instalujesz.
Następne kroki
Wyświetl szczegóły i konfigurację zainstalowanego rozszerzenia w konsoli Firebase.
Monitorowanie aktywności zainstalowanego rozszerzenia, w tym sprawdzanie jego stanu, wykorzystania i logów.
W 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.
Zgodnie ze sprawdzoną metodą w przypadku wszystkich projektów skonfiguruj alerty budżetowe i limity wydatków. Możesz też monitorować panel Wykorzystanie i płatności w Firebase konsoli.