Rychlý start: Sestavení a nasazení z úložiště do Azure Container Apps

Tento článek ukazuje, jak sestavit a nasadit mikroslužbu do Azure Container Apps z úložiště GitHub pomocí programovacího jazyka podle vašeho výběru. V tomto rychlém startu vytvoříte ukázkovou mikroslužbu, která představuje back-endovou webovou službu API, která vrací statickou kolekci hudebních alb.

Tato ukázková aplikace je dostupná ve dvou verzích. Jedna verze obsahuje kontejner, ve kterém zdroj obsahuje soubor Dockerfile. Druhá verze neobsahuje žádný soubor Dockerfile. Vyberte verzi, která nejlépe odpovídá vašemu zdrojovému kódu. Pokud s kontejnery začínáte, vyberte nahoře možnost Žádný soubor Dockerfile .

Poznámka:

Tuto ukázkovou aplikaci můžete také sestavit a nasadit z místního systému souborů. Další informace najdete v tématu Sestavení z místního zdrojového kódu a nasazení aplikace v Azure Container Apps.

Následující snímek obrazovky ukazuje výstup ze služby rozhraní API alba, kterou nasadíte.

Požadavky

K dokončení tohoto projektu potřebujete následující položky:

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	Získejte ho zdarma.
git	Instalace Gitu
Azure CLI	Nainstalujte rozhraní příkazového řádku Azure CLI.

Nastavení

Pokud se chcete přihlásit k Azure z rozhraní příkazového řádku, spusťte následující příkaz a podle pokynů dokončete proces ověřování.

Udeřit

az login

Azure PowerShell

Connect-AzAccount

Pokud chcete zajistit, že používáte nejnovější verzi rozhraní příkazového řádku, spusťte příkaz upgrade.

Udeřit

az upgrade

Azure PowerShell

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Ignorujte všechna upozornění na aktuálně používané moduly.

Dále nainstalujte nebo aktualizujte rozšíření Azure Container Apps pro rozhraní příkazového řádku.

Pokud se při spouštění az containerapp příkazů v Azure CLI nebo rutinách Az.App z modulu v Azure PowerShellu zobrazí chyby týkající se chybějících parametrů, ujistěte se, že máte nainstalovanou nejnovější verzi rozšíření Azure Container Apps.

Udeřit

az extension add --name containerapp --upgrade

Poznámka:

Od května 2024 už rozšíření Azure CLI ve výchozím nastavení nepovolují funkce ve verzi Preview. Pokud chcete získat přístup k funkcím Container Apps ve verzi Preview, nainstalujte rozšíření Container Apps pomocí --allow-preview truenástroje .

az extension add --name containerapp --upgrade --allow-preview true

Azure PowerShell

Install-Module -Name Az.App

Nezapomeňte aktualizovat Az.App modul na nejnovější verzi.

Update-Module -Name Az.App

Teď, když je nainstalované aktuální rozšíření nebo modul, zaregistrujte obory Microsoft.App názvů a Microsoft.OperationalInsights obory názvů.

Udeřit

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Vytvoření proměnných prostředí

Po dokončení nastavení Azure CLI můžete definovat proměnné prostředí, které se používají v tomto článku.

Udeřit

Definujte následující proměnné v prostředí Bash.

export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
export GITHUB_USERNAME="<YOUR_GITHUB_USERNAME>"

Před spuštěním tohoto příkazu nezapomeňte nahradit <YOUR_GITHUB_USERNAME> uživatelské jméno GitHubu.

Dále definujte název registru kontejneru, který je pro vás jedinečný.

export ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

V konzole PowerShellu definujte následující proměnné.

$RESOURCE_GROUP="album-containerapps"
$LOCATION="canadacentral"
$ENVIRONMENT="env-album-containerapps"
$API_NAME="album-api"
$GITHUB_USERNAME="<YOUR_GITHUB_USERNAME>"

Před spuštěním tohoto příkazu nezapomeňte nahradit <YOUR_GITHUB_USERNAME> uživatelské jméno GitHubu.

Dále definujte název registru kontejneru, který je pro vás jedinečný.

$ACR_NAME="acaalbums"+$GITHUB_USERNAME

Příprava úložiště GitHub

V okně prohlížeče přejděte do úložiště GitHub pro preferovaný jazyk a vytvořte fork úložiště.

C#

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Pak zkopírujte adresu URL úložiště, abyste ji mohli použít v dalším kroku.

Java

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Pak zkopírujte adresu URL úložiště, abyste ji mohli použít v dalším kroku.

JavaScript

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Pak zkopírujte adresu URL úložiště, abyste ji mohli použít v dalším kroku.

Python

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Pak zkopírujte adresu URL úložiště, abyste ji mohli použít v dalším kroku.

Přejít

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Pak zkopírujte adresu URL úložiště, abyste ji mohli použít v dalším kroku.

V okně prohlížeče přejděte do úložiště GitHub pro preferovaný jazyk a vytvořte fork úložiště včetně větví.

C#

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Zrušte zaškrtnutí políčka Kopírovat main jenom větev, aby se větev rozvětvená rozvětvená rozvětvení rozvětvení kopírovala buildpack .

Java

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Zrušte zaškrtnutí políčka Kopírovat main jenom větev, aby se větev rozvětvená rozvětvená rozvětvení rozvětvení kopírovala buildpack .

