Rychlý start: Použití konfigurace Aplikace Azure v Azure Container Apps

V tomto rychlém průvodci 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 aplikací v Container Apps. V tomto rychlém startu se využívá aplikace ASP.NET Core vytvořená v rychlém startu: Vytvoření aplikace ASP.NET Core pomocí služby App Configuration. Aplikaci kontejnerizujete a nasadíte ji do Azure Container Apps. Než budete pokračovat, dokončete rychlý start.

Návod

I když budete pokračovat v tomto rychlém startu, nejlépe zaregistrujte všechny nové prostředky v rámci jedné skupiny prostředků, abyste je mohli znovu seskupit na jednom místě a později je odstranit rychleji, pokud je už nepotřebujete.

Důležité

Podpora pro Service Connector (Preview) v Azure Container Apps končí 30. března 2026. Po tomto datu nejsou nová připojení služeb pomocí konektoru Service Connector (Preview) dostupná prostřednictvím žádného rozhraní. Další informace najdete v tématu UKONČENÍ: Service Connector (Preview) v Azure Container Apps.

Požadavky

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

---

Připojení konfigurace Aplikace Azure k aplikaci kontejneru

1. Na webu Azure Portal přejděte do instance kontejnerové aplikace.

2. Řiďte se příručkou pro rychlé spuštění konektoru služeb pro Azure Container Apps a vytvořte připojení služby pro váš App Configuration Store použitím následujícího nastavení.

   1. V záložce Základy:

      • V části Typ služby vyberte App Configuration (Konfigurace aplikace).

      • V části Konfigurace aplikace vyberte obchod App Configuration Store.

        

   2. Na kartě Ověřování :

      • Vyberte typ ověřování spravované identity přiřazené systémem.
      • Rozbalte nabídku Pokročilé
      • Přiřaďte vaší identitě roli App Configuration Data Reader
      • V části Informace o konfiguraci najdete proměnnou prostředí s názvem AZURE_APPCONFIGURATION_ENDPOINT. Vyberte ikonu tužky na pravé straně a upravte název proměnné prostředí tak, aby odpovídal názvu proměnné ve vaší aplikaci, ze které načtete koncový bod konfigurace aplikace. Pokud jste aplikaci vytvořili podle rychlého startu pro ASP.NET Core, název proměnné je Endpoints:AppConfiguration. Při úpravě názvu proměnné nahraďte dvojtečku dvojitým podtržítkem, aby se stala Endpoints__AppConfiguration. Pokud pracujete s jinou aplikací, zadejte odpovídající název proměnné prostředí a pak vyberte Hotovo.

   3. Použijte výchozí hodnoty pro všechno ostatní.

   Po vytvoření připojení se do kontejneru vašeho prostředku Container App přidá proměnná prostředí s názvem Endpoints__AppConfiguration . Jeho hodnota je odkazem na tajný klíč kontejnerových aplikací, koncový bod vašeho úložiště konfigurace aplikací.

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, který obsahuje váš 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 slouží k vytvoření image kontejneru.

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

3. Sestavte 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í služby Azure Container Registry (ACR). ACR umožňuje vytvářet, ukládat a spravovat image kontejnerů.

Portal

1. Pokud chcete vytvořit registr kontejneru, postupujte podle rychlého startu služby Azure Container Registry.
2. Po dokončení nasazení otevřete instanci ACR a v nabídce vlevo vyberte > nastavení.
3. Poznamenejte si hodnotu přihlašovacího serveru uvedenou na této stránce. Tyto informace použijete v pozdějším kroku.
4. Přepněte administrátora 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. Alternativně ji můžete ponechat zakázanou a nakonfigurovat aplikaci kontejneru tak, aby načítá 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 správce, který aplikaci kontejneru umožňuje připojit se k registru pomocí přihlašovacích údajů uživatele správce. Další informace najdete v rychlém startu služby Azure Container Registry.

   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 az acr credential show --name myregistry. Tyto hodnoty budete potřebovat později.

Přeneste image do služby Azure Container Registry

Nahrajte 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 po úspěšném přihlášení.

2. Pomocí docker tag označte obraz odpovídajícím způsobem.

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

   Návod

   Pokud chcete zkontrolovat seznam existujících imagí a značek Dockeru, spusťte docker image lspříkaz . V tomto scénáři byste měli vidět alespoň dva obrázky: 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 na webu Azure Portal a ověřte, že v části Úložiště uvidíte nové úložiště.

   

Přidejte svůj obraz kontejneru do Azure Container Apps

Aktualizujte svou kontejnerovou aplikaci, aby načetla obraz kontejneru z Azure Container Registry (ACR).

1. Na webu 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í:

   Setting	Navrhovaná hodnota	Description
   Zdroj obrázku	Azure Container Registry	Jako zdroj image vyberte Azure Container Registry.
   Autentizace	Přihlašovací údaje správce	Použijte možnost přihlašovacích údajů uživatele správce, která byla povolena dříve v registru kontejneru. Pokud jste nepovolili uživatele správce, ale nakonfigurovali jste pro použití spravované identity, budete muset obrázek a značku ve formuláři zadat ručně.
   Registry	myregistry.azurecr.io	Vyberte službu Azure Container Registry, kterou jste vytvořili dříve.
   Obrázek	aspnetapp	Vyberte image Dockeru, kterou jste vytvořili, a vložte ji do služby ACR dříve.
   Značka obrázku	v1	Vyberte tag obrázku ze seznamu.

6. Vyberte Uložit a pak vytvořte , aby se aktualizace nasadí do aplikace Azure Container App.

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

Na webu 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čistěte zdroje

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 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í. Dávejte pozor, abyste omylem neodstranili nesprávnou skupinu prostředků nebo jednotlivé prostředky. Pokud jste vytvořili prostředky pro tento článek 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 webu 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 zobrazili přehled.
4. Vyberte odstranit skupinu zdrojů.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte název skupiny prostředků a vyberte Odstranit.

Po několika okamžicích se skupina prostředků a všechny její prostředky vymažou.

Související obsah

V tomto rychlém průvodci vám:

• Připojení Azure App Configuration ke službě Azure Container Apps
• Použití Dockeru k sestavení image kontejneru z aplikace ASP.NET Core s nastavením konfigurace aplikace
• Vytvoření instance služby Azure Container Registry
• Načtení image do instance služby Azure Container Registry
• Přidání image kontejneru do Azure Container Apps
• Přejděte na adresu URL instance Azure Container Apps aktualizovanou s nastavením, která jste nakonfigurovali v App Configuration Storu.

Spravovaná identita umožňuje jednomu prostředku Azure přistupovat k jinému bez zachování tajných kódů. Můžete zjednodušit přístup z Container Apps k dalším prostředkům Azure. Další informace najdete v tématu o přístupu ke službě App Configuration pomocí spravované identity a přístupu 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 dalším kurzem.

Povolení dynamické konfigurace