Mulai cepat: Menambahkan bendera fitur ke aplikasi konsol .NET/.NET Framework

Dalam panduan cepat ini, Anda menerapkan Azure App Configuration ke dalam aplikasi konsol berbasis .NET atau .NET Framework untuk membuat implementasi dari manajemen fitur secara menyeluruh. Anda dapat menggunakan App Configuration untuk menyimpan semua bendera fitur Anda secara terpusat dan mengontrol statusnya.

Pustaka manajemen fitur .NET memperluas .NET dengan menyediakan dukungan bendera fitur. Pustaka ini dibangun pada sistem konfigurasi .NET. Pustaka ini terintegrasi secara mulus dengan App Configuration melalui penyedia konfigurasi .NET.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun gratis.
• Penyimpanan App Configuration, seperti yang ditunjukkan dalam panduan cepat untuk membuat penyimpanan.
• Visual Studio.
• .NET SDK 8.0 atau yang lebih baru untuk aplikasi konsol .NET.
• .NET Framework 4.7.2 atau yang lebih baru untuk aplikasi konsol .NET Framework.

Menambahkan bendera fitur

Tambahkan bendera fitur yang disebut Beta ke penyimpanan App Configuration dan biarkan Label dan Deskripsi dengan nilai defaultnya. Untuk informasi selengkapnya tentang cara menambahkan bendera fitur ke penyimpanan dengan menggunakan portal Microsoft Azure atau Azure CLI, lihat Membuat bendera fitur.

Mengonfigurasi pengaturan akses

Aplikasi yang Anda buat dalam panduan memulai cepat ini terhubung ke penyimpanan App Configuration Anda untuk mengakses pengaturan flag fitur Anda. Untuk menyambungkan ke App Configuration, aplikasi Anda dapat menggunakan ID Microsoft Entra atau string koneksi. MICROSOFT Entra ID adalah pendekatan yang direkomendasikan.

ID Microsoft Entra (disarankan)

Menetapkan peran konfigurasi data aplikasi

Secara default, aplikasi yang Anda buat menggunakan DefaultAzureCredential untuk mengautentikasi ke App Configuration store Anda. DefaultAzureCredential adalah rantai kredensial token. Agar otorisasi berfungsi, Anda perlu memberikan peran Pembaca Konfigurasi Aplikasi ke kredensial yang digunakan oleh aplikasi Anda. Untuk petunjuknya, lihat Autentikasi dengan kredensial token. Izinkan waktu yang memadai untuk penugasan peran menyebar sebelum menjalankan aplikasi Anda.

Mengatur variabel lingkungan

Aplikasi Anda menggunakan variabel lingkungan untuk membuat koneksi ke App Configuration. Gunakan salah satu perintah berikut untuk mengatur variabel lingkungan bernama Endpoint ke titik akhir penyimpanan App Configuration Anda.

• Jika Anda menggunakan Command Line, jalankan perintah berikut:

  setx Endpoint "<endpoint-of-your-app-configuration-store>"
  

  Tutup dan buka kembali Prompt Perintah sehingga perubahan berlaku. Verifikasi bahwa variabel lingkungan diatur dengan mencetak nilainya ke konsol.

• Jika Anda menggunakan Windows PowerShell, jalankan perintah berikut:

  [System.Environment]::SetEnvironmentVariable("Endpoint", "<endpoint-of-your-app-configuration-store>", "User")
  

String koneksi

Aplikasi Anda menggunakan variabel lingkungan untuk membuat koneksi ke App Configuration. Gunakan salah satu perintah berikut untuk mengatur variabel lingkungan bernama ConnectionString ke string koneksi penyimpanan App Configuration Anda.

• Jika Anda menggunakan Command Line, jalankan perintah berikut:

  setx ConnectionString "<connection-string-of-your-app-configuration-store>"
  

  Tutup dan buka kembali Prompt Perintah sehingga perubahan berlaku. Verifikasi bahwa variabel lingkungan diatur dengan mencetak nilainya ke konsol.

• Jika Anda menggunakan Windows PowerShell, jalankan perintah berikut:

  [System.Environment]::SetEnvironmentVariable("ConnectionString", "<connection-string-of-your-app-configuration-store>", "User")
  

Membuat aplikasi konsol

Untuk menggunakan Visual Studio untuk membuat proyek aplikasi konsol baru, lakukan langkah-langkah berikut.

1. Buka Visual Studio. Jika sudah berjalan, tutup dan buka kembali sehingga mengenali variabel lingkungan yang Anda tetapkan di bagian sebelumnya.

2. Di Visual Studio, pilih File>Proyek>.

3. Dalam dialog Buat proyek baru , masukkan Konsol ke dalam kotak pencarian.

   • Jika Anda ingin membuat aplikasi .NET, pilih Aplikasi Konsol, lalu pilih Berikutnya.
   • Jika Anda ingin membuat aplikasi .NET Framework, pilih Aplikasi Konsol (.NET Framework), lalu pilih Berikutnya.

4. Dalam dialog Konfigurasikan proyek baru Anda , masukkan nama proyek.

   • Jika Anda ingin membuat aplikasi .NET, pilih Berikutnya untuk membuka dialog Informasi tambahan . Dalam dialog tersebut, pilih kerangka kerja .NET, kosongkan kotak centang Jangan gunakan pernyataan tingkat atas , lalu pilih Buat.
   • Jika Anda ingin membuat aplikasi .NET Framework, pilih .NET Framework 4.7.2 atau versi yang lebih baru di bawah Kerangka Kerja, lalu pilih Buat.

Menggunakan bendera fitur

Untuk menggunakan bendera fitur di aplikasi Anda, lakukan langkah-langkah berikut.

