ChainedConfigurationDemo

ماذا

يوضح هذا المشروع سلوك تكوين Microsoft بالسلاسل لتطبيقات المضيف العام .NET.

يستخدم Net 6.0 وباني مضيف عام في تطبيق وحدة التحكم ، مع خاصية "تحية" يتم تجاوزها مع كل سلسلة في التكوين.

سلوك

هذا هو الترتيب الذي يتم به تطبيق كل مزود تكوين بالسلاسل. آخر واحد يفوز.

1. متغير البيئة
2. appsettings.json
3. appsettings. {{dotnet_environment}}. JSON
4. حجة سطر القيادة
5. launchsettings.json (إذا كان dotnet_environment هو "التطوير" والركض من Visual Studio)
6. تكوين تطبيق Azure

لماذا

في بعض الأحيان فهم التكوين بالسلاسل وما الذي يتجاوز ما يمكن أن يكون منحنى تعليمي أكبر مما هو مطلوب.

هذا العرض التوضيحي هو المساعدة في فهمك لترتيب التكوين بالسلاسل.

كيف

تعليمات

1. استنساخ مشروع gitlab هذا للمحلي الخاص بك
2. إحضار إلى Visual Studio
3. اتبع حالات الاستخدام أدناه
4. استكشف محتوى قلبك

المتطلبات الأساسية

1. 1. cli من اختيارك (انظر المزيد أدناه)
2. اشتراك Azure (اختياري ، انظر التفاصيل أدناه)
3. الاستوديو البصري

Azure App Config

يستخدم جزء تكوين Azure من هذا العرض التوضيحي الوصول إلى تكوين تطبيق Azure ، وهو مجاني حاليًا لمورد واحد.

إذا كنت تستخدم هذا الجزء من العرض التوضيحي ، فيجب عليك إعداد اشتراك Azure والبيئة قبل إطلاق العرض التوضيحي.

لقد استخدمت خاصية "تحية" قابلة للتكوين ، واحدة مع ملصق ، واحد بدون. إذا كنت ترغب في استخدام هذه ، أو واحدة فقط أو أخرى ، فستحتاج إلى إضافتها إلى تكوين تطبيق Azure الخاص بك.

يجب على الشخص المسمى مطابقة "التكوين بالسلاسل" لكل الرمز الحالي.

يجب أيضًا إلغاء تحديد قسم AddAzureAppConfiguration في Program.cs .

سطر القيادة

مطلوب الألفة مع سطر الأوامر. تعتمد الأمثلة على git bash للنوافذ ، ولكن يمكن تعيينها بسهولة من أجل PowerShell أو CMD.

استخدام الحالات

هذه تفترض محطة باش. قم بتحويل أوامر لنافذة Terminal/PowerShell/CMD المفضلة لديك.

هذه تعمل للخلف من تكوين تطبيق Azure ، الذي يتجاوز جميع الإعدادات السابقة ، إلى أدنى أولوية في السلسلة.

عند الركض من سطر الأوامر ، تنظيف (مع عدم وجود متغيرات البيئة):

6. Azure App Config يتفوق على الجميع

مع قسم AzureAppConfiguration في Program.cs .

 ~/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. Launchstings.json

مع قسم AzureAppConfiguration في Program.cs .

4. حجة سطر القيادة

مع علق Azure ، ولم يتم تشغيل أي مجموعة dotnet_environment ، وليس إطلاقها من عمليات إطلاق 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

تم تكوين هذا التطبيق بحيث إذا لم يتم تعيين DOTNET_ENVIRENMENT ، أو تم تعيينه على شيء آخر غير "التطوير" أو "الاختبار" ، فإن بناء التكوين ينخفض ​​إلى تطبيقات التطبيق

3A. appsettings.development.json

• مع قسم AzureAppConfiguration في Program.cs علق
• بدون حجج
• مع مجموعة dotnet_environment
• من سطر الأوامر (لا تستخدم عمليات الإطلاق)

 ~/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.

3 ب. appsettings.test.json

• مع قسم AzureAppConfiguration في Program.cs علق
• بدون حجج
• مع مجموعة dotnet_environment
• من سطر الأوامر (لا تستخدم عمليات الإطلاق)

 ~/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.

مع التكوين الحالي للتطبيق ، هذه هي نفس النتيجة في الإنتاج.

4. متغير البيئة

 ~/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.

(تأكد من unset Greeting إذا كان في بيئة CLI لجميع الحالات الأخرى)

إعدادات

لحالة استخدام Azure الاختيارية ، ستحتاج

1. لتوضيح قسم Azure في البرنامج.
2. اشتراك Azure الخاص بك
3. خاصية تكوين تطبيق Azure تسمى "تحية"
4. طريقة لمربعك المحلي للوصول إلى خاصية تكوين تطبيق Azure

بالنسبة إلى #4 ، يستخدم هذا العرض التوضيحي سلسلة الاتصال للقراءة فقط من تكوين تطبيق Azure الخاص بي ، والتي يتم سحبها كمتغير بيئة من نظامي المحلي.