Mengelola ekstensi Firebase yang diinstal

Untuk menginstal atau mengelola ekstensi, salah satu peran berikut harus ditetapkan untuk Anda: Pemilik atau Editor atau Firebase Admin.

Firebase console Firebase CLI SDK yang Dibuat Secara Otomatis

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

Melihat detail dan konfigurasi instance ekstensi yang terinstal

1. Buka dasbor Firebase Extensions di Firebase console.

2. Pada kartu instance ekstensi yang diinstal, klik Manage.

Memantau instance ekstensi yang terinstal

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

1. Buka dasbor Functions di Firebase console.

2. Di tab Dashboard, 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

Lihat tugas Cloud Scheduler yang dibuat oleh ekstensi

1. Buka halaman Cloud Scheduler dari project Anda di Google Cloud console.

2. 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:

1. Di bagian Extensions Firebase console, buka halaman detail instance ekstensi.

2. Pada halaman detail, buka bagian APIs and resources. Jika ekstensi menggunakan Cloud Tasks, akan ada bagian Cloud Task queues dengan satu atau beberapa entri.

3. Klik View queue 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 secret Cloud Secret Manager yang dibuat oleh ekstensi

1. Buka halaman Secret Manager project Anda di Google Cloud console.

2. Dalam daftar Secret, Anda dapat melihat secret yang dibuat untuk Firebase Extensions (beserta secret lain yang telah dibuat untuk project Anda).

   Secret yang dibuat oleh ekstensi memiliki nama dalam format: ext-extension-instance-id-paramnName

   Contoh: ext-awesome-task-simplifier-API_KEY

   Secret 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 console.

1. Di tab Health pada dasbor Functions, Anda dapat melihat ringkasan informasi performa dan error untuk semua fungsi di project Anda.

2. Untuk melihat informasi terkait ekstensi tertentu, gunakan filter di bagian atas halaman untuk memilih fungsi tertentu.

Memeriksa seberapa sering ekstensi yang diinstal berjalan

1. Di tab Dashboard pada dasbor Functions, temukan fungsi tertentu untuk Firebase Extension yang ingin Anda periksa.

2. Klik (menu tambahan) di sisi paling kanan entri, lalu pilih Detailed usage stats.

3. Di Google Cloud console yang muncul, Anda dapat melihat rincian 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.

Catatan: Jika Anda menginstal ekstensi menggunakan SDK yang dibuat secara otomatis, gunakan metode yang sama untuk mengupgradenya, bukan menggunakan console atau CLI.

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.

1. Buka dasbor Firebase Extensions, lalu klik Manage di kartu instance ekstensi yang diinstal.

2. Di sudut kanan atas, klik Update extension.

   Jika tidak ada versi baru yang tersedia untuk ekstensi tersebut, tombol Update tidak akan muncul di halaman detail.

3. Tinjau fitur baru dalam update tersebut, dan konfigurasi ekstensi (jika diperlukan).

4. Klik Update ekstensi.

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.

Catatan: Jika Anda menginstal ekstensi menggunakan SDK yang dibuat secara otomatis, gunakan metode yang sama untuk mengonfigurasinya, bukan menggunakan console atau CLI.

1. Buka dasbor Firebase Extensions, lalu klik Manage di kartu instance ekstensi yang diinstal.

2. Di sudut kanan atas, klik Reconfigure extension.

3. Ikuti petunjuk di layar untuk mengonfigurasi ulang parameter value ekstensi Anda.

4. Klik Simpan.

Catatan: Sistem memerlukan waktu 3-5 menit untuk menyimpan perubahan ekstensi.

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 bersifat khusus ekstensi, sehingga tidak dihapus jika ekstensi di-uninstal.

Berikut cara meng-uninstal ekstensi:

1. Buka dasbor Firebase Extensions, lalu klik Manage di kartu instance ekstensi yang diinstal.

2. Di bagian bawah layar, klik Uninstall extension.

3. Tinjau item yang akan dihapus, lalu klik Uninstall extension untuk mengonfirmasi penghapusan.

Catatan: Jika Anda menginstal ekstensi menggunakan SDK yang dibuat secara otomatis, pastikan untuk menghapus konfigurasi instance dari kode Cloud Functions Anda.