Rychlý Start: Vytvoření aplikace .NET Core s konfigurací aplikace

V tomto rychlém startu zařadíte konfiguraci aplikací Azure do konzolové aplikace .NET Core, která umožňuje centralizaci úložiště a správy nastavení aplikace odděleně od vašeho kódu.

Požadavky

• Předplatné Azure – Vytvořte si ho zdarma .
• .NET Core SDK – k dispozici také Azure Cloud Shell.

Vytvoření úložiště konfigurace aplikace

1. Pokud chcete vytvořit nové úložiště konfigurace aplikace, přihlaste se k Azure Portal. V levém horním rohu domovské stránky vyberte vytvořit prostředek. Do pole Hledat na Marketplace zadejte Konfigurace aplikace a vyberte ENTER.

   

2. Ve výsledcích hledání vyberte Konfigurace aplikace a pak vyberte vytvořit.

   

3. V podokně vytvořit konfiguraci aplikace zadejte následující nastavení:

   Nastavení	Navrhovaná hodnota	Popis
   Předplatné	Vaše předplatné	Vyberte předplatné Azure, které chcete použít k testování konfigurace aplikace. Pokud má váš účet jenom jedno předplatné, vybere se automaticky a seznam předplatných se nezobrazí.
   Skupina prostředků	AppConfigTestResources	Vyberte nebo vytvořte skupinu prostředků pro prostředek úložiště konfigurace aplikace. Tato skupina je užitečná k organizování více prostředků, které můžete chtít odstranit současně odstraněním skupiny prostředků. Další informace najdete v tématu použití skupin prostředků ke správě prostředků Azure.
   Název prostředku	Globálně jedinečný název	Zadejte jedinečný název prostředku, který se má použít pro prostředek úložiště konfigurace aplikace. Název musí být řetězec o 5 až 50 znaků a obsahovat pouze čísla, písmena a - znak. Název nesmí začínat ani končit - znakem.
   Umístění	USA – střed	Umístění použijte k určení geografického umístění, ve kterém je úložiště konfigurace aplikace hostované. Nejlepšího výkonu dosáhnete vytvořením prostředku ve stejné oblasti jako jiné součásti aplikace.
   Cenová úroveň	Free	Vyberte požadovanou cenovou úroveň. Další informace najdete na stránce s cenami konfigurace aplikací.

4. Vyberte zkontrolovat + vytvořit a ověřte nastavení.

5. Vyberte Vytvořit. Nasazení může trvat několik minut.

6. Po dokončení nasazení přejděte do prostředku konfigurace aplikace. Vyberte Nastavení > Přístupové klíče. Poznamenejte si primární připojovací řetězec klíče jen pro čtení. Pomocí tohoto připojovacího řetězce později nakonfigurujete aplikaci tak, aby komunikovala s úložištěm konfigurace aplikace, které jste vytvořili.

7. Vyberte možnost Průzkumník konfigurace > vytvořit > klíč-hodnota a přidejte následující páry klíč-hodnota:

   Klíč	Hodnota
   TestApp: Nastavení: zpráva	Data z konfigurace aplikace Azure

   V tuto chvíli ponechat popisek a typ obsahu prázdné.

8. Vyberte Použít.

Vytvoření konzolové aplikace .NET Core

K vytvoření nového projektu konzolové aplikace .NET Core použijete rozhraní příkazového řádku .NET Core (CLI) . výhodou použití .NET Core CLI přes Visual Studio je to, že je k dispozici na platformách Windows, macOS a Linux. Případně můžete použít předinstalované nástroje, které jsou k dispozici v Azure Cloud Shell.

1. Vytvořte novou složku pro váš projekt.

2. V nové složce spusťte následující příkaz, který vytvoří nový projekt konzolové aplikace .NET Core:

   dotnet new console
   

Připojení do úložiště konfigurace aplikace

1. přidejte odkaz na Microsoft.Extensions.Configuration.AzureAppConfiguration balíček NuGet spuštěním následujícího příkazu:

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. Spusťte následující příkaz pro obnovení balíčků pro váš projekt:

   dotnet restore
   

3. Otevřete program. cs a přidejte odkaz na poskytovatele konfigurace aplikace .NET Core.

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

4. Aktualizujte Main metodu pro použití konfigurace aplikace voláním builder.AddAzureAppConfiguration() metody.

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

Místní sestavení a spuštění aplikace

1. Nastavte proměnnou prostředí s názvem ConnectionString a nastavte ji na přístupový klíč na úložiště konfigurace aplikace. Na příkazovém řádku spusťte následující příkaz:

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

   pokud používáte Windows PowerShell, spusťte následující příkaz:

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

   Pokud používáte macOS nebo Linux, spusťte následující příkaz:

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

   Restartováním příkazového řádku umožníte, aby se změna projevila. Vytiskněte hodnotu proměnné prostředí, abyste ověřili, jestli je správně nastavená.

2. Spusťte následující příkaz, který sestaví konzolovou aplikaci:

   dotnet build
   

3. Po úspěšném dokončení sestavení spusťte následující příkaz pro místní spuštění aplikace:

   dotnet run
   

Vyčištění prostředků

Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste předešli poplatkům.

1. Přihlaste se k Azure Portala vyberte skupiny prostředků.
2. Do pole filtrovat podle názvu zadejte název vaší skupiny prostředků.
3. V seznamu výsledků vyberte název skupiny prostředků, aby se zobrazil přehled.
4. Vyberte Odstranit skupinu prostředků.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Zadejte název vaší skupiny prostředků, který chcete potvrdit, a vyberte Odstranit.

Po chvíli se odstraní skupina prostředků a všechny její prostředky.

Další kroky

V tomto rychlém startu jste vytvořili nové úložiště konfigurace aplikace a použili ho s konzolovou aplikací .NET Core přes poskytovatele konfigurace aplikace. Pokud se chcete dozvědět, jak nakonfigurovat aplikaci .NET Core tak, aby dynamicky aktualizovala nastavení konfigurace, přejděte k dalšímu kurzu.