Pierwsze kroki z Firebase w istniejącym projekcie Google Cloud

Projekt Firebase to projekt Google Cloud, w którym włączono dodatkowe konfiguracje i usługi Firebase. Nazywa się to „dodaniem Firebase” do projektu Google Cloud. Na tej stronie znajdziesz opis dodawania Firebase oraz odpowiedzi na najczęstsze pytania.

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

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

Ponieważ projekt Firebase jest projektem Google Cloud:

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

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

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

• Uprawnienia i role w usłudze IAM dotyczące projektu są udostępniane w Firebase i Google Cloud. Dostęp członka projektu (czyli głównego użytkownika) do projektu Google Cloud będzie również dotyczył Twojego projektu Firebase (i odwrotnie).

• Płatności za projekt są wspólne dla Firebase i Google Cloud. Jeśli w projekcie Google Cloud płatności są włączone, projekt Firebase będzie korzystać z abonamentu Blaze (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 Twoim projekcie Firebase.

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

• Usunięcie lub zmodyfikowanie 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 wymagane uprawnienia do dodania Firebase do projektu Google Cloud.

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

Uwaga: aby uzyskać dostęp do wszystkich funkcji Firebase w projekcie Google 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 odpowiedziach na najczęstsze pytania.

Konsola Firebase

1. Otwórz konsolę Firebase.

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

3. Kliknij Utwórz projekt.

4. U dołu strony kliknij link Masz już projekt Google Cloud?

5. W polu tekstowym zacznij wpisywać identyfikator istniejącego projektu, a potem wybierz go z wyświetlonej listy.

6. Kliknij Otwórz projekt.

7. Jeśli pojawi się taka prośba, zaakceptuj Warunki korzystania z usługi Firebase.

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

   Włączanie opcji Google Analytics jest opcjonalne.

Firebase CLI

1. Zainstaluj interfejs wiersza poleceń Firebase (jeśli jeszcze go nie masz).

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ę taka prośba, wybierz istniejący projekt Google Cloud z wyświetlonej listy.

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 zaakceptowałeś(-aś) Warunków korzystania z 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 funkcję projects.addFirebase.

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

Szczegółowe instrukcje znajdziesz w sekcji Dodaj usługi Firebase do projektu w poniższych przewodnikach Firebase: „Konfigurowanie projektu Firebase i zarządzanie nim za pomocą interfejsu Management REST API” i „Konfigurowanie projektu Firebase i zarządzanie nim za pomocą interfejsu Management REST API”. Pamiętaj, aby postępować zgodnie ze wszystkimi instrukcjami podanymi 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 zaakceptowałeś(-aś) Warunków korzystania z usługi Firebase.

Terraform

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

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

Szczegółowe informacje o używaniu Firebase i Terraform znajdziesz w artykule Początkujący: Firebase i Terraform.

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 zaakceptowałeś(-aś) Warunków korzystania z usługi Firebase.

Najczęstsze pytania i rozwiązywanie problemów

Czy zaakceptowanie Warunków korzystania z usługi Firebase jest wymagane, aby zacząć korzystać z Firebase?

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

Warunki korzystania z Firebase musisz zaakceptować tylko 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. Nie akceptujesz ich na poziomie projektu w przypadku wszystkich członków projektu.

Warunki korzystania z Firebase możesz zaakceptować w konsoli Firebase, korzystając z jednej z podanych niżej opcji. Gdy pojawi się odpowiedni komunikat, zaakceptuj Warunki.

• Utwórz nowy projekt Firebase w konsoli Firebase.

• Otwórz istniejący projekt Firebase w konsoli Firebase (np. ktoś zaprosił Cię do zostania członkiem projektu, czyli osobą główną).

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

Uwaga: akceptacja Warunków korzystania z usługi Firebase nie jest możliwa za pomocą interfejsu wiersza poleceń Firebase, interfejsu API REST ani Terraform. Można to zrobić tylko w konsoli Firebase.

Ważne: jeśli korzystasz z wersji offline Umowy Ramowej 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, a Twoje korzystanie z tych usług podlega postanowieniom umowy 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

Te uprawnienia są domyślnie zawarte w rolach uprawnień Edytujący i Właściciel.

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

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

Ręczne dodanie etykiety firebase:enabled do listy etykiet projektu NIE powoduje włączenia konfiguracji i usług Firebase w projekcie Google Cloud. Aby to zrobić, musisz dodać Firebase w konsoli Firebase (w przypadku zaawansowanych zastosowań możesz użyć interfejsu wiersza poleceń Firebase, interfejsu API REST Firebase Management lub Terraform).

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

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

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

• Tworzy klucz interfejsu API „Browser” 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
  • Interfejs Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Interfejs API Linków dynamicznych Firebase
  • Firebase Hosting API
  • Interfejs Firebase Installations API
  • Firebase Management API
  • Zdalne konfigurowanie interfejsu API Firebase
  • Interfejs Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

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

Po „dodaj 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” umożliwia tworzenie interfejsów API i usług backendowych, które mogą być używane do innych funkcji Google Cloud. Wyłączenie wszystkich tych usług może spowodować nieoczekiwane i niezamierzone konsekwencje z powodu zależności.

Jeśli chcesz, możesz jednak ręcznie wyłączyć wszystkie interfejsy API oraz usunąć etykietę, klucz interfejsu API i 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 miało miejsce podczas „dodawania Firebase”, rób to z bardzo dużą ostrożnością. Musisz mieć absolutną pewność, że projekt Google Cloud i powiązane z nim aplikacje nie korzystają z niczego, co wyłączasz lub usuwasz. W przeciwnym razie projekt lub aplikacja mogą przestać działać lub zachowywać się w nieoczekiwany sposób.

Czy „dodawanie Firebase” może być zablokowane w przypadku istniejącego projektu Google Cloud?

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

Ogranicz liczbę członków projektu (czyli podmiotów zabezpieczeń), którzy mają uprawnienia IAM firebase.projects.update, które są wymagane do „dodania Firebase”. Możesz to zrobić, korzystając z zasady odmowy uprawnień.

Dalsze kroki

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

  • Projekty Firebase – zawierają krótkie omówienie kilku ważnych pojęć dotyczących projektów Firebase, w tym ich związku z Google Cloud oraz podstawową hierarchię projektu, jego aplikacji i zasobów.

  • Ogólne sprawdzone metody konfigurowania projektów Firebase – zawierają ogólne sprawdzone metody konfigurowania projektów Firebase oraz rejestrowania w nich aplikacji, dzięki którym będziesz mieć jasny proces programowania, który wykorzystuje odrębne środowiska.

• Aby zacząć korzystać z Firebase w aplikacjach mobilnych i internetowych, zarejestruj swoje aplikacje w projekcie Firebase i połącz je z tą usługą: iOS+ | Android | Web | Flutter | Unity | C++.