Oficjalne rozszerzenia możesz instalować (i nimi zarządzać) za pomocą konsoli Firebase, wiersza poleceń Firebase CLI (command-line interface) lub automatycznie wygenerowanego paketu SDK.Firebase
Sprawdź różnice w obsługiwanych działaniach w zależności od metody instalacji.
Aby instalować rozszerzenia i nimi zarządzać, musisz mieć przypisaną jedną z tych ról: Właściciel lub Edytujący lub Administrator Firebase.
Aby zainstalować rozszerzenie, Twój projekt musi być objęty abonamentem Blaze (płatność według wykorzystania). Instalacja rozszerzenia jest bezpłatna, ale możesz być obciążony opłatami za korzystanie z usług Firebase lub usług Cloud, takich jak Cloud Secret Manager, jeśli wykorzystanie przekroczy poziom bezpłatny.
Zanim zaczniesz
Krok 1: wyświetlanie szczegółowych informacji o rozszerzeniu
Ten krok jest opcjonalny, ale zdecydowanie zalecany.
Zanim zainstalujesz Firebase Extension, zalecamy, aby zapoznać się ze szczegółowymi informacjami o rozszerzeniu, w tym:
- jak działa rozszerzenie, jakie zadania należy wykonać przed instalacją oraz 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 na potrzeby rozszerzenia (np. funkcje)
- opisy parametrów konfigurowanych przez użytkownika.
Aby wyświetlić szczegółowe informacje o rozszerzeniu:
Przeglądaj oficjalne Firebase rozszerzenia w Extensions Hub.
Kliknij kartę rozszerzenia, aby:
wyświetlić szczegółowe informacje o rozszerzeniu;
znaleźć link do kodu źródłowego rozszerzenia w Firebase Extensions repozytorium kodu źródłowego.
W katalogu rozszerzenia, możesz wyświetlić te szczegółowe informacje w pliku
README.
Krok 2: instalowanie rozszerzenia
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 wszelkich wymaganiach dotyczących rozliczeń oraz prośbę o podanie wartości konfigurowalnych parametrów rozszerzenia.
Przeglądaj oficjalne Firebase rozszerzenia w Extensions Hub.
Kliknij kartę rozszerzenia, a następnie zapoznaj się ze szczegółowymi informacjami o rozszerzeniu, które mogą zawierać konkretne instrukcje dotyczące użytkowania i zadania do wykonania przed instalacją.
Kliknij Zainstaluj, a następnie postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować rozszerzenie.
Krok 3: dokończenie konfiguracji po instalacji
W przypadku niektórych rozszerzeń przed rozpoczęciem korzystania z nich musisz wykonać wymagane lub opcjonalne czynności. Instrukcje znajdziesz na stronie szczegółów po instalacji rozszerzenia w panelu Extensions w konsoli Firebase (konkretny link do panelu jest wyświetlany w terminalu po instalacji).
Instrukcje te znajdziesz też w pliku POSTINSTALL.md w
katalogu źródłowym rozszerzenia.
Tworzenie zasobów Firebase
Jeśli rozszerzenie zostało skonfigurowane do korzystania z zasobów Firebase (Cloud Firestore kolekcji, 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ą w Eventarc informacje o ważnych zdarzeniach, które mają miejsce podczas wykonywania. Jeśli rozszerzenie publikuje zdarzenia i włączyłeś(-aś) zdarzenia podczas instalacji, możesz napisać funkcje, które reagują 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ń (jeśli takie są) publikowanych przez rozszerzenie znajdziesz w jego dokumentacji. Na przykład zobacz typy zdarzeń w rozszerzeniu Run Payments with Stripe.
Następnie zapoznaj się z artykułem Aktywatory zdarzeń niestandardowych, aby dowiedzieć się, jak pisać moduły obsługi zdarzeń Eventarc.
Instalowanie wielu instancji rozszerzenia
To samo rozszerzenie 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 rozszerzenia. Każdą zainstalowaną instancję identyfikujesz i odwołujesz się do niej za pomocą identyfikatora instancji, który jest unikalny w Twoim projekcie.
Zostaniesz poproszony(-a) o potwierdzenie lub edytowanie identyfikatora instancji każdej dodatkowej instancji rozszerzenia, którą zainstalujesz.
Następne kroki
Wyświetl szczegóły i konfigurację zainstalowanego rozszerzenia w konsoli Firebase.
Monitoruj aktywność zainstalowanego rozszerzenia, w tym sprawdzaj jego stan, wykorzystanie i logi.
Zarządzaj zainstalowanym rozszerzeniem za pomocą konsoli Firebase . W przypadku oficjalnych Firebase rozszerzeń możesz ponownie skonfigurować lub odinstalować rozszerzenie, a także zaktualizować je do najnowszej wersji.
Aby zapewnić jak najlepsze działanie wszystkich projektów, skonfiguruj alerty budżetowe dla swojego projektu i monitoruj swój panel Wykorzystanie i rozliczenia w konsoli Firebase.