Możesz instalować dowolne aplikacje (i zarządzać nimi) oficjalnych rozszerzeń Firebase za pomocą konsoli Firebase albo interfejs wiersza poleceń Firebase (interfejs wiersza poleceń).
Zapoznaj się z różnic w obsługiwane działania dla interfejsu wiersza poleceń Firebase i konsoli Firebase.
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 można było zainstalować rozszerzenie, projekt musi być połączony z usługą Blaze (płatność według idź). Chociaż nie ma żadnych opłat za instalowanie rozszerzenia, może się okazać, że opłat za korzystanie z usług Firebase i usług Cloud, takich jak Cloud Secret Manager, jeśli wykorzystanie usług przekracza bezpłatnie .
Zanim zaczniesz
Dodaj Firebase do swojego projektu, chyba że masz to już za sobą.
Jeśli jeszcze nie masz skonfigurowanego projektu, przenieś go na wersję Blaze (płatność według idź).
Zainstaluj lub zaktualizuj aplikację interfejsu wiersza poleceń Firebase.
Zanotuj identyfikator projektu Firebase lub skonfigurowany wcześniej lub aliasie projektu.
- Identyfikator projektu – Uruchom
firebase projects:listz dowolnego miejsca na komputerze. - Alias projektu – uruchom
firebase usez lokalnego katalogu aplikacji.
- Identyfikator projektu – Uruchom
Krok 1. Wyświetl szczegółowe informacje o rozszerzeniu
Ten krok jest opcjonalny, ale zdecydowanie zalecany.
Przed zainstalowaniem rozszerzenia Firebase zalecamy zawierają szczegółowe informacje o rozszerzeniu, w tym:
- Sposób działania rozszerzenia, zadania wstępne rozszerzenie
- Ogólne informacje umożliwiające identyfikację i opis
- tego, czy zadania rozszerzenia wymagają konta rozliczeniowego.
- usług Google (interfejsy API) oraz role dostępu wymagane przez operacja
- Zasoby utworzone na potrzeby rozszerzenia (takie jak funkcje)
- Opisy parametrów konfigurowanych przez użytkownika
Aby wyświetlić szczegółowe informacje o rozszerzeniu:
Upewnij się, że skonfiguruj swój oraz wybierzesz .
Uruchom polecenie rozszerzenia informacji o rozszerzeniach z dowolnego miejsca na komputerze:
firebase ext:info publisher-id/extension-id
publisher-idiextension-idargumenty są wymagane i można je znaleźć na stronie z informacjami o wstępnej instalacji rozszerzenia.
Krok 2. Zainstaluj rozszerzenie
W trakcie instalacji pojawi się prośba o zapoznanie się z podstawowymi specyfikacje rozszerzenia (takie jak włączone interfejsy API, utworzone zasoby, dostęp przyznany itp.). Powiadomimy Cię o wszystkich wymaganiach dotyczących płatności oraz z prośbą o określać wartości konfigurowalnych parametrów rozszerzenia.
Upewnij się, że skonfiguruj swój oraz wybierzesz .
W lokalnym katalogu Firebase uruchom polecenie „Extension-install”. Jeśli pojawi się taka prośba, wpisz wartości parametrów, aby dostosować instancję rozszerzenia.
firebase ext:install publisher-id/extension-id --project=projectId-or-alias
publisher-idiextension-idargumenty są wymagane i można je znaleźć na stronie z informacjami o wstępnej instalacji rozszerzenia.Uruchomienie tego polecenia spowoduje dodanie instancji rozszerzenia do Twojej pliku manifestu rozszerzeń.
Następnie, aby wdrożyć rozszerzenia z pliku manifestu w Firebase, projekt, uruchomienie:
firebase deploy --only extensions --project=projectId-or-alias
Krok 3. Zakończ konfigurację po instalacji
W przypadku niektórych rozszerzeń wymagane lub opcjonalne czynności, które należy wykonać przed użyciem . Instrukcje znajdziesz na stronie z informacjami po instalacji rozszerzenia w: panelu Rozszerzenia w konsoli Firebase (konkretny link do po instalacji wyświetli się panel informacyjny w terminalu).
Te instrukcje możesz również znaleźć w pliku POSTINSTALL.md zawartym w
katalogu źródłowego rozszerzenia.
Tworzenie zasobów Firebase
Jeśli rozszerzenie zostało skonfigurowane do korzystania z zasobów Firebase (Cloud Firestore) kolekcji, ścieżek do Bazy danych czasu rzeczywistego, zasobników Cloud Storage), które jeszcze nie istnieją, utworzyć je przed użyciem tego rozszerzenia.
Tworzenie modułów obsługi zdarzeń Eventarc
Niektóre rozszerzenia są publikowane w Eventarc gdy podczas jej wykonywania mają miejsce ważne zdarzenia. Jeśli rozszerzenie publikuje zdarzenia a w trakcie instalacji zostały włączone zdarzenia, możesz napisać funkcje, które reagują na zdarzenia do tych zdarzeń za pomocą Twojej własnej logiki. Jest to przydatne na przykład do: powiadamiać użytkowników o zakończeniu długo trwających zadań lub o przetwarzaniu danych wyjściowych z funkcją rozszerzenia.
Listę zdarzeń publikowanych przez rozszerzenie (jeśli takie są) znajdziesz w dokumentacji. Na przykład zobacz typy zdarzeń w rozszerzeniu Run Payments with Stripe.
Następnie przeczytaj artykuł Reguły zdarzeń niestandardowych w przypadku: informacje o tworzeniu modułów obsługi zdarzeń Eventarc.
Zainstaluj wiele instancji rozszerzeń
To samo rozszerzenie możesz zainstalować więcej niż raz w tym samym projekcie. Każda zainstalowana instancja może mieć własną konfigurację niestandardową i własną z rozszerzeniami. Możesz zidentyfikować każdą zainstalowaną instancję i odwoływać się do niej za pomocą identyfikator instancji, który jest unikalny w obrębie projektu. Za pojawi się prośba o potwierdzenie lub edycję identyfikatora każdej dodatkowej instancji zainstalowane rozszerzenie.
Następne kroki
Wyświetl szczegóły oraz zainstalowanego rozszerzenia w konsoli Firebase.
Monitorowanie aktywności zainstalowanego rozszerzenia, w tym kontrole jego stanu, użycia i logów.
Za pomocą interfejsu wiersza poleceń Firebase zarządzaj zainstalowane rozszerzenie. Możesz też zmienić konfigurację lub odinstalować rozszerzenie, .
Za pomocą konsoli Firebase zarządzaj zainstalowane rozszerzenie. W przypadku oficjalnych rozszerzeń Firebase możesz zmienić konfigurację lub odinstaluj rozszerzenie, a następnie zaktualizuj je do najnowszej wersji wersji.
Sprawdzoną metodą we wszystkich projektach jest konfiguracja alerty dotyczące budżetu w projekcie oraz monitoruj wykorzystanie i płatności panel w konsoli Firebase.