Untuk menginstal atau mengelola ekstensi, salah satu peran berikut harus ditetapkan untuk Anda: Pemilik atau Editor atau Firebase Admin.
Mencantumkan instance ekstensi yang diinstal di project
Anda dapat mencantumkan setiap instance ekstensi yang diinstal.
Jalankan perintah extensions-list:
firebase ext:list --project=projectId-or-alias
Memantau instance ekstensi yang diinstal
Di Firebase console, Anda dapat memantau aktivitas ekstensi yang diinstal, termasuk memeriksa respons, penggunaan, dan log-nya.
Menetapkan pemberitahuan anggaran
Secara umum, menetapkan pemberitahuan anggaran merupakan praktik yang baik, terutama paling bermanfaat jika Anda mengandalkan kode pihak lain untuk dijalankan di project Anda.
Pastikan Anda menyiapkan pemberitahuan anggaran untuk project Firebase Anda.
Melihat fungsi yang dibuat oleh ekstensi
Buka dasbor Functions di Firebase console.
Di tab Dasbor, Anda dapat melihat fungsi dari Firebase Extensions (beserta semua fungsi lain yang telah di-deploy untuk project Anda).
Fungsi yang dibuat oleh ekstensi memiliki nama dalam format:
ext-extension-instance-id-functionName
Contoh:
ext-awesome-task-simplifier-onUserCreate
Melihat tugas Cloud Scheduler yang dibuat oleh ekstensi
Buka halaman Cloud Scheduler project Anda di Google Cloud Console.
Dalam daftar Tugas, Anda dapat melihat tugas Cloud Scheduler dari Firebase Extensions (beserta tugas lain yang telah dibuat untuk project Anda).
Tugas yang dibuat oleh ekstensi memiliki nama dalam format:
firebase-ext-extension-instance-id-functionName
Contoh:
firebase-ext-awesome-task-simplifier-doTask
Melihat rahasia Cloud Secret Manager yang dibuat oleh ekstensi
Buka halaman Secret Manager project Anda di Google Cloud Console.
Dalam daftar Secret, Anda dapat melihat rahasia yang dibuat untuk Firebase Extensions (beserta rahasia lain yang telah dibuat untuk project Anda).
Rahasia yang dibuat oleh ekstensi memiliki nama dalam format:
ext-extension-instance-id-paramnName
Contoh:
ext-awesome-task-simplifier-API_KEY
Rahasia diberi label dengan kunci
firebase-extensions-managed
. Jangan menghapus label ini kecuali jika Anda ingin agar Firebase berhenti mengelola rahasia tersebut.
Memeriksa apakah ekstensi yang diinstal responsif atau tidak
Anda dapat meninjau semua error dari fungsi (termasuk yang dibuat oleh Firebase Extensions) di Firebase console.
Di tab Respons pada dasbor Functions, Anda dapat melihat ringkasan informasi performa dan error untuk semua fungsi di project Anda.
Untuk melihat informasi terkait ekstensi tertentu, gunakan filter di bagian atas halaman untuk memilih fungsi tertentu.
Memeriksa seberapa sering ekstensi yang diinstal berjalan
Di tab Dasbor pada dasbor Functions, temukan fungsi tertentu untuk ekstensi Firebase yang ingin Anda periksa.
Klik
(menu tambahan) di sisi paling kanan entri, lalu pilih Detail statistik penggunaan.Di Google Cloud Console yang muncul, Anda dapat melihat perincian berbagai pemanggilan fungsi dan bahkan memeriksa kode sumbernya.
Melihat log ekstensi
Jika mencoba mendebug project, atau mengirimkan laporan bug ke Firebase, sebaiknya lihat log fungsi yang berjalan di project Anda.
Di tab Log pada dasbor Functions, gunakan filter di bagian atas halaman untuk memilih fungsi yang dibuat oleh ekstensi Anda.
Mengupdate ekstensi yang terinstal ke versi terbaru
Anda dapat mengupdate instance ekstensi yang diinstal ke versi rilis terbaru. Anda mungkin perlu mengupdate instance yang terinstal karena instance tersebut sudah berjalan aktif atau disiapkan dalam alur kerja pengujian, project, atau aplikasi Anda.
Saat instance diupdate, semua resource dan logika khusus ekstensi dari instance tersebut akan ditimpa untuk menggunakan kode sumber dan file versi baru. ID instance dan akun layanan ekstensi tidak akan berubah.
Selama proses update, Anda akan diberi tahu tentang setiap perubahan pada versi baru, dan dapat menentukan nilai untuk setiap parameter baru.
Jalankan perintah extensions-list untuk mendapatkan ID instance ekstensi:
firebase ext:list --project=projectId-or-alias
Jalankan perintah extension-update:
firebase ext:update extensionInstanceId --project=projectId-or-alias
Mengonfigurasi ulang instance ekstensi yang terinstal
Anda dapat mengubah nilai parameter yang dikonfigurasi pengguna untuk instance ekstensi yang diinstal. Nilai baru tersebut akan digunakan dalam pemicu mendatang untuk instance tersebut, tetapi semua artefak atau elemen struktural sebelumnya yang dibuat oleh ekstensi tersebut (seperti gambar yang disimpan atau bucket penyimpanan yang sudah ada) tidak akan diubah.
Jalankan perintah extensions-list untuk mendapatkan ID instance ekstensi:
firebase ext:list --project=projectId-or-alias
Jalankan perintah extensions-configure:
firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile
Dalam hal ini,
--params
adalah flag opsional untuk menyediakan file yang mendefinisikan nilai parameter yang dapat dikonfigurasi pengguna dan memungkinkan Anda mengabaikan perintah terminal interaktif untuk nilai tersebut. Definisikan nilai dalam file.env
yang mengikuti sintaksis dotenv.Jika diminta (atau jika tidak menyediakan file
.env
), masukkan nilai konfigurasi untuk menyesuaikan ekstensi project Anda.
Meng-uninstal instance ekstensi
Anda dapat meng-uninstal instance ekstensi dari project Firebase. Tindakan ini akan menghapus akun layanan dan semua resource (seperti serangkaian fungsi) yang dibuat oleh Firebase khusus untuk instance ekstensi tersebut. Namun, item berikut tidak dihapus:
Artefak apa pun yang dibuat oleh ekstensi (seperti gambar yang disimpan).
Resource lain apa pun dalam project Anda, misalnya instance database atau bucket Cloud Storage. Meskipun ekstensi berinteraksi dengan resource lain ini, resource tersebut tidak khusus untuk ekstensi tertentu sehingga tidak dihapus jika ekstensi di-uninstal.
Berikut cara meng-uninstal ekstensi:
Jalankan perintah extensions-list untuk mendapatkan ID instance ekstensi:
firebase ext:list --project=projectId-or-alias
Jalankan perintah extension-uninstall:
firebase ext:uninstall extensionInstanceId --project=projectId-or-alias