Sdílet prostřednictvím

Nasazení Azure Container Apps pomocí příkazu az containerapp up

Příkaz az containerapp up (nebo up) představuje nejrychlejší způsob, jak nasadit aplikaci v Azure Container Apps z existující image, místního zdrojového kódu nebo úložiště GitHub. Když použijete tento jediný příkaz, můžete mít aplikaci kontejneru v provozu během několika minut.

Příkaz může sestavit a odeslat image kontejneru do služby Azure Container Registry, když zadáte místní zdrojový kód nebo úložiště GitHub. Když pracujete z úložiště GitHub, příkaz vytvoří pracovní postup GitHub Actions, který automaticky sestaví a nasdílí novou image kontejneru při potvrzení změn do úložiště GitHub.

V tomto článku se dozvíte, jak pomocí příkazu nasadit aplikaci kontejneru z existující image, místního zdrojového kódu a úložiště GitHub.

Požadavky

Požadavek Pokyny
Účet Azure Pokud ho nemáte, vytvořte si účet zdarma. Vaše předplatné Azure musí mít roli Přispěvatel nebo Vlastník . Podrobné informace najdete v tématu Přiřazení rolí Azure pomocí webu Azure Portal.
Nástroj Azure CLI Nainstalujte rozhraní příkazového řádku Azure CLI.
Účet GitHubu Pokud chcete použít obrázek v úložišti GitHub, zaregistrujte si bezplatný účet GitHub.
Místní zdrojový kód Pokud chcete vytvořit image z místního zdrojového kódu, vložte kód do místního adresáře.
Existující obrázek Pokud chcete použít existující image, poznamenejte si server registru, název image a značku. Pokud používáte privátní registr, poznamenejte si také svoje přihlašovací údaje.

Použití existujících prostředků

Příkaz up může vytvářet prostředky nebo může používat existující prostředky, včetně těchto:

  • Skupina prostředků
  • Registr kontejnerů
  • Prostředí Container Apps a pracovní prostor služby Log Analytics
  • Vaše aplikace typu kontejner.

Pokud potřebujete přizpůsobit prostředí Container Apps, nejprve pomocí az containerapp env create příkazu vytvořte a přizpůsobte prostředí. Po spuštění up příkazu použijte --environment možnost k zadání přizpůsobeného prostředí.

Pokud nezadáte existující prostředí, up příkaz ho vyhledá ve vaší skupině prostředků. Pokud příkaz najde prostředí, použije toto prostředí. Pokud příkaz nenajde prostředí, vytvoří prostředí, které obsahuje pracovní prostor služby Log Analytics.

Další informace o az containerapp up příkazu a jeho možnostech naleznete v tématu az containerapp up.

Nastavení prostředí Azure CLI

  1. Pomocí Azure CLI se přihlaste k Azure.

    az login

  2. Nainstalujte rozšíření Container Apps pro Azure CLI.

    az extension add --name containerapp --upgrade

  3. Zaregistrujte Microsoft.App obor názvů.

    az provider register --namespace Microsoft.App

  4. Zaregistrujte poskytovatele Microsoft.OperationalInsights pro pracovní prostor Log Analytics.

    az provider register --namespace Microsoft.OperationalInsights

Nasazení z existující image

Můžete nasadit aplikaci kontejneru, která používá existující image ve veřejném nebo privátním registru kontejneru. Pokud provádíte nasazení z privátního registru, musíte zadat své přihlašovací údaje pomocí a --registry-servermožnosti . --registry-username--registry-password

Pomocí následujícího ukázkového kódu můžete nasadit aplikaci kontejneru z existující image. Před spuštěním příkazu nahraďte zástupné symboly, které jsou uzavřeny v úhlových závorkách, hodnotami.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
  --ingress external \
  --target-port <PORT_NUMBER>

Tento příkaz provede následující akce:

  1. Vytvoří skupinu prostředků.
  2. Vytvoří prostředí a pracovní prostor služby Log Analytics.
  3. Vytvoří a nasadí aplikaci typu kontejner, která načte image z veřejného registru.
  4. Nastaví hodnotu aplikace ingress kontejneru na external s cílovým portem nastaveným na zadanou hodnotu.

Příkaz můžete také použít up k opětovnému nasazení aplikace kontejneru. Pokud chcete znovu nasadit novou image, použijte --image možnost zadat novou image. Ujistěte se, že --resource-group jsou možnosti nastavené --environment na hodnoty z původního nasazení.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --environment <ENVIRONMENT_NAME> \
  --ingress external \
  --target-port <PORT_NUMBER>

Nasazení z místního zdrojového kódu

Když příkaz použijete up k nasazení z místního zdroje, sestaví image kontejneru, odešle ji do registru a nasadí aplikaci kontejneru. Pokud nezadáte registr, příkaz ho vytvoří ve službě Container Registry.

Příkaz může sestavit image se souborem Dockerfile nebo bez této image. V buildech, které nepoužívají soubor Dockerfile, se podporují následující jazyky:

  • platforma .NET
  • Node.js
  • PHP
  • Python

K nasazení aplikace kontejneru z místního zdrojového kódu můžete použít následující ukázkový kód:

    az containerapp up \
      --name <CONTAINER_APP_NAME> \
      --source <SOURCE_DIRECTORY>\
      --ingress external

