Mulai cepat: Menambahkan bendera fitur ke aplikasi .NET Framework

Dalam panduan mulai cepat ini, Anda memasukkan Azure App Configuration ke dalam aplikasi web Spring Boot untuk membuat implementasi pengelolaan fitur end-to-end. Anda dapat menggunakan layanan Azure App Configuration untuk menyimpan semua tanda fitur Anda dan mengontrol statusnya secara terpusat.

Pustaka Pengelolaan Fitur .NET memperluas kerangka kerja dengan dukungan bendera fitur. Pustaka ini dibangun pada sistem konfigurasi .NET. Pustaka ini terintegrasi secara mulus dengan App Configuration melalui penyedia konfigurasi .NET.

Prasyarat

Buat penyimpanan App Configuration

  1. Untuk membuat penyimpanan App Configuration baru, masuk ke portal Azure. Di sudut kiri atas halaman beranda, pilih Buat sumber daya. Dalam kotak Cari layanan dan marketplace, masukkan App Configuration dan pilih Enter.

    Search for App Configuration

  2. Pilih App Configuration dari hasil pencarian, lalu pilih Buat.

    Select Create

  3. Pada panel Buat App Configuration, masukkan pengaturan berikut:

    Pengaturan Nilai yang disarankan Deskripsi
    Langganan Langganan Anda Pilih langganan Azure yang ingin Anda gunakan untuk menguji App Configuration. Jika akun Anda hanya memiliki satu langganan, langganan tersebut akan dipilih secara otomatis dan daftar Langganan tidak ditampilkan.
    Grup sumber daya Sumber Daya AppConfigTest Pilih atau buat grup sumber daya untuk sumber daya penyimpanan App Configuration Anda. Grup ini berguna untuk mengatur beberapa sumber daya yang mungkin ingin Anda hapus pada saat yang sama dengan menghapus grup sumber daya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan grup sumber daya untuk mengelola sumber daya Azure Anda.
    Nama sumber daya Nama harus berbeda secara global Masukkan nama sumber daya berbeda yang akan digunakan untuk sumber daya penyimpanan App Configuration. Nama harus berupa untai antara 5 dan 50 karakter dan hanya berisi angka, huruf, dan karakter -. Nama tidak boleh diawali atau diakhiri dengan karakter -.
    Lokasi US Tengah Gunakan Lokasi untuk menentukan lokasi geografis tempat penyimpanan app configuration Anda dihosting. Untuk performa terbaik, buat sumber daya di wilayah yang sama dengan komponen lain dari aplikasi Anda.
    Tingkat harga Gratis Pilih tingkat harga yang diinginkan. Untuk informasi selengkapnya, lihat halaman harga App Configuration.
  4. Pilih Tinjau + buat untuk memvalidasi pengaturan Anda.

  5. Pilih Buat. Penyebaran mungkin perlu waktu beberapa menit.

  6. Setelah penerapan selesai, buka sumber daya App Configuration. Pilih Pengaturan>Kunci akses. Catat connection string kunci utama baca-saja. Anda akan menggunakan string koneksi ini nanti untuk mengonfigurasi aplikasi Anda untuk berkomunikasi dengan App Configuration store yang Anda buat.

  1. Pilih Pengelola Fitur>+Tambahkan untuk menambahkan tanda fitur yang disebut Beta.

    Enable feature flag named Beta

    Biarkan label tidak ditentukan untuk saat ini.

Membuat aplikasi konsol .NET

  1. Mulai Visual Studio dan pilih File>Baru>Proyek.

  2. Di Buat project baru, filter pada jenis proyek konsol dan klik pada Aplikasi Konsol (.NET Framework) . Klik Berikutnya.

  3. Di Konfigurasikan proyek baru Anda, masukkan nama proyek. Dalam Kerangka Kerja, pilih .NET Framework 4.8 atau yang lebih tinggi. Klik Buat.

Sambungkan ke simpan Azure App Configuration

  1. Klik kanan proyek Anda, dan pilih Kelola Paket NuGet. Pada tab Telusuri, cari dan tambahkan paket NuGet berikut ke proyek Anda.

    Microsoft.Extensions.DependencyInjection
    Microsoft.Extensions.Configuration.AzureAppConfiguration
    Microsoft.FeatureManagement
    
  2. Buka Program.cs dan tambahkan pernyataan berikut:

    using Microsoft.Extensions.DependencyInjection;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    using Microsoft.FeatureManagement;
    using System.Threading.Tasks;
    
  3. Perbarui Main metode untuk menyambungkan ke App Configuration, menentukan opsi UseFeatureFlags sehingga bendera fitur diambil. Kemudian tampilkan pesan jika Beta bendera fitur diaktifkan.

        public static async Task Main(string[] args)
        {         
            IConfigurationRoot configuration = new ConfigurationBuilder()
                .AddAzureAppConfiguration(options =>
                {
                    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                           .UseFeatureFlags();
                }).Build();
    
            IServiceCollection services = new ServiceCollection();
    
            services.AddSingleton<IConfiguration>(configuration).AddFeatureManagement();
    
            using (ServiceProvider serviceProvider = services.BuildServiceProvider())
            {
                IFeatureManager featureManager = serviceProvider.GetRequiredService<IFeatureManager>();
    
                if (await featureManager.IsEnabledAsync("Beta"))
                {
                    Console.WriteLine("Welcome to the beta!");
                }
            }
    
            Console.WriteLine("Hello World!");
            Console.WriteLine("Press any key to continue ...");
            Console.Read();
        }
    

Membuat dan menjalankan aplikasi secara lokal

  1. Atur variabel lingkungan bernama ConnectionStringke string koneksi penyimpanan App Configuration Anda. Jika Anda menggunakan perintah Windows, jalankan perintah berikut:

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

    Jika Anda menggunakan PowerShell Windows, jalankan perintah berikut:

        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    
  2. Hidupkan ulang Visual Studio untuk mengizinkan perubahan diterapkan.

  3. Tekan Ctrl + F5 untuk membangun dan menjalankan aplikasi konsol.

    App with feature flag enabled

Membersihkan sumber daya

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

Penting

Penghapusan grup sumber daya tidak dapat dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup sumber daya 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 penyimpanan App Configuration baru dan menggunakannya dengan aplikasi konsol .NET Framework. Untuk mempelajari cara memperbarui bendera fitur secara dinamis dan nilai konfigurasi lainnya tanpa memulai ulang aplikasi, lanjutkan ke tutorial berikutnya.