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.
Aby zainstalować rozszerzenie, Twój projekt musi być objęty abonamentem Blaze (płatność według wykorzystania). Instalacja rozszerzenia jest bezpłatna, ale jeśli wykorzystanie usług Firebase lub usług Cloud, takich jak Cloud Secret Manager, przekroczy poziom bezpłatny, mogą zostać naliczone opłaty.
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:
- sposób działania rozszerzenia, zadania do wykonania przed 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 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ń i pojawi się prośba 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 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 gdy podczas wykonywania mają miejsce ważne zdarzenia. 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 dokumentacji rozszerzenia. Na przykład zobacz typy zdarzeń w rozszerzeniu Run Payments with Stripe.
Następnie zapoznaj się z informacjami o pisaniu modułów obsługi zdarzeń Eventarc w sekcji Aktywatory zdarzeń niestandardowych.
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.
Pojawi się prośba 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.