Mulai menggunakan Firebase dengan project Google Cloud yang ada

Project Firebase adalah project Google Cloud yang memiliki beberapa konfigurasi dan layanan khusus Firebase tambahan yang diaktifkan. Project ini biasanya disebut sebagai "menambahkan Firebase" ke project Google Cloud. Halaman ini menjelaskan cara "menambahkan Firebase", beserta beberapa pertanyaan umum (FAQ).

Saat Anda menambahkan Firebase ke project Google Cloud, Firebase akan otomatis mengaktifkan beberapa API dan membuat akun layanan untuk menyederhanakan penggunaan semua layanan dan antarmuka Firebase. Firebase juga menambahkan label firebase:enabled ke project Anda dalam halaman Labels di Google Cloud console. Pelajari detail selengkapnya tentang apa yang terjadi saat Anda "menambahkan Firebase".

Hubungan antara project Firebase dan project Google Cloud

Karena project Firebase adalah project Google Cloud:

• Anda dapat mengakses dan berinteraksi dengan project di Firebase console, di Google Cloud console, dan di Konsol API Google.

• Anda dapat berinteraksi dengan project menggunakan Firebase CLI, gcloud CLI, dan resource Terraform dari Google.

• Dalam suatu project, Anda dapat menggunakan produk dan API, baik dari Firebase maupun Google Cloud.

• Izin dan peran IAM untuk suatu project digunakan secara bersama-sama di seluruh Firebase dan Google Cloud. Setiap akses yang dimiliki oleh anggota project (yaitu, akun utama) ke project Google Cloud Anda juga akan berlaku untuk project Firebase Anda (dan sebaliknya).

• Tagihan untuk project berlaku di seluruh Firebase dan Google Cloud. Jika penagihan diaktifkan di project Google Cloud, project Firebase Anda akan menggunakan paket harga Blaze bayar sesuai penggunaan dari Firebase.

• ID unik untuk project (seperti nomor project dan project ID) digunakan secara bersama-sama di seluruh Firebase dan Google Cloud.

• Setiap hierarki resource yang diterapkan ke project Google Cloud Anda (misalnya, organisasi, folder, dsb.) juga akan berlaku untuk project Firebase Anda.

• Menghapus sebuah project akan menghapusnya di Firebase dan Google Cloud.

• Menghapus atau mengubah resource atau data dalam project berlaku di seluruh Firebase dan Google Cloud.

Cara menambahkan Firebase ke project Google Cloud yang ada

Anda dapat "menambahkan Firebase" ke project Google Cloud yang ada menggunakan salah satu opsi berikut. Pastikan Anda memiliki izin yang diperlukan untuk menambahkan Firebase ke project Google Cloud.

Perhatikan bahwa setelah Anda "menambahkan Firebase" ke project Google Cloud yang ada, tindakan tersebut tidak dapat dibatalkan (yaitu, Anda tidak dapat sepenuhnya "menghapus Firebase" dari project Google Cloud). Pelajari lebih lanjut di FAQ ini.

Catatan: Untuk mengakses dan menggunakan semua kemampuan Firebase dalam project Google Cloud, Anda harus menyetujui Persyaratan Layanan Firebase. Pelajari lebih lanjut persyaratan untuk Persyaratan Firebase di FAQ ini.

Firebase console

1. Buka Firebase console.

2. Login dengan Akun Google yang sama yang memungkinkan Anda mengakses project Google Cloud yang ada.

3. Klik Create a project.

4. Di bagian bawah halaman, klik link untuk Already have a Google Cloud project?

5. Di kolom teks, mulai masukkan project ID dari project yang ada, lalu pilih project dari daftar yang ditampilkan.

6. Klik Open project.

7. Jika diminta, setujui Firebase Terms.

8. Ikuti petunjuk di layar untuk "menambahkan Firebase" dan menyiapkan project Firebase.

   Perhatikan bahwa pengaktifan Google Analytics bersifat opsional.

Firebase CLI

1. Instal Firebase CLI jika Anda belum melakukannya.

2. Login dengan Akun Google yang sama yang memungkinkan Anda mengakses project Google Cloud yang ada.

