Template Remote Config adalah serangkaian parameter dan kondisi berformat JSON yang telah Anda buat untuk project Firebase. Anda dapat membuat template klien, tempat aplikasi Anda mengambil nilai, dan template server, tempat klien server mengambil nilai.
Bagian ini membahas template server. Untuk mempelajari template, klik Template klien.Anda dapat mengubah dan mengelola template ini menggunakan Firebase console yang akan menampilkan konten template dalam format grafis di tab Parameters dan Conditions.
Berikut adalah contoh file template server:
{
"parameters": {
"preamble_prompt": {
"defaultValue": {
"value": "You are a helpful assistant who knows everything there is to know about Firebase! "
},
"description": "Add this prompt to the user's prompt",
"valueType": "STRING"
},
"model_name": {
"defaultValue": {
"value": "gemini-pro-test"
},
"valueType": "STRING"
},
"generation_config": {
"defaultValue": {
"value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
},
"valueType": "JSON"
},
},
"version": {
"versionNumber": "19",
"isLegacy": true
}
}
Anda dapat melakukan tugas pengelolaan versi berikut dengan Firebase console:
- Mencantumkan semua versi template yang tersimpan
- Mengambil versi tertentu
- Melakukan roll back ke versi klien tertentu
- Menghapus template Remote Config dari halaman Change history
Batas total versi masa aktif yang tersimpan per jenis template adalah 300 (300 template klien dan 300 template server), yang meliputi nomor versi tersimpan untuk template yang dihapus. Jika Anda memublikasikan lebih dari 300 versi template per jenis template selama masa aktif project, versi paling awal akan dihapus, sehingga mempertahankan jumlah maksimum 300 versi untuk jenis tersebut.
Setiap kali Anda mengupdate parameter, Remote Config akan membuat
template Remote Config versi baru dan menyimpan template sebelumnya sebagai
versi yang dapat Anda ambil atau roll back sesuai kebutuhan. Nomor versi
bertambah secara berurutan dari nilai awal yang disimpan oleh Remote Config.
Semua template menyertakan kolom version seperti yang ditunjukkan, yang berisi metadata tentang
versi spesifik tersebut.
Anda dapat menghapus template Remote Config sesuai kebutuhan dari halaman Change history di Remote Config console.
Mengelola versi template Remote Config
Bagian ini menjelaskan cara mengelola versi template Remote Config.
Mencantumkan semua versi template Remote Config yang tersimpan
Anda dapat mengambil daftar semua versi template Remote Config yang disimpan. Untuk melakukannya:
Dari Firebase console, buka Remote Config.
Kemudian, dari tab Parameters, pilih ikon "jam" di kanan atas.
Tindakan ini akan membuka halaman Change history yang mencantumkan semua versi template tersimpan di menu daftar di sebelah kanan.
Daftar template ini mencakup metadata semua versi yang disimpan, termasuk waktu update, pengguna yang melakukannya, dan bagaimana hal tersebut dilakukan.
Mengambil versi template Remote Config tertentu
Anda dapat mengambil versi template Remote Config tertentu yang tersimpan. Untuk mengambil versi template tersimpan:
Buka panel detail Change history.
Untuk melihat detail dari versi lain dalam daftar, pilih dari menu di sebelah kanan.
Lihat perbedaan terperinci dari template aktif dan versi tersimpan lainnya dengan mengarahkan kursor ke menu konteks untuk setiap versi yang tidak dipilih dan memilih Compare with selected version.
Melakukan roll back ke versi template Remote Config tertentu yang tersimpan
Anda dapat melakukan roll back ke versi template yang tersimpan. Untuk me-roll back template:
- Cari tombol opsi di kanan atas halaman Change history. Klik dan konfirmasi tombol ini hanya jika Anda yakin ingin melakukan roll back ke versi itu dan gunakan nilai tersebut segera untuk semua aplikasi dan pengguna.
Perhatikan bahwa operasi rollback ini secara efektif membuat versi bernomor baru. Misalnya, melakukan roll back dari versi 10 ke versi 6 akan menghasilkan salinan baru untuk versi 6, yang berbeda dari aslinya hanya pada nomor versinya, yaitu 11. Versi 6 yang asli masih disimpan, dengan asumsi bahwa akhir masa berlakunya belum tercapai, yang akan membuat versi 11 menjadi template aktif.
Menghapus template Remote Config
Anda dapat menghapus template Remote Config dari Firebase console. Untuk menghapus template Remote Config:
1. Dari halaman Remote Config Parameters, klik Change history.Alihkan ke template yang ingin Anda hapus, klik More, lalu pilih Delete.
Saat diminta untuk mengonfirmasi penghapusan, klik Delete.
Mendownload dan memublikasikan template Remote Config
Download dan publikasikan template Remote Config untuk mengintegrasikannya ke dalam kontrol sumber dan sistem build, mengotomatiskan update konfigurasi, serta menjaga parameter dan nilai tetap sinkron di beberapa project.
Anda dapat mendownload template Remote Config yang saat ini aktif dari Firebase console. Selanjutnya, Anda dapat memperbarui file JSON yang diekspor dan memublikasikannya ke project yang sama, atau memublikasikannya ke project baru atau yang sudah ada.
Sebagai contoh, Anda memiliki beberapa project yang mewakili berbagai tahap siklus proses pengembangan software, seperti lingkungan pengembangan, pengujian, staging, dan produksi. Dalam hal ini, Anda dapat mempromosikan template yang telah diuji sepenuhnya dari lingkungan staging ke lingkungan produksi dengan mendownloadnya dari project staging dan memublikasikannya ke project produksi.
Anda juga dapat menggunakan metode ini untuk memigrasikan konfigurasi dari satu project ke project lainnya, atau mengisi project baru dengan parameter dan nilai dari project yang sudah stabil.
Parameter dan parameter value yang dibuat khusus sebagai varian dalam eksperimen A/B Testing tidak disertakan dalam template yang diekspor.
Untuk mengekspor dan mengimpor template Remote Config:
- Download template Remote Config Config saat ini.
- Validasi template Remote Config.
- Publikasikan template Remote Config.
Mendownload Template Remote Config saat ini
Gunakan perintah berikut untuk mendownload template Remote Config yang aktif dalam format JSON:
- Dari tab Parameters atau Conditions Remote Config, buka Menu, lalu pilih Download current config file.
- Saat diminta, klik Download config file, pilih lokasi yang diinginkan untuk menyimpan file, lalu klik Save.
Memvalidasi template Remote Config
Template server akan divalidasi saat Anda mencoba memublikasikan konten dari Firebase console. Perlu diperhatikan bahwa kondisi Pengguna dalam Persentase Acak dapat diimpor, tetapi kondisi yang tidak didukung akan menghasilkan error selama upload. Jika Anda mencoba memublikasikan template yang awalnya diekspor dari template klien, pastikan untuk menghapus kondisi khusus klien terlebih dahulu.
Memublikasikan template Remote Config
Setelah mendownload template, melakukan perubahan yang diperlukan pada konten JSON, dan memvalidasinya, Anda dapat memublikasikannya ke project.
Memublikasikan template berarti mengganti seluruh template konfigurasi yang ada dengan file yang telah diperbarui dan menambahkan versi template satu per satu. Karena seluruh konfigurasi diganti, jika Anda menghapus parameter dari file JSON dan memublikasikannya, parameter akan dihapus dari server dan tidak lagi tersedia untuk klien.
Setelah dipublikasikan, perubahan pada parameter dan nilai akan segera tersedia untuk aplikasi dan pengguna Anda. Jika perlu, Anda dapat melakukan roll back ke versi sebelumnya.
Gunakan perintah berikut untuk memublikasikan template Anda:
- Dari tab Parameters atau Conditions Remote Config, buka Menu, lalu pilih Publish from a file.
- Saat diminta, klik Browse, buka dan pilih file Remote Config yang ingin Anda publikasikan, lalu klik Select.
- File akan divalidasi dan, jika berhasil, Anda dapat mengklik Publish agar konfigurasi bisa langsung tersedia bagi aplikasi dan pengguna Anda.
Langkah berikutnya
- Pelajari lebih lanjut cara menggunakan Remote Config di lingkungan server.
- Coba Remote Config sisi server dengan Cloud Functions dan Vertex AI.