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.
Buka Firebase console.
Login dengan Akun Google yang sama yang memungkinkan Anda mengakses project Google Cloud yang ada.
Klik Create a project.
Di bagian bawah halaman, klik link untuk Already have a Google Cloud project?
Di kolom teks, mulai masukkan project ID dari project yang ada, lalu pilih project dari daftar yang ditampilkan.
Klik Open project.
Jika diminta, setujui Firebase Terms.
Ikuti petunjuk di layar untuk "menambahkan Firebase" dan menyiapkan project Firebase.
Perhatikan bahwa pengaktifan Google Analytics bersifat opsional.
Instal Firebase CLI jika Anda belum melakukannya.
Login dengan Akun Google yang sama yang memungkinkan Anda mengakses project Google Cloud yang ada.
Jalankan perintah berikut:
firebase projects:addfirebase
Saat diminta, pilih project Google Cloud yang ada dari daftar yang ditampilkan.
Aktifkan Firebase Management API di project Google Cloud yang ada.
Membuat token akses API.
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.
Aktifkan Firebase Management API (
firebase.googleapis.com
) di project Google Cloud yang ada.Aktifkan layanan Firebase untuk project menggunakan resource
google_firebase_project
.
Untuk informasi mendetail tentang penggunaan Firebase dan Terraform, lihat Mulai menggunakan Terraform dan 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.
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:
service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
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".
Dapatkah "menambahkan Firebase" diblokir untuk project Google Cloud yang ada?
Meskipun Anda tidak dapat sepenuhnya memblokir kemungkinan "menambahkan Firebase" ke project Google Cloud yang ada, Anda dapat melakukan hal berikut:
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++.