JavaScript

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Zrušte zaškrtnutí políčka Kopírovat main jenom větev, aby se větev rozvětvená rozvětvená rozvětvení rozvětvení kopírovala buildpack .

Python

Výběrem tlačítka Fork v horní části úložiště rozhraní API alba rozvětvte úložiště do svého účtu. Zrušte zaškrtnutí políčka Kopírovat main jenom větev, aby se větev rozvětvená rozvětvená rozvětvení rozvětvení kopírovala buildpack .

Přejít

Cloudové sestavení Azure Container Apps v současné době nepodporuje Buildpacky pro Go.

---

Sestavení a nasazení aplikace typu kontejner

Pomocí příkazu sestavte a nasaďte svou první kontejnerovou aplikaci z rozvětvovaného úložiště containerapp up GitHub. Tento příkaz:

• Vytvoření skupiny prostředků
• Vytvoření prostředí Container Apps s pracovním prostorem služby Log Analytics
• Vytvoření registru služby Azure Container Registry
• Vytvoření pracovního postupu akce GitHubu pro sestavení a nasazení aplikace kontejneru

• Vytvoření skupiny prostředků
• Vytvoření prostředí Container Apps s pracovním prostorem služby Log Analytics
• Automatické vytvoření výchozího registru v rámci vašeho prostředí
• Vytvoření pracovního postupu akce GitHubu pro sestavení a nasazení aplikace kontejneru

Když do úložiště nasdílíte nový kód, akce GitHubu:

• Sestavení image kontejneru a jeho nasdílení do služby Azure Container Registry
• Nasazení image kontejneru do vytvořené aplikace kontejneru

Příkaz up používá soubor Dockerfile v kořenovém adresáři úložiště k sestavení image kontejneru. Instrukce EXPOSE v souboru Dockerfile definuje cílový port. K sestavení aplikace kontejneru není potřeba soubor Dockeru.

• Automatická detekce jazyka a modulu runtime
• Sestavení image pomocí příslušného buildpacku
• Nasdílení image do výchozího registru Azure Container Apps

Aplikace kontejneru musí být přístupná pro příchozí přenos dat. Ujistěte se, že chcete zpřístupnit port 8080 pro naslouchání příchozím požadavkům.

V následujícím příkazu nahraďte <YOUR_GITHUB_REPOSITORY_NAME> názvem úložiště GitHub ve formě https://github.com/<OWNER>/<REPOSITORY-NAME> nebo <OWNER>/<REPOSITORY-NAME>.

V následujícím příkazu nahraďte <YOUR_GITHUB_REPOSITORY_NAME> názvem úložiště GitHub ve formě https://github.com/<OWNER>/<REPOSITORY-NAME> nebo <OWNER>/<REPOSITORY-NAME>. --branch buildpack Použijte možnost odkazovat na ukázkový zdroj bez souboru Dockerfile.

Udeřit

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --context-path ./src \
  --repo <YOUR_GITHUB_REPOSITORY_NAME>

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --context-path ./src \
  --ingress external \
  --target-port 8080 \
  --repo <YOUR_GITHUB_REPOSITORY_NAME>
  --branch buildpack
  --

Azure PowerShell

az containerapp up `
    --name $API_NAME `
    --resource-group $RESOURCE_GROUP `
    --location $LOCATION `
    --environment $ENVIRONMENT `
    --context-path ./src `
    --repo <YOUR_GITHUB_REPOSITORY_NAME>

az containerapp up `
    --name $API_NAME `
    --resource-group $RESOURCE_GROUP `
    --location $LOCATION `
    --environment $ENVIRONMENT `
    --context-path ./src `
    --ingress external `
    --target-port 8080 `
    --repo <YOUR_GITHUB_REPOSITORY_NAME>
    --branch buildpack

Pomocí adresy URL a uživatelského kódu zobrazeného v terminálu přejděte v prohlížeči na stránku aktivace zařízení GitHub a zadejte na stránku uživatelský kód. Postupujte podle pokynů a autorizujete Azure CLI pro přístup k úložišti GitHub.

Příkaz up vytvoří pracovní postup akce GitHubu ve složce .github/workflows vašeho úložiště. Pracovní postup se aktivuje k sestavení a nasazení aplikace kontejneru při nasdílení změn do úložiště.

---

Ověření nasazení

Zkopírujte název domény vrácený containerapp up webovým prohlížečem. Ve webovém prohlížeči přejděte na /albums koncový bod adresy URL.

Vyčištění prostředků

Pokud nebudete pokračovat v kurzu Nasazení front-endu, můžete prostředky Azure vytvořené během tohoto rychlého startu odebrat pomocí následujícího příkazu.

Upozornění

Následující příkaz odstraní zadanou skupinu prostředků a všechny prostředky obsažené v ní. Pokud skupina obsahuje prostředky mimo rozsah tohoto rychlého startu, odstraní se také.

Udeřit

az group delete --name $RESOURCE_GROUP

Azure PowerShell

az group delete --name $RESOURCE_GROUP

Tip

Máte problémy? Dejte nám vědět na GitHubu otevřením problému v úložišti Azure Container Apps.

Další kroky

Po dokončení tohoto rychlého startu můžete pokračovat v kurzu: Komunikace mezi mikroslužbami v Azure Container Apps a dozvíte se, jak nasadit front-endovou aplikaci, která volá rozhraní API.

Kurz: Komunikace mezi mikroslužbami