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 dan mengelola Cloud Tasks yang diantrekan oleh ekstensi

Beberapa ekstensi menggunakan Cloud Tasks untuk menjalankan tugas yang berjalan lebih lama: biasanya, memproses tugas yang berjalan di berbagai tahap dalam siklus proses ekstensi—penginstalan, konfigurasi ulang, dan setelah upgrade.

Biasanya, tugas ini berjalan dan diselesaikan secara otomatis, tanpa intervensi Anda. Namun, jika Anda perlu mengelola tugas antrean ekstensi secara manual, misalnya, untuk menjeda antrean atau menghapus tugas yang belum dimulai dari antrean, ikuti langkah-langkah berikut:

Di bagian Ekstensi Firebase console, buka halaman detail instance ekstensi.
Pada halaman detail, buka bagian API dan resource. Jika ekstensi menggunakan Cloud Tasks, akan ada bagian Task queue Cloud dengan satu atau beberapa entri.
Klik Lihat antrean untuk antrean yang ingin Anda kelola. Tindakan ini akan membuka halaman Detail Antrean di Google Cloud Console, tempat Anda dapat melihat tugas yang diantrekan, menjeda antrean, menghapus tugas dari antrean, dan sebagainya. Lihat bagian Mengelola antrean dan tugas di dokumentasi Cloud Tasks.

Catatan: Anda dapat menjeda antrean, tetapi jika Anda menjedanya terlalu lama, tugas mungkin akan gagal dengan error autentikasi saat Anda melanjutkan antrean. (Autentikasi tugas berakhir satu jam setelah bergabung dengan antrean.)
Peringatan: Jangan hapus antrean; ekstensi memerlukannya untuk beroperasi. Jika tidak sengaja menghapus antrean, Anda harus melakukan hal berikut:
1. Instal instance ekstensi baru.
2. Setelah instance baru diinstal, uninstal instance lama.

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.

Untuk mengupdate instance ekstensi di manifes ekstensi Anda ke versi terbaru, jalankan perintah update ekstensi:
```
firebase ext:update extensionInstanceId
```
Untuk mengupdate ke versi tertentu, berikan versi yang ingin Anda update:
```
firebase ext:update extensionInstanceId versionNumber
```
Kemudian, untuk men-deploy ekstensi di manifes Anda ke project Firebase, jalankan:
```
firebase deploy --only extensions --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.

Untuk mengonfigurasi ulang ekstensi di manifes ekstensi secara interaktif, jalankan perintah konfigurasi ekstensi:
```
firebase ext:configure extensionInstanceId
```
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).
Kemudian, untuk men-deploy ekstensi di manifes Anda ke project Firebase, jalankan:
```
firebase deploy --only extensions --project=projectId-or-alias
```

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:

Untuk menghapus instance ekstensi dari manifes ekstensi Anda, jalankan perintah uninstal ekstensi:
```
firebase ext:uninstall extensionInstanceId
```
Kemudian, untuk men-deploy perubahan di manifes Anda ke project Firebase, jalankan:
```
firebase deploy --only extensions --project=projectId-or-alias
```