ChainedConfigurationDemo

Apa

Proyek ini menunjukkan perilaku konfigurasi rantai Microsoft untuk aplikasi host .NET generik.

Menggunakan NET 6.0 dan pembangun host generik di aplikasi konsol, dengan properti "ucapan" yang ditimpa dengan setiap rantai dalam konfigurasi.

Perilaku

Ini adalah urutan di mana setiap penyedia konfigurasi dirantai diterapkan. Yang terakhir menang.

1. Variabel Lingkungan
2. Appsettings.json
3. Appsettings. {{Dotnet_environment}}. Json
4. Argumen baris perintah
5. Launchsettings.json (jika dotnet_environment adalah "pengembangan" dan berjalan dari Visual Studio)
6. Konfigurasi Aplikasi Azure

Mengapa

Terkadang memahami konfigurasi rantai dan apa yang mengesampingkan apa yang bisa menjadi kurva belajar yang lebih besar dari yang diinginkan.

Demo ini adalah untuk membantu pemahaman Anda tentang urutan konfigurasi rantai.

Bagaimana

Instruksi

1. Klon proyek gitlab ini ke lokal Anda
2. Membawa ke Visual Studio
3. Ikuti Kasus Penggunaan, di bawah ini
4. Jelajahi Konten Hati Anda

Prasyarat

1. 1. CLI pilihan Anda (lihat lebih lanjut di bawah)
2. Langganan Azure (opsional, lihat detail di bawah)
3. Studio Visual

Konfigurasi Aplikasi Azure

Bagian konfigurasi Azure dari demo ini menggunakan Azure App Configuration Access, yang saat ini gratis untuk satu sumber daya.

Jika menggunakan bagian demo ini, Anda harus mengatur langganan dan lingkungan Azure Anda sebelum meluncurkan demo.

Saya menggunakan properti "ucapan" yang dapat dikonfigurasi, satu dengan label, satu tanpa. Jika Anda ingin menggunakan ini, atau hanya satu atau yang lain, Anda perlu menambahkannya ke konfigurasi aplikasi Azure Anda.

Yang berlabel harus mencocokkan "konfigurasi rantai" sesuai kode yang ada.

Anda juga harus membatalkan komentar bagian AddAzureAppConfiguration di Program.cs .

Baris perintah

Keakraban dengan baris perintah diperlukan. Contohnya didasarkan pada bash git untuk windows, tetapi dapat dengan mudah dipetakan untuk PowerShell atau CMD.

Menggunakan kasus

Ini mengasumsikan terminal bash. Konversi ke perintah untuk jendela Terminal/PowerShell/CMD favorit Anda.

Ini bekerja mundur dari konfigurasi aplikasi Azure, yang mengesampingkan semua pengaturan sebelumnya, ke prioritas terendah dalam rantai.

Saat berjalan dari baris perintah, bersihkan (tanpa set variabel lingkungan):

6. Azure App Config Config Trumps All

Dengan bagian AzureAppConfiguration dari Program.cs Uncommented,

 ~/source/repos/ChainedConfigurationDemo/pub  master
└─ cd ..; dotnet publish -o pub --nologo --verbosity quiet; cd pub

~/source/repos/ChainedConfigurationDemo/pub  master
└─ ./ChainedConfigurationDemo.exe Greeting=HelloFromArgs
Starting demo...

In the end, the greeting is "HelloFromAzure"

Press Ctrl-C to stop the host and exit.

5. Launchsettings.json

Dengan bagian AzureAppConfiguration dari Program.cs berkomentar, di dalam Visual Studio, jalankan aplikasi di Debug.

4. Argumen baris perintah

Dengan Azure dikomentari, dan tidak ada set dotnet_environment, tidak diluncurkan dari peluncuran Visual Studio,

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ cd ..; dotnet publish -o pub --nologo --verbosity quiet; cd pub

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ ./ChainedConfigurationDemo.exe Greeting=HelloFromArgs
Starting demo...

In the end, the greeting is "HelloFromArgs"

Press Ctrl-C to stop the host and exit.

3. AppSettings. {{Dotnet_environment}}. Json

Aplikasi ini dikonfigurasi sedemikian rupa sehingga jika dotnet_environment tidak diatur, atau diatur ke sesuatu selain "pengembangan" atau "tes", bangunan konfigurasi jatuh ke appsettings.json (jika properti ada di appsettings.json), dan sebagainya - seperti, misalnya, jika dotnet_environment diatur ke "produksi".

3a. Appsettings.development.json

• Dengan bagian azureAppConfiguration dari Program.cs berkomentar
• Tanpa argumen
• Dengan set dotnet_environment
• Dari baris perintah (launchsettings tidak digunakan)

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ cd ..; dotnet publish -o pub --nologo --verbosity quiet; cd pub

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ export DOTNET_ENVIRONMENT=Development

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ ./ChainedConfigurationDemo.exe
Starting demo...

In the end, the greeting is "HelloFromAppSettings.Development"

Press Ctrl-C to stop the host and exit.

3b. Appsettings.test.json

• Dengan bagian azureAppConfiguration dari Program.cs berkomentar
• Tanpa argumen
• Dengan set dotnet_environment
• Dari baris perintah (launchsettings tidak digunakan)

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ cd ..; dotnet publish -o pub --nologo --verbosity quiet; cd pub

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ export DOTNET_ENVIRONMENT=Test

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ ./ChainedConfigurationDemo.exe
Starting demo...

In the end, the greeting is "HelloFromAppSettings.Test"

Press Ctrl-C to stop the host and exit.

2. AppSettings.json

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ unset DOTNET_ENVIRONMENT

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ ./ChainedConfigurationDemo.exe
Starting demo...

In the end, the greeting is "HelloFromAppSettings"

Press Ctrl-C to stop the host and exit.

Dengan konfigurasi aplikasi saat ini, ini adalah hasil yang sama seperti dalam produksi.

4. Variabel lingkungan

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ export Greeting=HelloFromOperatingEnvironment

 ~/source/repos/ChainedConfigurationDemo/pub  master
 └─ ./ChainedConfigurationDemo.exe
Starting demo...

In the end, the greeting is "HelloFromOperatingEnvironment"

Press Ctrl-C to stop the host and exit.

(Pastikan untuk unset Greeting jika di lingkungan CLI untuk semua kasus lainnya)

Konfigurasi

Untuk kasing penggunaan Azure opsional, Anda perlu

1. Untuk membatalkan komentar bagian Azure di Program.cs
2. Langganan Azure Anda Sendiri
3. Properti konfigurasi aplikasi Azure yang disebut "Salam"
4. Cara bagi kotak lokal Anda untuk mengakses properti konfigurasi aplikasi Azure

Untuk #4, demo ini menggunakan string koneksi baca saja dari konfigurasi aplikasi Azure saya, ditarik sebagai variabel lingkungan dari sistem lokal saya.