Pierwsze kroki z Firebase w istniejącym projekcie Google Cloud

Projekt w Firebase to projekt Google Cloud, który ma włączone dodatkowe konfiguracje i usługi Firebase. Zwykle nazywa się to „dodawaniem Firebase” do projektu Google Cloud. Na tej stronie opisujemy, jak „dodać Firebase”, oraz podajemy odpowiedzi na najczęstsze pytania.

Gdy dodasz Firebase do projektu Google Cloud, Firebase 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ż etykietę firebase:enabled do projektu na stronie Uprawnienia i administracja > Etykiety w konsoli Google Cloud. Dowiedz się więcej o tym, co się dzieje, gdy „dodajesz Firebase”.

Relacja między projektem w Firebase a projektem Google Cloud

Projekt Firebase jest projektem Google Cloud, więc:

• Możesz uzyskać dostęp do projektu i korzystać z niego w konsoli Firebase, a także w konsoli Google Cloud i konsoli interfejsów API Google.

• Możesz korzystać z projektu 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 z Google Cloud.

• Uprawnienia i role uprawnień w projekcie są współdzielone między Firebase i Google Cloud. Każdy dostęp, jaki członek projektu (czyli podmiot zabezpieczeń) ma do projektu Google Cloud, będzie też obowiązywać w projekcie Firebase (i na odwrót).

• Płatności za projekt są współdzielone przez Firebase i Google Cloud. Jeśli w projekcie Google Cloud są włączone płatności, Twój projekt w Firebase będzie objęty abonamentem Blaze Firebase z płatnością według wykorzystania.

• Unikalne identyfikatory projektu (takie jak numer projektu i identyfikator projektu) są udostępniane Firebase i Google Cloud.

• Każda hierarchia zasobów zastosowana do projektu Google Cloud (np. organizacja, foldery itp.) będzie też stosowana do projektu w Firebase.

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

• Usunięcie lub zmodyfikowanie zasobu lub danych w projekcie ma zastosowanie zarówno w Firebase, jak i w Google Cloud.

Jak dodać Firebase do istniejącego projektu Google Cloud

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

Pamiętaj, że po „dodaniu Firebase” do dotychczasowego projektu Google Cloud nie można tego cofnąć (czyli nie można całkowicie „usunąć Firebase” z projektu Google Cloud). Więcej informacji znajdziesz w najczęstszych pytaniach.

Uwaga: aby mieć dostęp do wszystkich funkcji Firebase w projekcie Google Cloud i móc z nich korzystać, musisz zaakceptować Warunki korzystania z usługi Firebase. Dowiedz się więcej o wymaganiu zaakceptowania Warunków korzystania z Firebase.

W dalszej części tej strony znajdziesz inne najczęstsze pytania i rozwiązania problemów dotyczące dodawania Firebase do projektu Google Cloud.

Konsola Firebase

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

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

