Azure App Configuration menyediakan manajemen fitur melalui bendera fitur, memungkinkan tim mengontrol fungsionalitas aplikasi secara dinamis tanpa menyebarkan ulang kode. Ini memungkinkan peluncuran yang aman dan ditargetkan, eksperimen yang lebih cepat, dan pengurangan risiko, memberikan pengembang kontrol yang fleksibel atas perilaku aplikasi dan kemampuan untuk merespons dengan cepat mengubah kebutuhan bisnis atau pelanggan.
Pengelola fitur di portal Microsoft Azure menyediakan UI untuk membuat dan mengelola bendera fitur yang Anda gunakan di aplikasi Anda.
Prasyarat
Membuat bendera fitur
Buat bendera fitur baru di portal Microsoft Azure dengan mengikuti langkah-langkah di bawah ini.
Buka Azure App Configuration store Anda di portal Azure. Di menu sumber daya, di bawah Operasi, pilih Manajer Fitur>Buat.
Di bawah Untuk apa Anda akan menggunakan bendera fitur Anda?, pilih salah satu tujuan berikut:
-
Sakelar – Aktifkan/matikan fitur dengan sakelar sederhana. Gunakan untuk pengalih dan skenario operasional berumur pendek di mana kontrol aktif/nonaktif tunggal sudah cukup.
-
Penerapan Bertahap - Secara bertahap mengaktifkan fitur untuk sejumlah persentase pengguna. Gunakan untuk rilis fitur bertahap guna mengurangi risiko, serta untuk peluncuran uji coba atau bertahap di seluruh lingkungan sistem atau segmen pengguna.
-
Eksperimen – Jalankan eksperimen terkontrol dengan alokasi lalu lintas untuk menentukan varian berkinerja terbaik. Gunakan untuk pengujian A/B, eksperimen multivariat, atau evaluasi fitur berbasis metrik, dan skenario lain yang memerlukan perbandingan statistik.
Gunakan Beralih untuk mengaktifkan atau menonaktifkan fungsionalitas secara instan untuk semua pengguna.
Konfigurasikan Pengaturan Dasar untuk menetapkan properti inti fitur flag Anda.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Aktifkan bendera fitur |
Aktifkan tombol |
Opsi ini mengaktifkan feature flag pada saat pembuatan. Jika Anda menonaktifkan ini, konfigurasi bendera fitur baru disimpan tetapi bendera fitur baru 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/Beta. |
|
Label |
Biarkan kosong |
Anda dapat menggunakan label untuk membuat flag fitur yang berbeda untuk kunci yang sama dan memfilter flag yang dimuat di aplikasi Anda berdasarkan label. Secara default, bendera fitur tidak memiliki label. |
|
Deskripsi |
Biarkan kosong |
Biarkan kosong atau masukkan deskripsi untuk bendera fitur Anda. |
Konfigurasikan Telemetri untuk mengumpulkan peristiwa evaluasi untuk bendera fitur ini. Saat diaktifkan, peristiwa evaluasi dikirim ke penerbit telemetri yang Anda konfigurasikan di aplikasi Anda. Sebelum mengaktifkan telemetri, tautkan sumber daya Application Insights ke penyimpanan App Configuration di Telemetri>App Insights.
Pilih Tinjau + buat untuk melihat ringkasan bendera fitur baru Anda, lalu pilih Buat untuk menyelesaikan operasi Anda. Pemberitahuan menunjukkan bahwa bendera fitur baru berhasil dibuat.
Gunakan Peluncuran untuk mengekspos fitur secara progresif ke persentase pengguna.
Konfigurasikan Pengaturan Dasar untuk menetapkan properti inti fitur flag Anda.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Aktifkan bendera fitur |
Aktifkan tombol |
Opsi ini mengaktifkan feature flag pada saat pembuatan. Jika Anda menonaktifkan ini, konfigurasi bendera fitur baru disimpan tetapi bendera fitur baru 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 flag fitur yang berbeda untuk kunci yang sama dan memfilter flag yang dimuat di aplikasi Anda berdasarkan label. Secara default, bendera fitur tidak memiliki label. |
|
Deskripsi |
Biarkan kosong |
Biarkan kosong atau masukkan deskripsi untuk bendera fitur Anda. |
Di tab Audiens, aktifkan bendera fitur untuk persentase tertentu, atau sertakan atau kecualikan grup dan pengguna secara eksplisit.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Persentase Default |
0–100 |
Masukkan nilai antara 0 dan 100 untuk menentukan persentase pengguna yang menerima fitur secara default. |
|
Ambil alih menurut Grup |
Nonaktif (tidak dicentang) |
Pilih untuk mengaktifkan penggantian berbasis grup. Saat diaktifkan, Anda dapat: - Tambahkan grup untuk secara eksplisit disertakan dalam peluncuran, dan atur persentase anggota grup yang harus menerima fitur tersebut.
- Tambahkan grup untuk dikecualikan dari peluncuran.
|
|
Ambil alih oleh Pengguna |
Nonaktif (tidak dicentang) |
Pilih untuk mengaktifkan penargetan berbasis pengguna. Saat diaktifkan, Anda dapat menentukan pengguna individual untuk disertakan atau dikecualikan. |
Di tab Konfigurasi , konfigurasikan nilai untuk bendera fitur Anda. Aplikasi Anda dapat mengambil konfigurasi yang sesuai dengan mengevaluasi nilai mana yang berlaku untuk setiap pengguna.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Sertakan konfigurasi |
Kotak dicentang |
Pilih untuk melampirkan pengaturan nilai kunci ke bendera fitur. Pengaturan ini memungkinkan aplikasi Anda menyesuaikan perilaku secara dinamis tanpa menyebarkan ulang kode. |
|
Konfigurasi Lama |
{"color":"blue"} |
Memperlihatkan nilai konfigurasi yang sebelumnya terkait dengan bendera fitur sebelum pembaruan ini. Gunakan ini untuk membandingkan perubahan dan melacak versi. |
|
Konfigurasi Baru |
{"color":"green"} |
Memperlihatkan nilai konfigurasi yang diperbarui yang Anda terapkan sekarang. Nilai-nilai ini akan mengambil alih konfigurasi lama dan menentukan perilaku baru saat bendera fitur diaktifkan. |
Konfigurasikan Kondisi untuk menjadwalkan perubahan dan mengelola batasan kustom untuk melayani fitur Anda.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Tambahkan jadwal |
Mulai: 2025-11-01
Akhir: 2025-11-15
Zona waktu: (UTC-06.00) Waktu Tengah (AS & Kanada)
Pengulangan: dinonaktifkan |
Tentukan peluncuran berbasis waktu dengan menentukan tanggal mulai dan berakhir. Secara opsional perbarui zona waktu yang disarankan dan aktifkan pengulangan untuk aktivasi berulang. |
|
Menambahkan kondisi kustom |
User.Subscription == "Premium" |
Buat kondisi berdasarkan atribut kustom (misalnya, wilayah, jenis perangkat, atau tingkat langganan). Kondisi memungkinkan Anda menargetkan dengan tepat pengguna mana yang menerima fitur tersebut. |
|
Mengharuskan semua filter fitur diaktifkan |
Aktif (diperiksa) |
Opsi ini hanya muncul setelah Anda mengaktifkan Tambahkan kondisi kustom dan Tambahkan jadwal. Saat dicentang, semua filter fitur yang diaktifkan harus dievaluasi ke benar agar fitur diterapkan (logika DAN). Saat tidak dicentang, filter dievaluasi secara independen (logis ATAU). |
Konfigurasikan Telemetri untuk mengumpulkan peristiwa evaluasi untuk bendera fitur ini. Saat diaktifkan, peristiwa evaluasi dikirim ke penerbit telemetri yang Anda konfigurasikan di aplikasi Anda. Sebelum mengaktifkan telemetri, tautkan sumber daya Application Insights ke penyimpanan App Configuration di Telemetri>App Insights.
Pilih Tinjau + buat untuk melihat ringkasan bendera fitur baru Anda, lalu pilih Buat untuk menyelesaikan operasi Anda. Pemberitahuan menunjukkan bahwa bendera fitur baru berhasil dibuat.
Gunakan Eksperimen untuk menjalankan pengujian A/B dan membandingkan varian.
Konfigurasikan Pengaturan Dasar untuk menetapkan properti inti fitur flag Anda.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Aktifkan bendera fitur |
Aktifkan tombol |
Opsi ini mengaktifkan feature flag pada saat pembuatan. Jika Anda menonaktifkan ini, konfigurasi bendera fitur baru disimpan tetapi bendera fitur baru 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 flag fitur yang berbeda untuk kunci yang sama dan memfilter flag yang dimuat di aplikasi Anda berdasarkan label. Secara default, bendera fitur tidak memiliki label. |
|
Deskripsi |
Biarkan kosong |
Biarkan kosong atau masukkan deskripsi untuk bendera fitur Anda. |
Konfigurasikan Varian untuk membandingkan perilaku, mengalokasikan lalu lintas, dan menjalankan pengujian yang ditargetkan.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Nama varian |
Varian 1 |
Masukkan nama unik untuk setiap varian. |
|
Nilai |
<your-variant-1-value> |
Nilai yang dikembalikan untuk variabel. Ini bisa berupa string, angka, boolean, atau objek JSON. Gunakan Edit nilai dalam multibaris untuk konfigurasi JSON kompleks yang dibaca aplikasi Anda saat mengevaluasi bendera. |
|
Varian bawaan |
Varian 1 (Default) |
Pilih satu varian sebagai fallback dan garis besar yang stabil. Varian ini dikembalikan ketika tidak ada penugasan tertentu yang berlaku atau ketika bendera fitur dinonaktifkan; ini juga garis besar yang digunakan untuk alokasi yang ditargetkan dan pengujian terkontrol. |
Konfigurasikan Alokasi untuk mendistribusikan lalu lintas ke berbagai varian dan menerapkan pengaturan khusus untuk grup atau pengguna tertentu.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Penyebaran lalu lintas antar varian |
Default: 100%
Varian 1: 0%
Varian 2: 0% |
Tentukan persentase lalu lintas yang dialokasikan untuk setiap varian. Distribusi untuk semua varian harus berjumlah 100%. Gunakan ini untuk mengontrol bagaimana audiens diekspos ke varian yang berbeda. |
|
Pengalihan alokasi |
Penimpaan berdasarkan Grup / Penimpaan berdasarkan Pengguna |
Tetapkan varian tertentu ke grup atau pengguna individual yang dipilih terlepas dari alokasi berbasis persentase. Saat penggantian grup dan pengguna berlaku, penugasan pengguna memiliki prioritas. |
|
Distribusi (benih) |
Gunakan seed kustom: 12345 |
Secara default distribusi persentil diacak. Berikan benih tetap untuk menghasilkan alokasi deterministik (dapat diulang) di seluruh bendera fitur yang memiliki nilai seed yang sama. |
Penting
Jika evaluasi fitur terjadi di aplikasi klien (misalnya, browser web), data bendera fitur — termasuk nama pengguna yang ditentukan di sini - dapat diekspos ke pengguna akhir. Untuk informasi selengkapnya, lihat Aplikasi klien di App Configuration.
Konfigurasikan Kondisi untuk membatasi paparan, menjadwalkan perubahan, dan mengelola batasan kustom untuk melayani fitur Anda.
| Pengaturan |
Contoh nilai |
Deskripsi |
|
Batasi paparan |
Kotak dicentang |
Saat dipilih, opsi tambahan muncul untuk mengontrol paparan berdasarkan persentase, grup, dan pengguna. Jika tidak dicentang, bendera fitur berlaku secara global tanpa batasan ini. |
|
Persentase Default |
100 |
Hanya terlihat saat Paparan batas dicentang. Masukkan nilai antara 0 dan 100 untuk menentukan persentase seluruh basis pengguna yang menerima fitur secara default. |
|
Ambil alih menurut Grup |
Termasuk: MarketingTeam (100%)
Mengecualikan: TestGroup |
Hanya terlihat saat Paparan batas dicentang. Sertakan grup untuk mengaktifkan fitur tersebut meskipun berada di luar persentase default. Kecualikan grup untuk menonaktifkan fitur untuk grup tersebut. |
|
Ambil alih oleh Pengguna |
Memasukkan: john@example.com
Kecualikan: jane@example.com |
Hanya terlihat saat Paparan batas dicentang. Sertakan pengguna untuk mengaktifkan fitur bagi mereka meskipun mereka berada di luar persentase default. Nonaktifkan fitur untuk pengguna tertentu. Untuk daftar panjang pengguna, sebaiknya gunakan grup alih-alih pengguna, karena bendera fitur memiliki batas 10kb. |
|
Tambahkan jadwal |
Mulai: 2025-11-01
Akhir: 2025-11-15
Zona waktu: (UTC-06.00) Waktu Tengah (AS & Kanada)
Pengulangan: Mingguan |
Tentukan peluncuran berbasis waktu dengan menentukan waktu mulai dan berakhir. Secara opsional perbarui zona waktu yang disarankan dan aktifkan pengulangan untuk aktivasi berulang (misalnya, mingguan atau bulanan). |
|
Menambahkan kondisi kustom |
User.Region == "EU" |
Buat kondisi berdasarkan atribut kustom (misalnya, wilayah, jenis perangkat, atau tingkat langganan). Kondisi memungkinkan penargetan yang tepat sehingga hanya pengguna yang cocok dengan kriteria ini yang menerima fitur tersebut. |
|
Mengharuskan semua filter fitur diaktifkan |
Aktif (diperiksa) |
Opsi ini hanya muncul setelah Anda mengaktifkan beberapa kondisi. Saat dicentang, semua filter fitur yang diaktifkan harus dievaluasi menjadi true agar bendera fitur diterapkan (logika AND). Saat tidak dicentang, filter dievaluasi secara independen (logis ATAU). |
Konfigurasikan Telemetri untuk mengumpulkan peristiwa evaluasi untuk bendera fitur ini. Saat diaktifkan, peristiwa evaluasi dikirim ke penerbit telemetri yang Anda konfigurasikan di aplikasi Anda. Sebelum mengaktifkan telemetri, tautkan sumber daya Application Insights ke penyimpanan App Configuration di Telemetri>App Insights.
Pilih Tinjau + buat untuk melihat ringkasan bendera fitur baru Anda, lalu pilih Buat untuk menyelesaikan operasi Anda. Pemberitahuan menunjukkan bahwa bendera fitur baru berhasil dibuat.
Mengedit bendera fitur
Untuk memperbarui bendera fitur, ikuti langkah-langkah berikut:
Di menu sumber daya, bukaManajer fitur>.
Pindah ke ujung kanan bendera fitur yang ingin Anda ubah dan pilih elipsis Tindakan lainnya (...). Dari menu ini, Anda dapat melihat detail bendera fitur, mengedit bendera, mengunci, atau membuka kuncinya, membuat label, memperbarui tag, meninjau riwayat, atau menghapus bendera.
Pilih Edit untuk membuat perubahan menggunakan editor visual, atau Edit Tingkat Lanjut untuk memodifikasi JSON mentah bendera secara langsung.
Secara opsional ubah status bendera fitur dengan mengaktifkan atau menonaktifkan tombol Diaktifkan .
Kelola tampilan
Menu Pengelola fitur menampilkan bendera fitur 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 flag fitur yang dimuat setiap kali memilih Memuat lebih banyak.
Muat lebih hanya akan terlihat jika ada lebih dari 200 penanda 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 khusus .appconfig.featureflag/ dan jenis konten application/vnd.microsoft.appconfig.ff+json;charset=utf-8.
Untuk melihat nilai kunci yang mendasar dari bendera fitur di Penjelajah konfigurasi, ikuti langkah-langkah di bawah ini.
Di menu sumber daya, pilihPenjelajah Konfigurasi>, lalu pilih Kelola pengaturan tampilan>.
Pilih Sertakan bendera fitur di penjelajah konfigurasi dan Terapkan.
Konten terkait
Untuk mulai menggunakan flag fitur dengan Azure App Configuration, lanjutkan ke panduan cepat berikut yang disesuaikan untuk bahasa atau platform aplikasi Anda.