Mulai Cepat: Mengelola bendera fitur di Azure App Configuration

Azure App Configuration menyertakan bendera fitur, yang dapat Anda gunakan untuk mengaktifkan atau menonaktifkan fungsionalitas, dan bendera fitur varian (pratinjau), yang memungkinkan beberapa variasi bendera fitur.

Pengelola fitur di portal Azure menyediakan UI untuk membuat dan mengelola bendera fitur dan bendera fitur varian yang Anda gunakan di aplikasi Anda.

Prasyarat

Membuat bendera fitur

Tambahkan bendera fitur baru dengan mengikuti langkah-langkah di bawah ini.

  1. Buka penyimpanan Azure App Configuration Anda di portal Azure dan dari menu Operasi, pilih Buat Manajer fitur>. Lalu pilih Bendera fitur.

    Cuplikan layar platform Azure. Buat bendera fitur.

  2. Di bawah Buat, pilih atau masukkan informasi berikut:

    Cuplikan layar portal Azure yang memperlihatkan pengaturan konfigurasi untuk membuat bendera fitur.

    Pengaturan Contoh nilai Deskripsi
    Aktifkan bendera fitur Kotak dicentang Opsi ini memungkinkan bendera fitur saat dibuat. Jika Anda membiarkan kotak ini tidak dicentang, konfigurasi bendera fitur baru akan disimpan tetapi bendera fitur baru akan tetap dinonaktifkan.
    Nama bendera fitur Beta Nama bendera fitur adalah apa yang Anda gunakan untuk mereferensikan bendera dalam kode Anda. Ini harus unik dalam aplikasi.
    Kunci Beta Anda dapat menggunakan kunci untuk memfilter bendera fitur yang dimuat di aplikasi Anda. Kunci dihasilkan dari nama bendera fitur secara default, tetapi Anda juga dapat menambahkan awalan atau namespace untuk mengelompokkan bendera fitur Anda, misalnya, .appconfig.featureflag/myapp/Beta.
    Label Biarkan kosong Anda dapat menggunakan label untuk membuat bendera fitur yang berbeda untuk bendera kunci dan filter yang sama yang dimuat di aplikasi Anda berdasarkan label. Secara default, bendera fitur tidak memiliki label.
    Keterangan Biarkan kosong Biarkan kosong atau masukkan deskripsi untuk bendera fitur Anda.
    Menggunakan filter fitur Kotak tidak dicentang Biarkan kotak filter fitur tidak dicentang. Untuk mempelajari selengkapnya tentang filter fitur, lihat Menggunakan filter fitur untuk mengaktifkan bendera fitur bersyarat dan Mengaktifkan peluncuran fitur bertahap untuk audiens yang ditargetkan.
  3. Pilih Terapkan untuk membuat bendera fitur.

Membuat bendera fitur varian (pratinjau)

Tambahkan bendera fitur varian baru (pratinjau) dengan membuka penyimpanan Azure App Configuration Anda di portal Azure dan dari menu Operasi, pilih Buat manajer>fitur. Lalu pilih Bendera fitur varian (Pratinjau).

Cuplikan layar platform Azure. Buat bendera fitur varian.

Mengonfigurasi dasar-dasar

Di tab Detail , pilih atau masukkan informasi berikut ini:

Cuplikan layar platform Azure memperlihatkan detail bendera fitur varian.

Pengaturan Contoh nilai Deskripsi
Aktifkan bendera fitur Kotak dicentang Opsi ini memungkinkan bendera fitur saat dibuat. Jika Anda membiarkan kotak ini tidak dicentang, konfigurasi bendera fitur baru akan disimpan tetapi bendera fitur baru akan tetap dinonaktifkan.
Nama Pesan Pembuka Nama bendera fitur adalah apa yang Anda gunakan untuk mereferensikan bendera dalam kode Anda. Ini harus unik dalam aplikasi.
Kunci Pesan Pembuka Anda dapat menggunakan kunci untuk memfilter bendera fitur yang dimuat di aplikasi Anda. Kunci dihasilkan dari nama bendera fitur secara default, tetapi Anda juga dapat menambahkan awalan atau namespace untuk mengelompokkan bendera fitur Anda, misalnya, .appconfig.featureflag/myapp/Greeting.
Label Biarkan kosong Anda dapat menggunakan label untuk membuat bendera fitur yang berbeda untuk bendera kunci dan filter yang sama yang dimuat di aplikasi Anda berdasarkan label. Secara default, bendera fitur tidak memiliki label.
Keterangan Biarkan kosong Biarkan kosong atau masukkan deskripsi untuk bendera fitur Anda.