3. Jalankan perintah berikut:

   firebase projects:addfirebase

4. Saat diminta, pilih project Google Cloud yang ada dari daftar yang ditampilkan.

Catatan: Jika Anda mendapatkan error 403 PERMISSION_DENIED saat mencoba "menambahkan Firebase" ke project Google Cloud yang ada, hal ini dapat berarti bahwa Anda tidak memiliki izin yang diperlukan atau belum menyetujui Persyaratan Layanan Firebase.

REST API

1. Aktifkan Firebase Management API di project Google Cloud yang ada.

2. Membuat token akses API.

3. Aktifkan layanan Firebase untuk project dengan memanggil projects.addFirebase.

   Perhatikan bahwa Anda memerlukan nama resource project untuk melakukan panggilan ini.

Untuk petunjuk mendetail, lihat Menambahkan layanan Firebase ke project Anda dalam panduan Firebase: "Menyiapkan dan mengelola project Firebase menggunakan Management REST API". Pastikan untuk mengikuti semua petunjuk di bagian Sebelum memulai dalam panduan tersebut.

Catatan: Jika Anda mendapatkan error 403 PERMISSION_DENIED saat mencoba "menambahkan Firebase" ke project Google Cloud yang ada, hal ini dapat berarti bahwa Anda tidak memiliki izin yang diperlukan atau belum menyetujui Persyaratan Layanan Firebase.

Terraform

1. Aktifkan Firebase Management API (firebase.googleapis.com) di project Google Cloud yang ada.

2. Aktifkan layanan Firebase untuk project menggunakan resource google_firebase_project.

Untuk informasi mendetail tentang penggunaan Firebase dan Terraform, lihat Mulai menggunakan Terraform dan Firebase.

Catatan: Jika Anda mendapatkan error 403 PERMISSION_DENIED saat mencoba "menambahkan Firebase" ke project Google Cloud yang ada, hal ini dapat berarti bahwa Anda tidak memiliki izin yang diperlukan atau belum menyetujui Persyaratan Layanan Firebase.

FAQ dan pemecahan masalah

Apakah menyetujui Persyaratan Layanan Firebase diperlukan untuk mulai menggunakan Firebase?

Untuk mengakses dan menggunakan semua kemampuan Firebase dalam project Google Cloud, Anda harus menyetujui Persyaratan Layanan Firebase. Anda juga harus menyetujui Persyaratan Firebase untuk "menambahkan Firebase" ke project Google Cloud yang ada.

Anda hanya perlu menyetujui Persyaratan Firebase sekali untuk Akun Google Anda, berapa pun jumlah project yang dapat Anda akses. Saat menyetujui persyaratan, Anda hanya menyetujuinya untuk Akun Google Anda; persetujuan tidak dilakukan di level project untuk semua anggota project.

Anda dapat menyetujui Persyaratan Firebase melalui Firebase console menggunakan salah satu opsi berikut. Saat diminta, setujui Persyaratan.

• Buat project Firebase baru menggunakan Firebase console.

• Buka project Firebase yang ada di Firebase console (misalnya, seseorang telah mengundang Anda untuk menjadi anggota project (yaitu, akun utama) di project tersebut).

• Buka Google Cloud yang ada di Firebase console dan "tambahkan Firebase" ke dalamnya.

Catatan: Anda tidak dapat menyetujui Persyaratan Firebase menggunakan Firebase CLI, REST API, atau Terraform. Tindakan ini hanya dapat dilakukan menggunakan Firebase console.

Penting: Jika Anda menandatangani varian offline Perjanjian Master Google Cloud untuk penggunaan layanan Firebase tertentu dalam Akun Google Cloud Platform yang sama, Persyaratan Firebase tidak berlaku untuk penggunaan layanan Firebase tersebut, dan persyaratan offline Anda akan mengatur penggunaan layanan Firebase tersebut.

Izin mana yang diperlukan untuk "menambahkan Firebase"?

Untuk "menambahkan Firebase" ke project Google Cloud yang ada, anggota project (yaitu akun utama) harus memiliki izin IAM berikut:

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

Peran IAM Editor dan Pemilik berisi izin ini secara default.