1. Di Penjelajah Solusi, klik kanan proyek Anda, lalu pilih Kelola Paket NuGet.

2. Pada tab Telusuri , cari dan tambahkan versi stabil terbaru dari paket NuGet berikut ke proyek Anda:

   ID Microsoft Entra (disarankan)

   • Microsoft.Extensions.Configuration.AzureAppConfiguration
   • Microsoft.FeatureManagement
   • Azure.Identity

   String koneksi

   • Microsoft.Extensions.Configuration.AzureAppConfiguration
   • Microsoft.FeatureManagement

3. Buka Program.cs dan tambahkan pernyataan berikut ke awal file.

   ID Microsoft Entra (disarankan)

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   using Microsoft.FeatureManagement;
   using Azure.Identity;
   

   String koneksi

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   using Microsoft.FeatureManagement;
   

4. Seperti yang ditunjukkan pada blok kode berikut, perbarui Program.cs dengan membuat tiga perubahan:

   • Untuk memuat feature flag dari App Configuration, tambahkan panggilan ke metode UseFeatureFlags.
   • Untuk membaca bendera fitur dari konfigurasi, buat instans FeatureManager.
   • Tampilkan pesan jika bendera fitur Beta diaktifkan.
   ID Microsoft Entra (disarankan)

   .NET

   IConfiguration configuration = new ConfigurationBuilder()
       .AddAzureAppConfiguration(options =>
       {
           string endpoint = Environment.GetEnvironmentVariable("Endpoint");
           options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                  .UseFeatureFlags();
       }).Build();
   
   var featureManager = new FeatureManager(
       new ConfigurationFeatureDefinitionProvider(configuration));
   
   if (await featureManager.IsEnabledAsync("Beta"))
   {
       Console.WriteLine("Welcome to the beta!");
   }
   
   Console.WriteLine("Hello World!");
   

   .NET Framework

   public static async Task Main(string[] args)
   {         
       IConfiguration configuration = new ConfigurationBuilder()
           .AddAzureAppConfiguration(options =>
           {
               string endpoint = Environment.GetEnvironmentVariable("Endpoint");
               options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                      .UseFeatureFlags();
           }).Build();
   
       var featureManager = new FeatureManager(
           new ConfigurationFeatureDefinitionProvider(configuration));
   
       if (await featureManager.IsEnabledAsync("Beta"))
       {
           Console.WriteLine("Welcome to the beta!");
       }
   
       Console.WriteLine("Hello World!");
   }
   

   String koneksi

   .NET

   IConfiguration configuration = new ConfigurationBuilder()
       .AddAzureAppConfiguration(options =>
       {
           options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                  .UseFeatureFlags();
       }).Build();
   
   var featureManager = new FeatureManager(
       new ConfigurationFeatureDefinitionProvider(configuration));
   
   if (await featureManager.IsEnabledAsync("Beta"))
   {
       Console.WriteLine("Welcome to the beta!");
   }
   
   Console.WriteLine("Hello World!");
   

   .NET Framework

   public static async Task Main(string[] args)
   {         
       IConfiguration configuration = new ConfigurationBuilder()
           .AddAzureAppConfiguration(options =>
           {
               options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                      .UseFeatureFlags();
           }).Build();
   
       var featureManager = new FeatureManager(
           new ConfigurationFeatureDefinitionProvider(configuration));
   
       if (await featureManager.IsEnabledAsync("Beta"))
       {
           Console.WriteLine("Welcome to the beta!");
       }
   
       Console.WriteLine("Hello World!");
   }
   

Membangun dan menjalankan aplikasi secara lokal

1. Di Visual Studio, pilih Ctrl+F5 untuk membuat dan menjalankan aplikasi. Output berikut akan muncul di konsol.

   

2. Masuk ke portal Azure. Pilih Semua sumber daya, lalu pilih toko konfigurasi aplikasi Anda.

3. Pilih Pengelola fitur dan temukan bendera fitur Beta . Aktifkan tombol Diaktifkan untuk mengaktifkan bendera.

4. Menjalankan aplikasi lagi. Pesan Beta akan muncul di konsol.

   

Membersihkan sumber daya

Jika Anda tidak ingin terus menggunakan sumber daya yang dibuat dalam artikel ini, hapus grup sumber daya yang Anda buat di sini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak bisa dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat sumber daya untuk artikel ini dalam grup sumber daya yang ada yang berisi sumber daya lain yang ingin disimpan, hapus setiap sumber daya satu per satu dari panelnya masing-masing, bukan menghapus grup sumber daya.

1. Masuk ke portal Azure, lalu pilih Grup sumber daya.
2. Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
3. Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
4. Pilih Hapus grup sumber daya.
5. Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Masukkan nama grup sumber daya Anda untuk mengonfirmasi, dan pilih Hapus.

Setelah beberapa saat, grup sumber daya dan semua sumber dayanya akan dihapus.

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat bendera fitur di App Configuration dan menggunakannya dengan aplikasi konsol. Untuk mengetahui cara memperbarui bendera fitur dan nilai konfigurasi lainnya secara dinamis tanpa memulai ulang aplikasi, lihat tutorial berikut:

Menggunakan konfigurasi dinamis dalam aplikasi .NET

Menggunakan konfigurasi dinamis dalam aplikasi .NET Framework

Untuk mengaktifkan kemampuan manajemen fitur untuk jenis aplikasi lain, silakan lihat panduan memulai berikut.

Menambahkan bendera fitur ke aplikasi ASP.NET Core

Menambahkan bendera fitur ke layanan latar belakang .NET

Untuk ringkasan lengkap fitur pustaka manajemen fitur .NET, lihat dokumen berikut.

Manajemen fitur .NET