Pilih Berikutnya > untuk menambahkan Varian.

Menambahkan varian

Di tab Varian , pilih atau masukkan informasi berikut.

Cuplikan layar platform Azure memperlihatkan tab varian.

Pengaturan Contoh nilai Deskripsi
Nama varian Nonaktif & Aktif Dua varian ditambahkan secara default. Perbarui atau masukkan nama untuk varian baru. Nama varian harus unik dalam bendera fitur.
Nilai false & true Berikan nilai untuk setiap varian. Nilainya bisa berupa string, angka, boolean, atau objek konfigurasi. Untuk mengedit nilai di editor JSON, Anda dapat memilih Edit nilai dalam multibaris.
Varian default Nonaktif Pilih varian default dari daftar dropdown. Bendera fitur mengembalikan varian default saat tidak ada varian yang ditetapkan ke audiens atau bendera fitur dinonaktifkan. Di samping varian default yang ditunjuk, kata Default ditampilkan.

Pilih Berikutnya > untuk mengakses pengaturan Alokasi .

Mengalokasikan lalu lintas

Di tab Alokasi , pilih atau masukkan informasi berikut ini:

Cuplikan layar platform Azure memperlihatkan alokasi bendera fitur varian lalu lintas.

  1. Distribusikan lalu lintas di setiap varian, menambahkan hingga tepat 100%.

  2. Secara opsional pilih opsi Ambil alih menurut Grup dan Ambil alih oleh Pengguna untuk menetapkan varian untuk grup atau pengguna tertentu. Opsi ini dinonaktifkan secara default.

  3. Di bawah Distribusi, Secara opsional pilih Gunakan seed kustom dan berikan string tidak kosong sebagai nilai seed baru. Menggunakan seed umum di beberapa bendera fitur memungkinkan pengguna yang sama untuk dialokasikan ke persentil yang sama. Ini berguna ketika Anda meluncurkan beberapa bendera fitur secara bersamaan dan Anda ingin memastikan pengalaman yang konsisten untuk setiap segmen audiens Anda. Jika tidak ada seed kustom yang ditentukan, seed default digunakan berdasarkan nama fitur.

  4. Pilih Tinjau + buat untuk melihat ringkasan bendera fitur varian baru Anda, lalu pilih Buat untuk menyelesaikan operasi Anda. Pemberitahuan menunjukkan bahwa bendera fitur baru berhasil dibuat.

Mengedit bendera fitur

Untuk memperbarui bendera fitur atau bendera fitur varian:

Cuplikan layar dari platform Azure. Edit bendera fitur.

  1. Dari menu Operasi , pilih Pengelola fitur.

  2. Pindah ke ujung kanan bendera fitur atau bendera fitur varian yang ingin Anda ubah dan pilih elipsis Tindakan lainnya (...). Dari menu ini, Anda dapat mengedit bendera, mengunci, atau membuka kuncinya, membuat label, memperbarui tag, meninjau riwayat, atau menghapus bendera.

  3. Pilih Edit dan perbarui bendera.

  4. Secara opsional ubah status bendera fitur dengan mengaktifkan atau menonaktifkan tombol Diaktifkan .

Mengelola tampilan

Menu Pengelola fitur menampilkan bendera fitur dan bendera fitur varian yang disimpan di Azure App Configuration. Anda dapat mengubah tampilan Pengelola fitur di portal Azure dengan memilih Kelola tampilan.

  • Pengaturan memungkinkan Anda memilih berapa banyak bendera fitur yang akan dimuat per Memuat lebih banyak tindakan. Muat lebih banyak hanya akan terlihat jika ada lebih dari 200 bendera fitur.

  • Edit Kolom memungkinkan Anda menambahkan atau menghapus kolom dan mengubah urutan kolom.

    Cuplikan layar dari platform Azure. Edit kolom bendera fitur.

Bendera fitur yang dibuat dengan Pengelola fitur disimpan sebagai nilai kunci reguler. Mereka disimpan dengan awalan .appconfig.featureflag/ khusus dan jenis application/vnd.microsoft.appconfig.ff+json;charset=utf-8konten . Untuk melihat nilai kunci yang mendasar dari bendera fitur di Penjelajah konfigurasi, ikuti langkah-langkah di bawah ini.

  1. Di menu Operasi, buka Penjelajah konfigurasi, lalu pilih Kelola tampilan> Pengaturan.

    Cuplikan layar dari platform Azure. Sertakan bendera fitur di Penjelajah konfigurasi.

  2. Pilih Sertakan bendera fitur di penjelajah konfigurasi dan Terapkan.

Langkah berikutnya