Rychlý start: Vytvoření Azure Functions aplikace pomocí Azure App Configuration

V tomto rychlém startu začleníte službu Azure App Configuration do aplikace Azure Functions, abyste centralizovali úložiště a správu všech nastavení aplikace odděleně od kódu.

Požadavky

• Předplatné Azure – vytvořte si ho zdarma.
• Visual Studio 2019 s úlohou Vývoj pro Azure.
• Azure Functions nástroje

Vytvoření App Configuration úložiště

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 Průzkumník konfigurace+ > Vytvořit > klíč-hodnota a přidejte následující páry klíč-hodnota:

   Klíč	Hodnota
   TestApp:Nastavení:Message	Data z Azure App Configuration

   Pole Label (Popisek) a Content Type (Typ obsahu) nechte v seznamu prázdné.

8. Vyberte Použít.

Vytvoření aplikace Functions

šablona projektu Azure Functions v Visual Studio vytvoří projekt knihovny tříd C#, který můžete publikovat do aplikace function app v Azure. Pomocí aplikace Function App můžete seskupit funkce jako logickou jednotku pro snadnější správu, nasazování, škálování a sdílení prostředků.

1. v nabídce Visual Studio vyberte soubor > nový > Project.

2. V části vytvořit nový projekt zadejte do vyhledávacího pole funkce , vyberte šablonu Azure Functions a pak vyberte Další.

3. v konfiguraci nového projektu zadejte Project název projektu a pak vyberte vytvořit. Název aplikace funkcí musí být platný jako obor názvů C#, takže nepoužívejte podtržítka, pomlčky nebo jiné nealfanumerické znaky.

4. V poli vytvořit nové nastavení aplikace Azure Functions použijte hodnoty v následující tabulce:

   • V procesu
   • Izolovaný proces

   Nastavení	Hodnota	Popis
   Verze .NET	.NET Core 3 (LTS)	Tato hodnota vytvoří projekt funkce, který běží v procesu se spuštěnou verzí 3. x Azure Functions runtime. Azure Functions 1.x podporuje rozhraní .NET Framework. Další informace najdete v tématu Přehled verzí modulu runtime Azure Functions.
   Šablona funkce	Trigger HTTP	Tato hodnota vytvoří funkci spuštěnou požadavkem HTTP.
   účet Storage (AzureWebJobsStorage)	emulátor Storage	Vzhledem k tomu, že aplikace Function App v Azure vyžaduje účet úložiště, je při publikování projektu do Azure přiřazená nebo vytvořená jedna z nich. aktivační událost protokolu HTTP nepoužívá připojovací řetězec Azure Storage účtu; všechny ostatní typy triggerů vyžadují platný připojovací řetězec účtu Azure Storage.
   Úroveň autorizace	Anonymous	Vytvořenou funkci může aktivovat libovolný klient bez zadání klíče. Toto nastavení autorizace usnadňuje testování nových funkcí. Další informace o klíčích a autorizaci najdete v tématu autorizační klíče a vazby HTTP a Webhooku.

   

   Ujistěte se, že jste nastavili úroveň autorizace na anonymní. Pokud zvolíte výchozí úroveň funkce, budete muset při žádosti o přístup ke koncovému bodu funkce prezentovat klíč funkce .

5. Vyberte vytvořit a vytvořte tak projekt funkce a funkci triggeru http.

Připojení do App Configuration úložiště

Tento projekt použije injektáž závislostí v .NET Azure Functions a přidá Azure App Configuration jako další zdroj konfigurace.

1. Klikněte pravým tlačítkem na projekt a vyberte Spravovat NuGet balíčky. Na kartě Procházet vyhledejte a přidejte následující balíčky NuGet do projektu.

   • Microsoft.Extensions.Configuration.AzureAppConfiguration verze 4.1.0 nebo novější
   • Microsoft.Azure.Functions.Extensions verze 1.1.0 nebo novější

2. Přidejte nový soubor Startup.cs s následujícím kódem. Definuje třídu s názvem Startup , která implementuje abstraktní FunctionsStartup třídu. Atribut sestavení slouží k určení názvu typu použitého při Azure Functions spuštění.

   Metoda se přepíše a Azure App Configuration se přidá jako ConfigureAppConfiguration další zdroj konfigurace voláním AddAzureAppConfiguration() . Metoda je prázdná, protože v tuto chvíli nemusíte registrovat Configure žádné služby.

   using System;
   using Microsoft.Azure.Functions.Extensions.DependencyInjection;
   using Microsoft.Extensions.Configuration;
   
   [assembly: FunctionsStartup(typeof(FunctionApp.Startup))]
   
   namespace FunctionApp
   {
       class Startup : FunctionsStartup
       {
           public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
           {
               string cs = Environment.GetEnvironmentVariable("ConnectionString");
               builder.ConfigurationBuilder.AddAzureAppConfiguration(cs);
           }
   
           public override void Configure(IFunctionsHostBuilder builder)
           {
           }
       }
   }
   

3. Otevřete soubor Function1.cs a přidejte následující obor názvů.

   using Microsoft.Extensions.Configuration;
   

   Přidejte konstruktor použitý k získání instance prostřednictvím IConfiguration injektáže závislostí.

   private readonly IConfiguration _configuration;
   
   public Function1(IConfiguration configuration)
   {
       _configuration = configuration;
   }
   

4. Aktualizujte Run metodu tak, aby načítá hodnoty z konfigurace.

   public async Task<IActionResult> Run(
       [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, ILogger log)
   {
       log.LogInformation("C# HTTP trigger function processed a request.");
   
       string keyName = "TestApp:Settings:Message";
       string message = _configuration[keyName];
   
       return message != null
           ? (ActionResult)new OkObjectResult(message)
           : new BadRequestObjectResult($"Please create a key-value with the key '{keyName}' in App Configuration.");
   }
   

   Poznámka

   Třída Function1 a metoda by neměly být Run statické. Pokud byl static modifikátor automaticky vygenerován, odeberte ho.

Místní testování funkce

1. Nastavte proměnnou prostředí s názvem ConnectionString a nastavte ji na přístupový klíč k vašemu App Configuration úložiště. Pokud použijete Windows příkazového řádku, spusťte následující příkaz a restartujte příkazový řádek, aby se změna mohla projeví:

       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'
   

2. Stisknutím klávesy F5 funkci otestujte. Pokud se zobrazí výzva, přijměte požadavek od Visual Studio stáhnout a nainstalovat Azure Functions Core (CLI). Možná budete také muset povolit výjimku brány firewall, aby nástroje mohly zpracovávat požadavky HTTP.

3. Zkopírujte adresu URL vaší funkce z výstupu modulu runtime služby Azure Functions.

   

4. Vložte adresu URL pro požadavek HTTP do panelu adresy prohlížeče. Následující obrázek ukazuje odpověď v prohlížeči na místní požadavek GET vrácený funkcí .

   

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ý App Configuration Store a použili ho s Azure Functions přes poskytovatele App Configuration . Informace o tom, jak aktualizovat Azure Functions aplikaci tak, aby dynamicky obnovuje konfiguraci, najdete v dalším kurzu.