Mengelola ekstensi Firebase yang diinstal

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.

Catatan: Semua perintah akan ditetapkan secara default ke nilai saat ini untuk ekstensi yang diinstal, bukan ke nilai default yang tersedia selama penginstalan awal (yang dicantumkan sebagai nilai default dalam file extension.yaml).

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