Tento příkaz provede následující akce:

  1. Vytvoří skupinu prostředků.
  2. Vytvoří prostředí a pracovní prostor služby Log Analytics.
  3. Vytvoří registr ve službě Container Registry.
  4. Vytvoří image kontejneru (pokud existuje, pomocí souboru Dockerfile).
  5. Odešle image do registru.
  6. Vytvoří a nasadí aplikaci typu kontejner.

Pokud soubor Dockerfile obsahuje EXPOSE instrukce, up příkaz nakonfiguruje příchozí a cílový port aplikace kontejneru pomocí informací v souboru Dockerfile. Pokud konfigurujete příchozí přenos dat prostřednictvím souboru Dockerfile nebo vaše aplikace nevyžaduje příchozí přenos dat, můžete tuto --ingress možnost vynechat.

Výstup příkazu obsahuje adresu URL aplikace kontejneru.

Pokud příkaz hlásí, že čeká na agenta cloudového sestavení, ale pak přestane reagovat, může být zdrojem problému přechodná chyba GitHubu. Pokud chcete situaci vyřešit, spusťte příkaz znovu.

Pokud dojde k selhání, můžete příkaz spustit znovu s --debug možností získat další informace. Pokud sestavení selže bez souboru Dockerfile, můžete zkusit přidat soubor Dockerfile a spustit příkaz znovu.

Pomocí příkazu az containerapp up znovu nasadíte aplikaci kontejneru s aktualizovaným obrazem; zahrňte možnosti --resource-group a --environment. Pokud chcete znovu nasadit aplikaci kontejneru z místního zdrojového kódu, postupujte takto:

  1. Proveďte změny zdrojového kódu.

  2. Spusťte následující příkaz:

    az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --source <SOURCE_DIRECTORY> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --environment <ENVIRONMENT_NAME>

Nasazení z úložiště GitHub

Když příkaz použijete az containerapp up k nasazení z úložiště GitHub, vygeneruje pracovní postup GitHub Actions, který sestaví image kontejneru, odešle ji do registru a nasadí aplikaci kontejneru. Pokud nezadáte registr, příkaz ho vytvoří ve službě Container Registry.

K sestavení image se vyžaduje soubor Dockerfile. Pokud soubor Dockerfile obsahuje EXPOSE instrukce, příkaz nakonfiguruje příchozí a cílový port aplikace kontejneru pomocí informací v souboru Dockerfile.

Pomocí následujícího ukázkového kódu můžete nasadit aplikaci kontejneru z úložiště GitHub:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --repo <GITHUB_REPOSITORY_URL> \
  --ingress external

Tento příkaz provede následující akce:

  1. Vytvoří skupinu prostředků.
  2. Vytvoří prostředí a pracovní prostor služby Log Analytics.
  3. Vytvoří registr ve službě Container Registry.
  4. Sestaví image kontejneru pomocí souboru Dockerfile.
  5. Odešle image do registru.
  6. Vytvoří a nasadí aplikaci typu kontejner.
  7. Vytvoří pracovní postup GitHub Actions pro sestavení image kontejneru a nasazení aplikace kontejneru, když se budoucí změny nasdílí do úložiště GitHub.

Pokud příkaz selže, protože instanční objekt nejde vytvořit, můžete v Azure ručně vytvořit instanční objekt. Potom můžete předat informace příkazu:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --repo <GITHUB_REPOSITORY_URL> \
  --service-principal-client-id "$SERVICE_PRINCIPAL_CLIENT_ID" \
  --service-principal-client-secret "$SERVICE_PRINCIPAL_CLIENT_SECRET" \
  --service-principal-tenant-id "$AZURE_TENANT_ID"
  --ingress external

Pokud konfigurujete příchozí přenos dat prostřednictvím souboru Dockerfile nebo vaše aplikace nevyžaduje příchozí přenos dat, můžete tuto --ingress možnost vynechat.

Příkaz up vytvoří pracovní postup GitHub Actions. Výsledkem je, že opětovné spouštění příkazu má nežádoucí vliv na vytváření více pracovních postupů. Pokud chcete nasadit změny do image aplikace, nasdílejte změny do úložiště GitHub místo opětovného spuštění příkazu. Pracovní postup GitHubu automaticky rozpozná změny ve vašem úložišti a pak sestaví a nasadí vaši aplikaci. Pokud chcete změnit pracovní postup, upravte soubor pracovního postupu na GitHubu.

Konfigurace nastavení aplikace kontejneru

Tento az containerapp up příkaz poskytuje zjednodušený způsob, jak vytvářet a nasazovat aplikace kontejnerů, které primárně používají výchozí nastavení. Po použití up příkazu ale musíte spustit další příkazy Azure CLI, například následující, pokud chcete nakonfigurovat pokročilejší nastavení:

Pokud chcete přizpůsobit další nastavení pro vaši aplikaci kontejneru, například nastavení prostředku nebo škálování, použijte up nejprve příkaz k nasazení aplikace kontejneru. Potom pomocí az containerapp update příkazu změňte tato nastavení. Příkaz az containerapp up není zkratkou az containerapp update příkazu.

Další krok

Rychlý start: Sestavení a nasazení z místního zdrojového kódu do Azure Container Apps

  • Last updated on