Apakah menambahkan label firebase:enabled sudah cukup untuk menambahkan Firebase?

Semua project Firebase memiliki label firebase:enabled dalam halaman Labels di Google Cloud console.

Namun, menambahkan label firebase:enabled secara manual ke daftar label project Anda TIDAK mengaktifkan konfigurasi dan layanan khusus Firebase untuk project Google Cloud Anda. Untuk melakukannya, Anda perlu menambahkan Firebase menggunakan Firebase console (atau, untuk kasus penggunaan lanjutan, menggunakan Firebase CLI, Firebase Management REST API, atau Terraform).

Apa yang terjadi jika Anda "menambahkan Firebase" ke project Google Cloud yang ada?

Project Firebase adalah project Google Cloud yang memiliki beberapa konfigurasi dan layanan khusus Firebase tambahan yang diaktifkan. Jadi, saat Anda "menambahkan Firebase" ke project Google Cloud yang ada, Firebase akan melakukan tindakan berikut untuk menyederhanakan penggunaan semua layanan dan antarmuka Firebase:

• Menambahkan label firebase:enabled dalam halaman Labels di Google Cloud console.

• Membuat kunci API "Browser" dan membatasinya secara otomatis ke API terkait Firebase.

• Membuat akun layanan berikut:

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

• Mengaktifkan API berikut:

  • 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

Dapatkah saya "menghapus Firebase" dari project?

Setelah Anda "menambahkan Firebase" ke project Google Cloud yang ada, tindakan ini tidak dapat diurungkan (yaitu, Anda tidak dapat sepenuhnya "menghapus Firebase" dari project Google Cloud).

Proses "menambahkan Firebase" akan mengaktifkan API dan layanan backend yang dapat digunakan untuk fitur Google Cloud lainnya. Penonaktifan semua layanan yang diaktifkan ini dapat menyebabkan konsekuensi yang tidak terduga dan tidak diinginkan karena dependensi.

Namun, jika Anda memilih, Anda dapat menonaktifkan semua API secara manual dan menghapus label, kunci API, dan akun layanan yang otomatis diaktifkan dan dibuat saat Anda "menambahkan Firebase".

Peringatan: Jika Anda memilih untuk menonaktifkan dan menghapus secara manual apa yang terjadi selama "menambahkan Firebase", lakukan dengan sangat hati-hati. Anda harus benar-benar yakin bahwa project Google Cloud dan aplikasi yang terkait dengan project tersebut tidak menggunakan apa pun yang terkait dengan apa yang Anda nonaktifkan dan hapus; jika tidak, project atau aplikasi Anda dapat berhenti berfungsi atau berperilaku dengan cara yang tidak terduga.

Dapatkah "menambahkan Firebase" diblokir untuk project Google Cloud yang ada?

Ya, Anda dapat memblokir kemungkinan "menambahkan Firebase" ke project Google Cloud yang ada. Berikut adalah beberapa opsinya:

• Blokir pengaktifan firebase.googleapis.com API menggunakan batasan "Restrict allowed Google Cloud APIs and services".

• Batasi anggota project (yaitu, akun utama) yang memiliki izin IAM firebase.projects.update, yang diperlukan untuk "menambahkan Firebase". Anda dapat menggunakan kebijakan penolakan IAM untuk melakukannya secara efisien.

Langkah berikutnya

• Lihat referensi berikut untuk mempelajari project Firebase lebih lanjut:

  • Memahami project Firebase — memberikan ringkasan singkat tentang beberapa konsep penting tentang project Firebase, termasuk hubungannya dengan Google Cloud dan hierarki dasar suatu project serta aplikasi dan resource-nya.

  • Praktik terbaik umum untuk menyiapkan project Firebase — memberikan praktik terbaik umum dan tingkat tinggi untuk menyiapkan project Firebase dan mendaftarkan aplikasi dengan suatu project sehingga Anda memiliki alur kerja pengembangan yang jelas menggunakan lingkungan berbeda.

• Mulai gunakan Firebase di aplikasi seluler dan web dengan mendaftarkan aplikasi ke project Firebase dan menghubungkannya ke Firebase: iOS+ | Android | Web | Flutter | Unity | C++.