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
- Akun Azure dengan langganan aktif. Buat akun gratis.
- Penyimpanan App Configuration. Buat toko.
Membuat bendera fitur
Tambahkan bendera fitur baru dengan mengikuti langkah-langkah di bawah ini.
Buka penyimpanan Azure App Configuration Anda di portal Azure dan dari menu Operasi, pilih Buat Manajer fitur>. Lalu pilih Bendera fitur.
Di bawah Buat, pilih atau masukkan informasi berikut:
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. 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).
Mengonfigurasi dasar-dasar
Di tab Detail , pilih atau masukkan informasi berikut ini:
| 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.
| 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:
Distribusikan lalu lintas di setiap varian, menambahkan hingga tepat 100%.
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.
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.
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:
Dari menu Operasi , pilih Pengelola fitur.
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.
Pilih Edit dan perbarui bendera.
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.
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.
Di menu Operasi, buka Penjelajah konfigurasi, lalu pilih Kelola pengaturan tampilan>.
Pilih Sertakan bendera fitur di penjelajah konfigurasi dan Terapkan.
Langkah berikutnya
Untuk mulai menggunakan bendera fitur dengan Azure App Configuration, lanjutkan ke mulai cepat berikut khusus untuk bahasa atau platform aplikasi Anda.