Rychlý start: Použití Azure App Configuration v Azure Container Apps

V tomto rychlém startu použijete Azure App Configuration v aplikaci spuštěné v Azure Container Apps. Tímto způsobem můžete centralizovat úložiště a správu konfigurace vašich aplikací v aplikacích kontejneru. Tento rychlý start využívá aplikaci ASP.NET Core vytvořenou v rychlém startu: Vytvoření aplikace ASP.NET Core pomocí App Configuration. Aplikaci kontejnerizujete a nasadíte do Azure Container Apps. Než budete pokračovat, dokončete rychlý start.

Tip

Při sledování tohoto rychlého startu můžete nejlépe zaregistrovat všechny nové prostředky v jedné skupině prostředků, abyste je mohli všechny znovu seskupit na jednom místě a později je rychleji odstranit, pokud je už nepotřebujete.

Požadavky

• Aplikace používající úložiště App Configuration. Pokud ji nemáte, vytvořte instanci pomocí rychlého startu: Vytvoření aplikace ASP.NET Core pomocí App Configuration.
• Instance Azure Container Apps. Pokud ji nemáte, vytvořte instanci pomocí Azure Portal nebo rozhraní příkazového řádku.
• Docker Desktop
• Azure CLI

---

Připojení Azure App Configuration k aplikaci kontejneru

V Azure Portal přejděte do instance aplikace kontejneru. Postupujte podle rychlého startu konektoru služby pro Azure Container Apps a vytvořte připojení služby k úložišti App Configuration pomocí níže uvedených nastavení.

• Na kartě Základy :

  • Vyberte App Configuration jako Typ služby.

  • vyberte App Configuration obchod pro "App Configuration".

    

• Na kartě Ověřování :

  • Jako Oprávnění pro připojovací řetězec vyberte Typ ověřování připojovacího řetězce a Jen pro čtení.
  • rozbalte nabídku Upřesnit . V informacích o konfiguraci by již měla být vytvořena proměnná prostředí s názvem "AZURE_APPCONFIGURATION_CONNECTIONSTRING". Upravte proměnnou prostředí tak, že vyberete ikonu na pravé straně a změníte název na ConnectionStrings__AppConfig. Tuto změnu musíme provést, protože ConnectionStrings__AppConfig je název proměnné prostředí, která bude aplikace integrovaná v ASP.NET Core rychlý start hledat. Toto je proměnná prostředí, která obsahuje připojovací řetězec pro App Configuration. Pokud jste k provedení tohoto rychlého startu použili jinou aplikaci, použijte odpovídající název proměnné prostředí. Potom vyberte Done (Hotovo).

• Pro všechno ostatní použijte výchozí hodnoty.

Po dokončení se do kontejneru vaší aplikace kontejneru přidá proměnná prostředí s názvem ConnectionStrings__AppConfig . Jeho hodnota je odkaz na tajný klíč aplikace kontejneru, připojovací řetězec vašeho úložiště App Configuration.

Sestavení kontejneru

1. Spuštěním příkazu dotnet publish sestavte aplikaci v režimu vydání a vytvořte prostředky v publikované složce.

   dotnet publish -c Release -o published
   

2. V adresáři obsahujícím soubor .csproj vytvořte soubor s názvem Dockerfile , otevřete ho v textovém editoru a zadejte následující obsah. Soubor Dockerfile je textový soubor, který nemá příponu a který se používá k vytvoření image kontejneru.

   FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
   WORKDIR /app
   COPY published/ ./
   ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
   

3. Vytvořte kontejner spuštěním následujícího příkazu.

   docker build --tag aspnetapp .
   

Vytvořit instanci služby Azure Container Registry

Vytvoření Azure Container Registry (ACR). ACR umožňuje vytvářet, ukládat a spravovat image kontejnerů.

Azure Portal

1. Pokud chcete vytvořit registr kontejneru, postupujte podle Azure Container Registry rychlého startu.
2. Po dokončení nasazení otevřete instanci ACR a v nabídce vlevo vyberte Nastavení > Přístupové klíče.
3. Poznamenejte si hodnotu Přihlašovací server uvedenou na této stránce. Tyto informace použijete v pozdějším kroku.
4. Přepněte uživatele Správa na Povoleno. Tato možnost umožňuje připojit ACR ke službě Azure Container Apps pomocí přihlašovacích údajů uživatele správce. Případně ji můžete nechat zakázanou a nakonfigurovat aplikaci kontejneru tak, aby naháněla image z registru se spravovanou identitou.

Azure CLI

1. Pomocí následujícího příkazu vytvořte instanci ACR. Vytvoří registr úrovně Basic s názvem myregistry s povoleným uživatelem pro správu, který umožňuje aplikaci kontejneru připojit se k registru pomocí přihlašovacích údajů uživatele správce. Další informace najdete v Azure Container Registry rychlém startu.

   az acr create 
   --resource-group AppConfigTestResources \
   --name myregistry \
   --admin-enabled true \
   --sku Basic
   

