Mulai cepat: Membuat aplikasi .NET dengan App Configuration

Dalam mulai cepat ini, Anda menggabungkan Azure App Configuration ke dalam aplikasi konsol .NET untuk memusatkan penyimpanan dan manajemen pengaturan aplikasi yang terpisah dari kode Anda.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun gratis.
• Penyimpanan App Configuration, seperti yang ditunjukkan dalam tutorial untuk membuat penyimpanan.
• .NET SDK 6.0 atau yang lebih baru - juga tersedia di Azure Cloud Shell.

Menambahkan nilai kunci

Tambahkan nilai kunci berikut ke penyimpanan App Configuration dan biarkan Label dan Tipe Konten dengan nilai defaultnya. Untuk informasi selengkapnya tentang cara menambahkan nilai kunci ke penyimpanan menggunakan portal Azure atau CLI, buka Membuat nilai kunci.

Tombol	Nilai
TestApp:Settings:Message	Data dari Azure App Configuration

Membuat aplikasi konsol NET

Anda dapat menggunakan antarmuka baris perintah .NET (CLI) untuk membuat proyek aplikasi konsol .NET baru. Keuntungan menggunakan .NET CLI melalui Visual Studio adalah tersedia di seluruh platform Windows, macOS, dan Linux. Atau, gunakan alat yang sudah terinstal sebelumnya yang tersedia di Azure Cloud Shell.

1. Membuat folder baru untuk proyek Anda.

2. Di folder baru, jalankan perintah berikut untuk membuat proyek aplikasi konsol .NET baru:

   dotnet new console
   

Tersambung ke Penyimpanan App Configuration

Anda dapat menyambungkan ke penyimpanan App Configuration menggunakan MICROSOFT Entra ID (disarankan), atau string koneksi.

1. Tambahkan referensi paket NuGet dengan menjalankan perintah berikut:

   ID Microsoft Entra (disarankan)

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   dotnet add package Azure.Identity
   

   String koneksi

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. Jalankan perintah berikut untuk memulihkan paket untuk proyek Anda:

   dotnet restore
   

3. Buka file Program.cs, dan tambahkan namespace berikut:

   ID Microsoft Entra (disarankan)

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

   String koneksi

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

4. Sambungkan ke penyimpanan App Configuration Anda dengan memanggil AddAzureAppConfiguration metode dalam Program.cs file.

   ID Microsoft Entra (disarankan)

   Anda menggunakan DefaultAzureCredential untuk mengautentikasi ke penyimpanan App Configuration Anda. Ikuti instruksi untuk menetapkan kredensial Anda peran Pembaca Data App Configuration. Pastikan untuk mengizinkan waktu yang memadai agar izin disebarluaskan sebelum menjalankan aplikasi Anda.

   var builder = new ConfigurationBuilder();
   builder.AddAzureAppConfiguration(options =>
   {
       string endpoint = Environment.GetEnvironmentVariable("Endpoint");
       options.Connect(new Uri(endpoint), new DefaultAzureCredential());
   });
   
   var config = builder.Build();
   Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   

   String koneksi

   var builder = new ConfigurationBuilder();
   builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
   
   var config = builder.Build();
   Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   

Membangun dan menjalankan aplikasi secara lokal

1. Atur variabel lingkungan.

   ID Microsoft Entra (disarankan)

   Atur variabel lingkungan bernama Titik Akhir ke titik akhir penyimpanan App Configuration Anda yang ditemukan di bawah Gambaran Umum penyimpanan Anda di portal Azure.

   Jika Anda menggunakan perintah Windows, jalankan perintah berikut dan hidupkan ulang perintah untuk memungkinkan perubahan berlaku:

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

   Jika Anda menggunakan PowerShell, jalankan perintah berikut:

   $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"
   

   Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut:

   export Endpoint='<endpoint-of-your-app-configuration-store>'
   

   String koneksi

   Atur variabel lingkungan bernama ConnectionString ke string koneksi baca-saja penyimpanan App Configuration Anda yang ditemukan di bawah Kunci akses penyimpanan Anda di portal Azure.

   Jika Anda menggunakan perintah Windows, jalankan perintah berikut dan hidupkan ulang perintah untuk memungkinkan perubahan berlaku:

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

   Jika Anda menggunakan PowerShell, jalankan perintah berikut:

   $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
   

   Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut:

   export ConnectionString='<connection-string-of-your-app-configuration-store>'
   

2. Jalankan perintah berikut untuk membuat aplikasi konsol:

   dotnet build
   

3. Setelah pembangunan berhasil diselesaikan, jalankan perintah berikut untuk menjalankan aplikasi secara lokal:

   dotnet run
   

   

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 penyimpanan App Configuration baru dan menggunakannya dengan aplikasi konsol .NET melalui penyedia App Configuration. Untuk mempelajari cara mengonfigurasi aplikasi .NET Anda untuk menyegarkan pengaturan konfigurasi secara dinamis, lanjutkan ke tutorial berikutnya.

Mengaktifkan konfigurasi dinamis