3. U dołu strony kliknij Add Firebase to Google Cloud project (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. Jeśli pojawi się taka prośba, zaakceptuj Warunki korzystania z Firebase.

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

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

Interfejs wiersza poleceń Firebase

1. Zainstaluj interfejs wiersza poleceń Firebase, jeśli jeszcze nie jest zainstalowany.

2. Zaloguj się na to samo konto Google, które daje Ci dostęp do dotychczasowego 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 nie zaakceptowano Warunków korzystania z usługi Firebase.

Interfejs API typu REST

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

2. Wygeneruj token dostępu do interfejsu API.

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

   Pamiętaj, że do wykonania tego wywołania potrzebujesz nazwy zasobu projektu.

Szczegółowe instrukcje znajdziesz w sekcji Dodawanie usług Firebase do projektu w przewodniku po Firebase „Konfigurowanie projektu w Firebase i zarządzanie nim za pomocą interfejsu Management REST API”. Wykonaj wszystkie instrukcje podane 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 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 nie zaakceptowano Warunków korzystania z usługi Firebase.

Najczęstsze pytania i rozwiązywanie problemów

Czy aby zacząć korzystać z Firebase, muszę zaakceptować Warunki korzystania z usługi Firebase?

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

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

Warunki korzystania z Firebase możesz zaakceptować w konsoli Firebase, korzystając z jednej z tych opcji. Gdy pojawi się prośba, zaakceptuj warunki. Jeśli nie pojawi się prośba o zaakceptowanie warunków Firebase, oznacza to, że zostały już zaakceptowane.

• Zaakceptuj Warunki korzystania z Firebase bezpośrednio w procesie akceptacji warunków.

• Utwórz nowy projekt w Firebase w konsoli Firebase, a następnie zaakceptuj Warunki korzystania z Firebase.

• Otwórz istniejący projekt w Firebase w konsoli Firebase, a następnie zaakceptuj Warunki korzystania z Firebase (np. ktoś zaprosił Cię do zostania członkiem projektu (czyli podmiotem zabezpieczeń) w projekcie).

• Otwórz istniejący projekt Google Cloud w konsoli Firebase, „dodaj Firebase” do niego, a następnie zaakceptuj Warunki korzystania z Firebase.

Uwaga: zaakceptowanie Warunków korzystania z usługi Firebase nie jest możliwe za pomocą interfejsu wiersza poleceń Firebase, interfejsu API REST ani Terraform. Można to zrobić tylko w konsoli Firebase, korzystając z jednej z opisanych powyżej opcji.

Ważne: jeśli podpisano wersję offline Umowy nadrzędnej 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 warunkom offline.

Jakie uprawnienia są wymagane do „dodania Firebase”?

Aby „dodać Firebase” do istniejącego projektu Google Cloud, użytkownik projektu (czyli podmiot zabezpieczeń) musi mieć te uprawnienia uprawnienia:

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

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

Dlaczego konsola Firebase nie może wczytać listy moich dotychczasowych projektów Google Cloud?

Te najczęstsze pytania dotyczą najczęściej sytuacji, gdy próbujesz „dodać Firebase” do istniejącego projektu Google Cloud za pomocą konsoli Firebase i masz dostęp do wielu tysięcy projektów Google Cloud.

Konsola Firebase nie jest przeznaczona do wczytywania wielu tysięcy projektów Google Cloud. Zamiast tego zalecamy użycie interfejsu wiersza poleceń Firebase, interfejsu API typu REST lub Terraform, aby „dodać Firebase” do istniejącego projektu Google Cloud.

Możesz też zapoznać się z odpowiedzią na najczęstsze pytanie „Dlaczego mój projekt w Firebase nie wyświetla się na liście projektów w Firebase?”.

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

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

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

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

Projekt w Firebase to projekt Google Cloud, który ma włączone 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 Uprawnienia i administracja > 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 projektu Google Cloud nie można tego cofnąć (czyli nie można całkowicie „usunąć Firebase” z projektu Google Cloud).

Proces „dodawania Firebase” włącza interfejsy API i usługi backendu, które mogą być używane przez inne funkcje Google Cloud. Wyłączenie wszystkich tych włączonych usług może spowodować nieoczekiwane i niezamierzone 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 interfejsu API oraz konta usługi, które zostały automatycznie włączone i utworzone po „dodaniu Firebase”.

Ostrzeżenie: jeśli zdecydujesz się ręcznie wyłączyć i usunąć to, co zostało utworzone podczas „dodawania Firebase”, zachowaj szczególną ostrożność. Musisz mieć absolutną pewność, że Twój projekt Google Cloud i powiązane z nim aplikacje nie używają żadnych funkcji związanych z tym, co wyłączasz i usuwasz. W przeciwnym razie projekt lub aplikacja mogą przestać działać lub zachowywać się w nieoczekiwany sposób.

Czy mogę zablokować „dodawanie Firebase” do 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ę użytkowników projektu (czyli podmiotów zabezpieczeń), którzy mają uprawnienie uprawnień firebase.projects.update wymagane do „dodania Firebase”.

Dalsze kroki

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

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

  • Ogólne sprawdzone metody konfigurowania projektów w Firebase – ogólne, ogólne sprawdzone metody konfigurowania projektów w Firebase i rejestrowania aplikacji w projekcie, które pozwalają uzyskać przejrzysty przepływ pracy programowania z wykorzystaniem różnych środowisk.

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