ChainedConfigurationDemo

Was

Dieses Projekt zeigt das Kettenkonfigurationsverhalten von Microsoft für .NET Generic Host Apps.

Verwendet Net 6.0 und den generischen Host Builder in einer Konsolen -App mit einer Eigenschaft "Gruß", die in der Konfiguration mit jeder Kette überschrieben wird.

Verhalten

Dies ist die Reihenfolge, in der jeder verkettete Konfigurationsanbieter angewendet wird. Der letzte gewinnt.

1. Umgebungsvariable
2. Appsettings.json
3. Appsettings. {{Dotnet_environment}}. Json
4. Befehlszeilenargument
5. LaunchStings.json (wenn dotnet_environment "Entwicklung" ist und von Visual Studio aus läuft)
6. Azure App -Konfiguration

Warum

Manchmal verstehen Sie die verkettete Konfiguration und das, was eine größere Lernkurve sein kann als gewünscht.

Diese Demo soll Ihr Verständnis der Reihenfolge der angeketteten Konfiguration unterstützen.

Wie

Anweisungen

1. Klonen Sie dieses Gitlab -Projekt vor Ihrem Einheimischen
2. Auf Visual Studio aufnehmen
3. Folgen Sie den Anwendungsfällen unten
4. Erkunden Sie den Inhalt Ihres Herzens

Voraussetzungen

1. 1. Eine CLI Ihrer Wahl (siehe mehr unten)
2. Azure -Abonnement (optional, siehe Details unten)
3. Visual Studio

Azure App Config

Der Azure -Konfigurationsteil dieser Demo verwendet den Azure App -Konfigurationszugriff, der derzeit für eine Ressource kostenlos ist.

Wenn Sie diesen Teil der Demo verwenden, müssen Sie vor dem Start der Demo Ihr Azure -Abonnement und Ihre Umgebung einrichten.

Ich habe die konfigurierbare Eigenschaft "Gruß" verwendet, eine mit einem Etikett, eines ohne. Wenn Sie diese oder nur das eine oder andere verwenden möchten, müssen Sie diese zu Ihrer Azure App -Konfiguration hinzufügen.

Das beschriftete One muss gemäß dem vorhandenen Code mit der "Kettenkonfiguration" übereinstimmen.

Sie müssen auch den Abschnitt AddAzureAppConfiguration in Program.cs überzeugen.

Befehlszeile

Vertrautheit mit einer Befehlszeile ist erforderlich. Beispiele basieren auf Git Bash für Windows, können jedoch leicht für PowerShell oder CMD abgebildet werden.

Anwendungsfälle

Diese nehmen ein Bash -Terminal an. Konvertieren Sie in Befehle für Ihr bevorzugter Terminal/PowerShell/CMD -Fenster.

Diese funktionieren rückwärts von Azure App -Konfiguration, die alle vorherigen Einstellungen überschreibt, auf die niedrigste Priorität in der Kette.

Wenn Sie aus der Befehlszeile laufen, können Sie (ohne Umgebungsvariablen festgelegt):

6. Azure App -Konfiguration übertrumpft alle

Mit dem Abschnitt AzureAppConfiguration des Program.cs unkontrolliert,

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

Mit dem Abschnitt AzureAppConfiguration of Program.cs .

4. Befehlszeilenargument

Mit Azure kommentiert und kein dotnet_environment -Set, nicht von Visual Studios Launchsettings, startet,

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

Diese App ist so konfiguriert, dass wenn die dotnet_environment nicht festgelegt ist oder auf etwas anderes als "Entwicklung" oder "Test" eingestellt ist, das Konfigurationserbau auf AppSetings.json (wenn die Eigenschaft in appsettings.json vorhanden ist) und so weiter - wie beispielsweise, wenn dotnet_environment vorhanden ist) und so weiter.

3a. Appsettings.development.json

• Mit dem Abschnitt AzureAppConfiguration des Program.cs .
• Ohne Argumente
• Mit dotnet_environment set
• Aus der Befehlszeile (Startsettings nicht verwendet)

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

• Mit dem Abschnitt AzureAppConfiguration des Program.cs .
• Ohne Argumente
• Mit dotnet_environment set
• Aus der Befehlszeile (Startsettings nicht verwendet)

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

Mit der aktuellen Konfiguration der App ist dies das gleiche Ergebnis wie in der Produktion.

4. Umgebungsvariable

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

(Stellen Sie sicher, dass Sie in der CLI -Umgebung für alle anderen Fälle unset Greeting .)

Konfiguration

Für den optionalen Azure -Anwendungsfall benötigen Sie

1. Um den Azure -Abschnitt in Program.cs zu kontrollieren
2. Ihr eigenes Azure -Abonnement
3. Eine Azure App -Konfigurationseigenschaft namens "Gruß" namens "Begrüßung"
4. Eine Möglichkeit für Ihre lokale Box, auf die Azure App -Konfigurationseigenschaft zuzugreifen

Für Nr. 4 verwendet diese Demo die schreibgeschützte Verbindungszeichenfolge aus meiner Azure App-Konfiguration, die als Umgebungsvariable aus meinem lokalen System eingerichtet ist.