Pierwsze kroki z Firebase w istniejącym projekcie Google Cloud

Projekt Firebase to Google Cloudprojekt, w którym włączono dodatkowe konfiguracje i usługi Firebase. Jest to powszechnie nazywane „dodawaniem Firebase” do Google Cloud projektu. Na tej stronie znajdziesz opis dodawania Firebase oraz odpowiedzi na niektóre najczęstsze pytania.

Gdy dodasz Firebase do Google Cloudprojektu, usługa ta automatycznie włączy kilka interfejsów API i utworzy konta usługi, aby uprościć korzystanie ze wszystkich usług i interfejsów Firebase. Firebase dodaje też do projektu firebase:enabledetykietę na stronie Etykiety w Google Cloudkonsoli. Dowiedz się więcej o tym, co się dzieje, gdy „dodasz Firebase”.

Związek między projektem Firebase a projektem Google Cloud

Projekt Firebase jest projektem Google Cloud:

• Dostęp do projektu i możliwość interakcji z nim masz w Firebasekonsoli, a także w Google Cloudkonsoli i Konsoli interfejsów API Google.

• Z projektem możesz wchodzić w interakcje za pomocą interfejsu wiersza poleceń Firebase, gcloud CLI i dowolnego zasobu Terraform od Google.

• W projekcie możesz używać usług i interfejsów API zarówno z Firebase, jak i Google Cloud.

• Uprawnienia i role IAM w projekcie są współdzielone między Firebase a usługą Google Cloud. Każdy dostęp członka projektu (czyli podmiotu) do projektu Google Cloud będzie też dotyczyć projektu Firebase (i odwrotnie).

• Płatności za projekt są wspólne dla Firebase iGoogle Cloud. Jeśli w projekcie Google Cloud płatności są włączone, projekt Firebase będzie korzystać z abonamentu Blaze w Firebase (płatność według zużycia zasobów).

• Unikalne identyfikatory projektu (np. numer projektu i identyfikator projektu) są wspólne dla Firebase i Google Cloud.

• Każda hierarchia zasobów zastosowana w projekcie Google Cloud (np. organizacja, foldery itp.) będzie też obowiązywać w projekcie Firebase.

• Usunięcie projektu spowoduje jego usunięcie z Firebase i Google Cloud.

• Usunięcie lub zmiana zasobu lub danych w projekcie ma zastosowanie w Firebase i Google Cloud.

Jak dodać Firebase do istniejącego projektu Google Cloud

Możesz „dodać Firebase” do istniejącego projektu Google Cloud, korzystając z jednej z tych opcji: Sprawdź, czy masz uprawnienia wymagane do dodania Firebase do projektu Google Cloud.

Pamiętaj, że po „dodaniu Firebase” do istniejącego projektu Google Cloud nie można cofnąć tej czynności (tzn. nie można całkowicie „usunąć Firebase” z projektu Google Cloud). Więcej informacji znajdziesz w tych najczęstszych pytaniach.

Uwaga: aby uzyskać dostęp do wszystkich funkcji Firebase w projekcieGoogle Cloud i z nich korzystać, musisz zaakceptować Warunki korzystania z usługi Firebase. Więcej informacji o wymaganiach dotyczących warunków korzystania z Firebase znajdziesz w tych najczęstszych pytaniach.

Firebase konsola

1. Zaloguj się w Firebasekonsoli na koncie, które daje Ci dostęp do istniejącego projektu Google Cloud.

2. Kliknij przycisk, aby utworzyć nowy projekt Firebase.

3. U dołu strony kliknij Dodaj Firebase do projektu Google Cloud.

4. W polu tekstowym zacznij wpisywać nazwę projektu, a następnie wybierz projekt z wyświetlonej listy.

5. Kliknij Otwórz projekt.

6. Po wyświetleniu prośby zaakceptuj warunki usługi Firebase.

7. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby „dodać Firebase” i skonfigurować projekt Firebase.

   Pamiętaj, że włączenie pomocy AI w konsoli Firebase i Google Analytics jest opcjonalne.

Firebase CLI

1. Jeśli jeszcze tego nie zrobiono, zainstaluj interfejs wiersza poleceń Firebase.

