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. Buat toko.
- .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:Pengaturan: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.
Membuat folder baru untuk proyek Anda.
Di folder baru, jalankan perintah berikut untuk membuat proyek aplikasi konsol .NET baru:
dotnet new console
Tersambung ke Penyimpanan App Configuration
Tambahkan referensi ke paket NuGet
Microsoft.Extensions.Configuration.AzureAppConfiguration
dengan menjalankan perintah berikut:dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
Jalankan perintah berikut untuk memulihkan paket untuk proyek Anda:
dotnet restore
Buka Program.cs, dan tambahkan pernyataan berikut:
using Microsoft.Extensions.Configuration; using Microsoft.Extensions.Configuration.AzureAppConfiguration;
Gunakan App Configuration dengan memanggil
AddAzureAppConfiguration
metode dalamProgram.cs
file.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
Set variabel lingkungan bernama ConnectionString, dan set ke kunci akses ke simpan Azure App Configuration Anda. Pada baris perintah, jalankan perintah berikut ini:
Untuk membuat dan menjalankan aplikasi secara lokal menggunakan perintah Windows, jalankan perintah berikut:
setx ConnectionString "connection-string-of-your-app-configuration-store"
Hidupkan ulang perintah untuk mengizinkan perubahan. Cetak nilai variabel lingkungan untuk memvalidasi bahwa variabel tersebut diatur dengan benar.
Jalankan perintah berikut untuk membuat aplikasi konsol:
dotnet build
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.
- Masuk ke portal Azure, lalu pilih Grup sumber daya.
- Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
- Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
- Pilih Hapus grup sumber daya.
- 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.