Oficjalne rozszerzenia możesz instalować (i nimi zarządzać) za pomocą konsoli Firebase, interfejsu wiersza poleceń Firebase CLI (command-line interface) lub automatycznie wygenerowanego pakietu 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.
Zanim zaczniesz
Dodaj Firebase do projektu, jeśli nie korzystasz w nim jeszcze z tej usługi.
Przejdź na abonament Blaze z płatnością według wykorzystania, jeśli nie korzystasz z niego jeszcze w projekcie .
Instalacja rozszerzenia jest bezpłatna, ale jeśli wykorzystanie usług Firebase lub usług Google Cloud (np. Cloud Secret Manager) przekroczy poziom bezpłatny, mogą zostać naliczone opłaty.
Krok 1. Wyświetl szczegółowe informacje 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ół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 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. 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 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życia 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. Wykonaj konfigurację po instalacji.
W przypadku niektórych rozszerzeń przed rozpoczęciem korzystania z nich musisz wykonać wymagane lub opcjonalne czynności. Instrukcje znajdziesz na stronie z informacjami 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ś je podczas instalacji, 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 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ą, dostosowaną 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 o budżecie dla swojego projektu i monitoruj swój panel Wykorzystanie i rozliczenia w konsoli Firebase.