2. Zaloguj się na to samo konto Google, które daje Ci dostęp do istniejącego projektu Google Cloud.

3. Uruchom to polecenie:

   firebase projects:addfirebase

4. Gdy pojawi się prośba, wybierz z wyświetlonej listy istniejący projekt Google Cloud.

Uwaga: jeśli podczas próby „dodania Firebase” do istniejącego projektu Google Cloud pojawi się błąd 403 PERMISSION_DENIED, może to oznaczać, że nie masz wymaganych uprawnień lub że nie zaakceptowano Warunków usługi Firebase.

Interfejs API typu REST

1. Włącz interfejs Firebase Management API w dotychczasowym projekcie Google Cloud.

2. Wygeneruj token dostępu API.

3. Włącz usługi Firebase w projekcie, wywołując projects.addFirebase.

   Aby wykonać to wywołanie, musisz znać nazwę zasobu projektu.

Szczegółowe instrukcje znajdziesz w artykule Dodawanie usług Firebase do projektu w przewodniku po Firebase: „Konfigurowanie projektu Firebase i zarządzanie nim za pomocą interfejsu Management REST API”. Wykonaj wszystkie czynności opisane w sekcji Zanim zaczniesz tego przewodnika.

Uwaga: jeśli podczas próby „dodania Firebase” do istniejącego projektu Google Cloud pojawi się błąd 403 PERMISSION_DENIED, może to oznaczać, że nie masz wymaganych uprawnień lub że nie zaakceptowano Warunków korzystania z usługi Firebase.

Terraform

1. Włącz interfejs Firebase Management API (firebase.googleapis.com) w istniejącym projekcie Google Cloud.

2. Włącz usługi Firebase w projekcie za pomocą zasobu google_firebase_project.

Szczegółowe informacje o korzystaniu z Firebase i Terraform znajdziesz w artykule Pierwsze kroki z Terraform i Firebase.

Uwaga: jeśli podczas próby „dodania Firebase” do istniejącego projektu Google Cloud pojawi się błąd 403 PERMISSION_DENIED, może to oznaczać, że nie masz wymaganych uprawnień lub że nie zaakceptowano Warunków usługi Firebase.

Najczęstsze pytania i rozwiązywanie problemów

Czy akceptacja Warunków korzystania z usług Firebase jest wymagana, aby zacząć korzystać z Firebase?

Aby uzyskać dostęp do wszystkich funkcji Firebase w Google Cloudprojekcie i z nich korzystać, musisz zaakceptować Warunki korzystania z usług Firebase. Aby „dodać Firebase” do istniejącego Google Cloud projektu, musisz też zaakceptować warunki Firebase.

Warunki korzystania z Firebase wystarczy zaakceptować raz na konto Google, niezależnie od tego, do ilu projektów masz dostęp. Akceptując warunki, akceptujesz je tylko w przypadku swojego konta Google. Akceptacja nie dotyczy wszystkich członków projektu na poziomie projektu.

Warunki usługi Firebase możesz zaakceptować w Firebasekonsoli, korzystając z jednej z tych opcji: Gdy pojawi się odpowiedni komunikat, zaakceptuj Warunki.

• Utwórz nowy projekt Firebase za pomocą konsoli Firebase.

• Otwórz istniejący projekt Firebase w Firebasekonsoli (np. ktoś zaprosił Cię do projektu jako członka, czyli podmiot).

• Otwórz istniejący projekt Google Cloud w Firebase konsoli i dodaj do niego Firebase.

Uwaga: akceptowanie Warunków korzystania z usługi Firebase nie jest możliwe za pomocą interfejsu Firebase CLI, interfejsu REST API ani Terraform. Można to zrobić tylko za pomocą Firebasekonsoli

.

Ważne: jeśli została podpisana wersja offline Umowy głównej Google Cloud na korzystanie z określonych usług Firebase w ramach tego samego Konta Google Cloud Platform, Warunki korzystania z Firebase nie mają zastosowania do korzystania z tych usług Firebase, a korzystanie z nich podlega postanowieniom umowy w wersji offline.

Jakie uprawnienia są wymagane, aby „dodać Firebase”?

