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

V tomto rychlém startu použijete Aplikace Azure 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.

Tip

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.

Požadavky


Připojení konfigurace Aplikace Azure k aplikaci kontejneru

Na webu Azure Portal přejděte do instance kontejnerové aplikace. Postupujte podle rychlého startu konektoru služby pro Azure Container Apps a vytvořte připojení služby ke službě App Configuration Store pomocí následujících nastavení.

  • Na kartě Základy :

    • výběr konfigurace aplikace pro typ služby

    • Vyberte si app Configuration Store pro "App Configuration" (Konfigurace aplikace).

      Snímek obrazovky platformy Azure zobrazující formulář v nabídce Konektor služby v aplikaci kontejneru

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

    • Vyberte typ ověřování připojovacího řetězce a jako "Oprávnění pro připojovací řetězec
    • rozbalte nabídku Upřesnit. V informacích o konfiguraci by již měla být vytvořená proměnná prostředí s názvem "AZURE_APPCONFIGURATION_CONNECTIONSTRING". Upravte proměnnou prostředí tak, že vpravo vyberete ikonu 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í, ve které bude aplikace vytvořená v rychlém startu ASP.NET Core hledat. Toto je proměnná prostředí, která obsahuje připojovací řetězec pro konfiguraci aplikace. Pokud jste k provedení tohoto rychlého startu použili jinou aplikaci, použijte odpovídající název proměnné prostředí. Pak vyberte Hotovo.
  • Použijte výchozí hodnoty pro všechno ostatní.

Po dokončení se do kontejneru vaší aplikace Container App přidá proměnná prostředí s názvem ConnectionStrings__AppConfig . Jeho hodnota je odkazem na tajný klíč kontejnerové aplikace, připojovací řetězec vašeho App Configuration Storu.

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ů.

  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 Přístupové klíče 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 uživatele správce 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.

Nahrání image do služby 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 se vrátí Login Succeeded po úspěšném přihlášení.

  2. K označení odpovídajících podrobností použijte značku Dockeru.

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

    Tip

    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ě.

    Snímek obrazovky platformy Azure zobrazující úložiště ve službě Azure Container Registry

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

Aktualizujte svou kontejnerovou aplikaci, aby načetla image kontejneru z 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í:

    Nastavení Navrhovaná hodnota Popis
    Zdroj obrázku Azure Container Registry Jako zdroj image vyberte Azure Container Registry.
    Ověřování 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ě.
    Registr myregistry.azurecr.io Vyberte službu Azure Container Registry, kterou jste vytvořili dříve.
    Image aspnetapp Vyberte image Dockeru, kterou jste vytvořili, a vložte ji do služby ACR dříve.
    Značka obrázku v1 Ze seznamu vyberte značku obrázku.
  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:

Snímek obrazovky internetového prohlížeče zobrazující spuštěnou aplikaci

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 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 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 prostředků.
  5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte název skupiny prostředků 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á konfigurace Aplikace Azure 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
  • Nasdílení 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 přístup ke službě 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 dalším kurzem.