Nasazení Azure Container Apps pomocí příkazu az containerapp up
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-server
a --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 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 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 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.
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.