2. Ve výstupu příkazu si poznamenejte hodnotu přihlašovacího serveru ACR uvedenou za loginServer.

3. Načtěte uživatelské jméno a heslo ACR spuštěním příkazu az acr credential show --name myregistry. Tyto hodnoty budete potřebovat později.

Nasdílení obrázku do Azure Container Registry

Nasdílejte image Dockeru do služby ACR vytvořené dříve.

1. Spuštěním příkazu az acr login se přihlaste k registru.

   az acr login --name myregistry
   

   Příkaz vrátí Login Succeeded , jakmile je přihlášení úspěšné.

2. Pomocí značky dockeru označte odpovídající podrobnosti obrázku.

   docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
   

   Tip

   Pokud chcete zkontrolovat seznam existujících imagí a značek Dockeru, spusťte příkaz docker image ls. V tomto scénáři byste měli vidět aspoň dvě image: aspnetapp a myregistry.azurecr.io/aspnetapp.

3. Pomocí docker push nasdílejte image do registru kontejneru. Tento příklad vytvoří úložiště aspnetapp v ACR obsahující image aspnetapp . V následujícím příkladu nahraďte zástupné symboly <login-server<image-name> a <tag> hodnotou přihlašovacího serveru ACR, názvem image a značkou image.

   Metoda:

   docker push <login-server>/<image-name>:<tag>
   

   Příklad:

   docker push myregistry.azurecr.io/aspnetapp:v1
   

4. Otevřete Azure Container Registry v Azure Portal a ověřte, že v části Úložiště vidíte nové úložiště.

   

Přidání image kontejneru do Azure Container Apps

Aktualizujte aplikaci kontejneru tak, aby načetla image kontejneru z ACR.

1. V Azure Portal otevřete instanci Azure Container Apps.

2. V nabídce vlevo v části Aplikace vyberte Kontejnery.

3. Vyberte Upravit a nasadit.

4. V části Image kontejneru klikněte na název existující image kontejneru.

5. Aktualizujte následující nastavení:

   Nastavení	Navrhovaná hodnota	Popis
   Zdroj obrázku	Azure Container Registry	Jako zdroj image vyberte Azure Container Registry.
   Authentication	Správa přihlašovací údaje	Použijte možnost přihlašovacích údajů správce uživatele, která byla povolena dříve v registru kontejneru. Pokud jste nepovolili uživatele správce, ale nakonfigurovali jste používání spravované identity, museli byste do formuláře ručně zadat image a značku.
   Registr	myregistry.azurecr.io	Vyberte Azure Container Registry, kterou jste vytvořili dříve.
   Image	aspnetapp	Vyberte image Dockeru, kterou jste vytvořili a odeslali do ACR dříve.
   Značka obrázku	v1	V seznamu vyberte značku obrázku.

6. Vyberte Uložit a pak Vytvořit a nasaďte aktualizaci do aplikace Azure Container App.

Přejděte na adresu URL aplikace kontejneru Azure.

V Azure Portal v instanci Azure Container Apps přejděte na kartu Přehled a otevřete adresu URL aplikace.

Webová stránka vypadá takto:

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 zde vytvořili, abyste se vyhnuli poplatkům.

Důležité

Odstranění skupiny prostředků je nevratné. Skupina prostředků a všechny prostředky v ní se trvale odstraní. Ujistěte se, že omylem neodstraníte nesprávnou skupinu prostředků nebo prostředky. Pokud jste prostředky pro tento článek vytvořili ve skupině prostředků, která obsahuje další prostředky, které chcete zachovat, odstraňte jednotlivé prostředky z příslušného podokna místo odstranění skupiny prostředků.

1. Přihlaste se k Azure Portal a 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ů, abyste viděli přehled.
4. Vyberte Odstranit skupinu prostředků.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Zadejte název skupiny prostředků, který chcete potvrdit, a vyberte Odstranit.

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

Další kroky

V tomto rychlém startu:

• Připojené Azure App Configuration k Azure Container Apps
• Použití Dockeru k vytvoření image kontejneru z aplikace ASP.NET Core s nastavením App Configuration
• Vytvoření instance Azure Container Registry
• Nasdílení image do instance Azure Container Registry
• Přidání image kontejneru do Azure Container Apps
• Přejděte na adresu URL instance Azure Container Apps aktualizovanou o nastavení, která jste nakonfigurovali ve svém App Configuration Storu.

Spravovaná identita umožňuje jednomu prostředku Azure přístup k jinému prostředku, aniž byste museli udržovat tajné kódy. Můžete zjednodušit přístup z aplikací kontejneru k jiným prostředkům Azure. Další informace najdete v tématu o tom, jak získat přístup k App Configuration pomocí spravované identity a jak získat přístup ke službě Container Registry pomocí spravované identity.

Pokud chcete zjistit, jak nakonfigurovat webovou aplikaci ASP.NET Core tak, aby dynamicky aktualizovala nastavení konfigurace, pokračujte k dalšímu kurzu.

Povolení dynamické konfigurace