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

Článek
04/25/2024

Příkaz az containerapp up (nebo up) je 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ě GitHubu. Pomocí tohoto jediného příkazu můžete mít aplikaci kontejneru spuštěnou a spuštěnou v řádu minut.

Příkaz az containerapp up je zjednodušený způsob, jak vytvářet a nasazovat aplikace kontejnerů, které primárně používají výchozí nastavení. Pokud ale chcete nakonfigurovat pokročilejší nastavení, musíte spustit další příkazy rozhraní příkazového řádku:

Dapr: az containerapp dapr enable
Tajemství: az containerapp secret set
Přenosové protokoly: az containerapp ingress update

Pokud chcete přizpůsobit nastavení prostředku nebo škálování aplikace kontejneru, můžete použít up příkaz a příkaz az containerapp update změnit tato nastavení. Příkaz az containerapp up není zkratkou az containerapp update příkazu.

Příkaz up může vytvořit nebo použít existující prostředky, mezi které patří:

Skupina prostředků
Azure Container Registry
Prostředí Container Apps a pracovní prostor Služby Log Analytics
Vaše aplikace typu kontejner

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

Pokud potřebujete přizpůsobit prostředí Container Apps, nejprve vytvořte prostředí pomocí az containerapp env create příkazu. Pokud nezadáte existující prostředí, up příkaz ho vyhledá ve vaší skupině prostředků a pokud se najde, použije toto prostředí. Pokud ho nenajdete, vytvoří prostředí s pracovním prostorem služby Log Analytics.

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

Požadavky

Požadavek	Pokyny
Účet Azure	Pokud ho nemáte, vytvořte si účet zdarma. K pokračování potřebujete oprávnění přispěvatele nebo vlastníka předplatného Azure. Podrobnosti najdete v tématu Přiřazení rolí Azure pomocí webu Azure Portal .
Účet GitHubu	Pokud používáte úložiště GitHub, zaregistrujte se zdarma.
Azure CLI	Nainstalujte rozhraní příkazového řádku Azure CLI.
Místní zdrojový kód	Pokud používáte místní zdrojový kód, musíte mít místní adresář zdrojového kódu.
Existující obrázek	Pokud používáte existující image, potřebujete server registru, název image a značku. Pokud používáte privátní registr, potřebujete svoje přihlašovací údaje.

Nastavení

Přihlaste se k Azure pomocí Azure CLI.
```
az login
```
Dále nainstalujte rozšíření Azure Container Apps pro rozhraní příkazového řádku.
```
az extension add --name containerapp --upgrade
```
Teď, když je nainstalované aktuální rozšíření nebo modul, zaregistrujte Microsoft.App obor názvů.
```
az provider register --namespace Microsoft.App
```
Zaregistrujte zprostředkovatele Microsoft.OperationalInsights pro pracovní prostor služby Azure Monitor 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í parametrů --registry-servera --registry-username--registry-password možností .

V tomto příkladu az containerapp up příkaz provede následující akce:

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

Spuštěním následujícího příkazu nasaďte aplikaci kontejneru z existující image. <Zástupné symboly> nahraďte hodnotami.

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

Pomocí příkazu můžete up znovu nasadit aplikaci 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 stejné hodnoty jako původní 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 ho nezadáte, vytvoří se registr ve službě Azure Container Registry.

Příkaz může sestavit image se souborem Dockerfile nebo bez této image. Pokud se sestavení bez souboru Dockerfile podporuje následující jazyky:

.NET
Node.js
PHP
Python

Následující příklad ukazuje, jak nasadit aplikaci kontejneru z místního zdrojového kódu.

V příkladu az containerapp up příkaz provede následující akce:

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

Spuštěním následujícího příkazu nasaďte aplikaci kontejneru z místního zdrojového kódu:

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

Pokud soubor Dockerfile obsahuje instrukce EXPOSE, up příkaz nakonfiguruje příchozí a cílový port aplikace kontejneru pomocí informací v souboru Dockerfile.

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

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

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

Pokud chcete pomocí az containerapp up příkazu znovu nasadit aplikaci kontejneru s aktualizovanou imagí, uveďte argumenty --resource-group a --environment argumenty. Následující příklad ukazuje, jak znovu nasadit aplikaci kontejneru z místního zdrojového kódu.

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

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 ho nezadáte, příkaz vytvoří registr ve službě Azure Container Registry.

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

Následující příklad ukazuje, jak nasadit aplikaci kontejneru z úložiště GitHub.

V příkladu az containerapp up příkaz provede následující akce:

Vytvoří skupinu prostředků.
Vytvoří prostředí a pracovní prostor služby Log Analytics.
Vytvoří registr ve službě Azure Container Registry.
Vytvoří image kontejneru pomocí souboru Dockerfile.
Odešle image do registru.
Vytvoří a nasadí aplikaci typu kontejner.
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 chcete nasadit aplikaci z úložiště GitHub, spusťte následující příkaz:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --repo <GitHub repository URL> \
  --ingress external

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

up Vzhledem k tomu, že příkaz vytvoří pracovní postup GitHub Actions, opětovné nasazení změn do image vaší aplikace má nežádoucí vliv na vytvoření více pracovních postupů. Místo toho nasdílejte změny do úložiště GitHub a pracovní postup GitHubu se automaticky sestaví a nasadí vaši aplikaci. Pokud chcete změnit pracovní postup, upravte soubor pracovního postupu na GitHubu.

Další kroky

Rychlý start: Nasazení kódu do Azure Container Apps

Share via