Buka konsol

Pembuatan Versi dan Template Remote Config

Template Remote Config adalah serangkaian parameter dan condition berformat JSON di sisi layanan yang telah Anda buat untuk project Firebase. Anda dapat mengubah dan mengelola template ini menggunakan Firebase console yang akan menampilkan konten template dalam format grafis di tab Parameter dan Kondisi. Jika Anda menggunakan REST API untuk mengubah dan mengelola konfigurasi, Anda akan langsung bekerja dengan file template, seperti contoh ini remote-config.json:

{
  "parameters":[
    {
      "key":"welcome_message",
      "value_options":[
        {
          "value":"Welcome to this sample app"
        }
      ]
    },
    {
      "key":"welcome_message_caps",
      "value_options":[
        {
          "value":"false"
        }
      ]
    }
  ],
  "version":{
    "version_number": "42",
    "update_time":"2018-05-11T18:46:40Z",
    "update_user":{
      "name":"Jane Developer",
      "email":"jane@developer.org",
      "imageUrl":"http://image.google.com/path-to-profile-photo-for-jane"
    },
    "description":"Adding welcome messages",
    "origin":"CONSOLE",
    "update_type":"INCREMENTAL_UPDATE"
  }
}

Setiap kali Anda memperbarui parameter, Remote Config 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 urut dari nilai awal yang disimpan oleh Remote Config. Semua template menyertakan kolom version seperti yang ditunjukkan, yang berisi metadata tentang versi spesifik tersebut.

Dengan Firebase console atau REST API, Anda dapat menjalankan tugas pengelolaan versi berikut:

  • Mencantumkan semua versi template tersimpan
  • Mengambil versi tertentu
  • Melakukan roll back ke versi tertentu

Saat Anda mengelola template Remote Config, perhatikan batas masa berlakunya: 90 hari dari waktu pembuatan, atau batas total sebanyak 300 versi tersimpan. Jika Anda ingin menyimpan atau melakukan roll back ke template di luar batas tersebut, simpan secara manual. Template Remote Config aktif saat ini yang digunakan oleh aplikasi Anda tidak akan habis masa berlakunya; namun, jika template tersebut telah aktif selama 90 hari sejak dibuat dan digantikan dengan pembaruan, template ini tidak dapat diambil lagi (karena masa berlakunya).

Mengelola versi template Remote Config dengan Firebase console

Firebase console menyediakan antarmuka grafis agar Anda dapat mencantumkan versi template, melihat detailnya, dan melakukan roll back sesuai kebutuhan. Untuk menjalankan tugas ini:

  1. Di tab Parameter, klik tiga titik yang ditampilkan di kanan atas dan pilih Lihat histori perubahan. Tindakan ini akan membuka halaman Histori perubahan yang mencantumkan semua versi template tersimpan pada menu daftar di sebelah kanan.

  2. Secara default, panel detail menampilkan template aktif saat ini. Untuk melihat detail dari salah satu versi dalam daftar, pilih dari menu di sebelah kanan.

  3. Saat detail untuk sebuah versi tersimpan ditampilkan di panel detail, tombol opsi untuk melakukan roll back ke versi tersebut ditampilkan di kanan atas halaman. 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.

Mengelola versi template Remote Config dengan REST API

Bagian ini menjelaskan cara mengelola versi template Remote Config menggunakan REST API. Untuk mengetahui detail selengkapnya tentang cara membuat, mengubah, dan menyimpan template secara terprogram, lihat Menggunakan REST API Remote Config.

Mencantumkan semua versi tersimpan template Remote Config

Dengan metode HTTP kustom :listVersions, Anda dapat mengambil daftar semua versi tersimpan template Remote Config. Misalnya:

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id:listVersions

Respons ini mencakup metadata untuk semua versi tersimpan, termasuk waktu pembaruan, pengguna yang membuatnya, dan apakah dibuat melalui konsol atau REST API. Berikut ini contoh elemen versi:

{
  "versions": [{
    "version_number": "6",
    "update_time": "2018-05-12T02:38:54Z",
    "update_user": {
      "email": "jane@developer.org",
    },
    "description": "One small change on the console",
    "origin": "CONSOLE",
    "update_type": "INCREMENTAL_UPDATE"
  }]

Mengambil versi template Remote Config tertentu

Dengan menambahkan parameter URL ?version_number, Anda dapat mengambil versi template Remote Config mana saja yang tersimpan. Misalnya:

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig?version_number=6

Parameter ini hanya valid untuk operasi GET; Anda tidak dapat menggunakannya untuk menentukan nomor versi untuk pembaruan. Permintaan get serupa tanpa parameter ?version_number akan mengambil template yang aktif saat ini, seperti yang dijelaskan dalam bagian Mendapatkan JSON dari layanan Remote Config.

Melakukan roll back ke versi tersimpan tertentu template Remote Config

Untuk melakukan roll back ke salah satu template Remote Config tersimpan, keluarkan POST HTTP dengan metode kustom :rollback dan terapkan versi tertentu dalam isi permintaan. Misalnya:

curl --compressed -D headers -H "Authorization: Bearer token" -X POST https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:rollback -d '{"version_number": 6}'

Respons ini berisi konten dari template tersimpan yang aktif saat ini, dengan metadata versi barunya.

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.