Aby „dodać Firebase” do istniejącego projektu Google Cloud, członek projektu (czyli podmiot) musi mieć te uprawnienia IAM:

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

Role uprawnień Edytujący i Właściciel zawierają te uprawnienia domyślnie.

Czy dodanie etykiety firebase:enabled wystarczy, aby dodać Firebase?

Wszystkie projekty Firebase mają etykietę firebase:enabled na stronie Etykiety w konsoli Google Cloud.

Jednak ręczne dodanie etykiety firebase:enabled do listy etykiet projektu NIE włącza konfiguracji i usług Firebase w projekcie Google Cloud. Aby to zrobić, musisz dodać Firebase za pomocą Firebase konsoli (lub w bardziej zaawansowanych przypadkach użycia za pomocą Firebase interfejsu wiersza poleceń, interfejsu Firebase Management REST API lub Terraform).

Co się stanie, gdy „dodasz Firebase” do istniejącego Google Cloud projektu?

Projekt Firebase to Google Cloudprojekt, w którym włączono dodatkowe konfiguracje i usługi Firebase. Gdy „dodasz Firebase” do istniejącego projektu Google Cloud, Firebase wykona te działania, aby uprościć korzystanie ze wszystkich usług i interfejsów Firebase:

• Dodaje etykietę firebase:enabled na stronie Etykiety w konsoli Google Cloud.

• Tworzy klucz interfejsu API „Przeglądarka” i automatycznie ogranicza go do interfejsów API związanych z Firebase.

• Tworzy te konta usługi:

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Włącza te interfejsy API:

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Firebase Dynamic Links API
  • Firebase Hosting API
  • Firebase Installations API
  • Firebase Management API
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

Czy mogę „usunąć Firebase” z projektu?

Po dodaniu Firebase do istniejącego Google Cloud projektu nie można cofnąć tej czynności (tzn. nie można całkowicie „usunąć Firebase” z Google Cloud projektu).

Proces „dodawania Firebase” włącza interfejsy API i usługi backendu, które mogą być używane w innych Google Cloudfunkcjach. Wyłączenie wszystkich tych włączonych usług może spowodować nieoczekiwane i niepożądane konsekwencje ze względu na zależności.

Jeśli jednak chcesz, możesz ręcznie wyłączyć wszystkie interfejsy API i usunąć etykietę, klucz API oraz konta usługi automatycznie włączone i utworzone po „dodaniu Firebase”.

Ostrzeżenie: jeśli zdecydujesz się ręcznie wyłączyć i usunąć to, co się stało podczas „dodawania Firebase”, zachowaj szczególną ostrożność. Musisz mieć całkowitą pewność, że Twój Google Cloud projekt i aplikacje z nim powiązane nie korzystają z niczego, co jest związane z wyłączanym i usuwanym elementem. W przeciwnym razie projekt lub aplikacja mogą przestać działać lub zachowywać się w nieoczekiwany sposób.

Czy mogę zablokować „dodawanie Firebase” w przypadku istniejącego projektu Google Cloud?

Nie możesz zablokować możliwości „dodania Firebase” do istniejącego projektu Google Cloud, ale możesz wykonać te czynności:

Ogranicz liczbę członków projektu (czyli podmiotów zabezpieczeń), którzy mają uprawnienie IAM firebase.projects.update wymagane do „dodania Firebase”.

Dalsze kroki

• Aby dowiedzieć się więcej o projektach Firebase, zapoznaj się z tymi materiałami:

  • Informacje o projektach Firebase – zawiera krótkie omówienie kilku ważnych pojęć związanych z projektami Firebase, w tym ich związku z Google Cloud oraz podstawowej hierarchii projektu, jego aplikacji i zasobów.

  • Ogólne sprawdzone metody konfigurowania projektów Firebase – zawiera ogólne, podstawowe sprawdzone metody konfigurowania projektów Firebase i rejestrowania w nich aplikacji, aby zapewnić przejrzysty proces programowania z wykorzystaniem różnych środowisk.

• Zacznij korzystać z Firebase w aplikacjach mobilnych i internetowych, rejestrując aplikacje w projekcie Firebase i łącząc je z Firebase: iOS+ | Android | Web | Flutter | Unity | C++.