Oktatóanyag: Alkalmazás létrehozása és üzembe helyezése az Azure Container Appsben

Ez a cikk bemutatja, hogyan hozhat létre és helyezhet üzembe mikroszolgáltatást az Azure Container Appsben egy forrásadattárból az Ön által előnyben részesített programozási nyelv használatával.

Ez az első oktatóanyag a cikksorozatban, amely bemutatja, hogyan használhat alapvető képességeket az Azure Container Appsben. Az első lépés egy háttérbeli webes API-szolgáltatás létrehozása, amely zenei albumok statikus gyűjteményét adja vissza.

Feljegyzés

Az alkalmazást az az containerapp up használatával is létrehozhatja és üzembe helyezheti a rövid útmutató utasításait követve: Alkalmazás létrehozása és üzembe helyezése az Azure Container Appsben egy adattárcikkből. A az containerapp up parancs gyors és kényelmes módja annak, hogy az alkalmazást egyetlen paranccsal hozza létre és helyezze üzembe az Azure Container Appsben. A tárolóalkalmazás testreszabási szintje azonban nem azonos.

A sorozat következő oktatóanyaga létrehozza és üzembe helyezi az előtér-webalkalmazást az Azure Container Appsben.

Az alábbi képernyőképen az oktatóanyagban üzembe helyezett album API kimenete látható.

Előfeltételek

A projekt végrehajtásához a következő elemekre van szüksége:

Követelmény	Utasítások
Azure-fiók	Ha nem rendelkezik ilyen fiókkal, hozzon létre ingyenes fiókot. A folytatáshoz az Azure-előfizetés felhasználói hozzáférési rendszergazdájának vagy tulajdonosának engedélyére van szüksége. Ügyeljen arra, hogy a környezetéhez a legkorlátozóbb szerepkört használja. A részletekért tekintse meg az Azure-szerepkörök hozzárendelését az Azure Portal és az Azure-szerepkörök, a Microsoft Entra szerepkörök és a klasszikus előfizetés-rendszergazdai szerepkörökhasználatával.
GitHub-fiók	Regisztráljon ingyenesen.
git	Git telepítése
Azure CLI	Telepítse az Azure CLI-t.

Követelmény	Utasítások
Azure-fiók	Ha nem rendelkezik ilyen fiókkal, hozzon létre ingyenes fiókot. A folytatáshoz az Azure-előfizetés közreműködői vagy tulajdonosi engedélyére van szüksége. Részletekért tekintse meg az Azure-szerepkörök hozzárendelését az Azure Portalon .
GitHub-fiók	Regisztráljon ingyenesen.
git	Git telepítése
Azure CLI	Telepítse az Azure CLI-t.
Docker Desktop	A Docker olyan telepítőket biztosít, amelyek macOS, Windows és Linux rendszeren konfigurálják a Docker-környezetet. A parancssorból írja be docker , hogy a Docker fut-e.

Beállítás

Ha a parancssori felületről szeretne bejelentkezni az Azure-ba, futtassa a következő parancsot, és kövesse az utasításokat a hitelesítési folyamat befejezéséhez.

Erősen megüt

az login

Azure PowerShell

Connect-AzAccount

A parancssori felület legújabb verziójának futtatásához futtassa a frissítési parancsot.

Erősen megüt

az upgrade

Azure PowerShell

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

A jelenleg használt modulokra vonatkozó figyelmeztetések figyelmen kívül hagyása.

Ezután telepítse vagy frissítse az Azure Container Apps bővítményt a parancssori felülethez.

Ha hibaüzenetet kap a hiányzó paraméterekről, amikor parancsokat futtat az Azure CLI-ben, vagy parancsmagokat futtat az containerapp az Az.App Azure PowerShell modulból, győződjön meg arról, hogy telepítve van az Azure Container Apps bővítmény legújabb verziója.

Erősen megüt

az extension add --name containerapp --upgrade

Feljegyzés

2024 májusától kezdődően az Azure CLI-bővítmények alapértelmezés szerint nem engedélyezik az előzetes verziójú funkciókat. A Container Apps előzetes verziójú funkcióinak eléréséhez telepítse a Container Apps bővítményt a következővel --allow-preview true: .

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

Azure PowerShell

Install-Module -Name Az.App

Frissítse a modult a Az.App legújabb verzióra.

Update-Module -Name Az.App

Az aktuális bővítmény vagy modul telepítése után regisztrálja a névtereket és Microsoft.OperationalInsights a Microsoft.App névtereket.

Erősen megüt

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Környezeti változók létrehozása

Most, hogy az Azure CLI beállítása befejeződött, meghatározhatja a jelen cikkben használt környezeti változókat.

Erősen megüt

Adja meg a következő változókat a bash-rendszerhéjban.

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

A parancs futtatása előtt cserélje le <YOUR_GITHUB_USERNAME> a GitHub-felhasználónevét.

Ezután adjon meg egy egyedi tárolóregisztrációs adatbázisnevet.

ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

Adja meg a következő változókat a PowerShell-konzolon.

$ResourceGroup = "album-containerapps"
$Location = "canadacentral"
$Environment = "env-album-containerapps"
$APIName="album-api"
$FrontendName="album-ui"
$GITHUB_USERNAME = "<YOUR_GITHUB_USERNAME>"

A parancs futtatása előtt cserélje le <YOUR_GITHUB_USERNAME> a GitHub-felhasználónevét.

Ezután adjon meg egy egyedi tárolóregisztrációs adatbázisnevet.

$ACRName = "acaalbums"+$GITHUB_USERNAME

A GitHub-adattár előkészítése

Lépjen az előnyben részesített nyelv adattárára, és fordozza el az adattárat.

C#

Az album API-adattár tetején található Elágazás gombra kattintva elágazhatja a tárházat a fiókjához.

Most klónozhatja a mintaadattár elágazását.

A következő Git-paranccsal klónozza az elágaztatott adattárat a kód–felhő mappába:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-csharp.git code-to-cloud

Ugrás

Az album API-adattár tetején található Elágazás gombra kattintva elágazhatja a tárházat a fiókjához.

Most klónozhatja a mintaadattár elágazását.

A következő Git-paranccsal klónozza az elágaztatott adattárat a kód–felhő mappába:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-go.git code-to-cloud

Java

Az album API-adattár tetején található Elágazás gombra kattintva elágazhatja a tárházat a fiókjához.

Most klónozhatja a mintaadattár elágazását.

A következő Git-paranccsal klónozza az elágaztatott adattárat a kód–felhő mappába:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-java.git code-to-cloud

Feljegyzés

A Java-minta csak egy Maven-buildet támogat, amely végrehajtható JAR-fájlt eredményez. A build az alapértelmezett beállításokat használja, mivel a környezeti változók átadása nem támogatott.

JavaScript

Az album API-adattár tetején található Elágazás gombra kattintva elágazhatja a tárházat a fiókjához.

Most klónozhatja a mintaadattár elágazását.

A következő Git-paranccsal klónozza az elágaztatott adattárat a kód–felhő mappába:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-javascript.git code-to-cloud

Python

Az album API-adattár tetején található Elágazás gombra kattintva elágazhatja a tárházat a fiókjához.

Most klónozhatja a mintaadattár elágazását.

A következő Git-paranccsal klónozza az elágaztatott adattárat a kód–felhő mappába:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-python.git code-to-cloud

Ezután módosítsa a könyvtárat a klónozott adattár gyökerére.

cd code-to-cloud/src

Azure-erőforráscsoport létrehozása

Hozzon létre egy erőforráscsoportot a tárolóalkalmazás üzembe helyezéséhez kapcsolódó szolgáltatások rendszerezéséhez.

Erősen megüt

az group create \
  --name $RESOURCE_GROUP \
  --location "$LOCATION"

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Azure Container Registry-adatbázis létrehozása

Az album API tárolólemezképének létrehozása után hozzon létre egy Azure Container Registry-példányt (ACR) az erőforráscsoportban a tároláshoz.

Erősen megüt

az acr create \
  --resource-group $RESOURCE_GROUP \
  --name $ACR_NAME \
  --sku Basic \
  --admin-enabled true

Azure PowerShell

$acr = New-AzContainerRegistry -ResourceGroupName $ResourceGroup -Name $ACRName -Sku Basic -EnableAdminUser

Az alkalmazás összeállítása

Az ACR-feladatokkal a Docker helyi telepítése nélkül létrehozhatja és leküldheti az album API-hoz tartozó Docker-lemezképet.

A tároló létrehozása az ACR használatával

Futtassa a következő parancsot a rendszerkép-létrehozási és leküldési folyamat ACR használatával történő elindításához. A . parancs végén a Docker buildkörnyezete látható, ami azt jelenti, hogy ezt a parancsot azon az src mappán belül kell futtatni, ahol a Dockerfile található.

Erősen megüt

az acr build --registry $ACR_NAME --image $API_NAME .

Azure PowerShell

az acr build --registry $ACRName --image $APIName .

A parancs kimenete az acr build megjeleníti a forráskód Azure-ba való feltöltésének folyamatát, valamint a műveletek és docker push a docker build műveletek részleteit.

Az alkalmazás összeállítása

Az alábbi lépések bemutatják, hogyan hozhatja létre helyileg a tárolórendszerképet a Docker használatával, és hogyan küldheti le a lemezképet az új tárolóregisztrációs adatbázisba.

Tároló létrehozása a Dockerrel

Az alábbi parancs létrehoz egy tárolórendszerképet az album API-hoz, és címkézi az ACR bejelentkezési kiszolgáló teljes nevével. A . parancs végén a Docker buildkörnyezete látható, ami azt jelenti, hogy ezt a parancsot azon az src mappán belül kell futtatni, ahol a Dockerfile található.

Erősen megüt

docker build --tag $ACR_NAME.azurecr.io/$API_NAME .

Azure PowerShell

docker build --tag "$ACRName.azurecr.io/$APIName" .

A rendszerkép leküldése a tárolóregisztrációs adatbázisba

Először jelentkezzen be az Azure Container Registrybe.

Erősen megüt

az acr login --name $ACR_NAME

Azure PowerShell

az acr login --name $ACRName

Most küldje el a lemezképet a beállításjegyzékbe.

Erősen megüt

docker push $ACR_NAME.azurecr.io/$API_NAME

Azure PowerShell

docker push "$ACRName.azurecr.io/$APIName"

Container Apps-környezet létrehozása

Az Azure Container Apps-környezet biztonságos határként működik a tárolóalkalmazások egy csoportja körül.

Hozza létre a Container Apps-környezetet az alábbi paranccsal.

Erősen megüt

az containerapp env create \
  --name $ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location "$LOCATION"

Azure PowerShell

A Container Apps-környezethez Log Analytics-munkaterület szükséges. Az alábbi parancsok létrehoznak egy Log Analytics-munkaterületet, és a munkaterület azonosítóját és elsődleges megosztott kulcsát változókba mentik.

$WorkspaceArgs = @{
    Name = 'my-album-workspace'
    ResourceGroupName = $ResourceGroup
    Location = $Location
    PublicNetworkAccessForIngestion = 'Enabled'
    PublicNetworkAccessForQuery = 'Enabled'
}
New-AzOperationalInsightsWorkspace @WorkspaceArgs
$WorkspaceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).CustomerId
$WorkspaceSharedKey = (Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).PrimarySharedKey

A környezet létrehozásához futtassa a következő parancsot:

$EnvArgs = @{
    EnvName = $Environment
    ResourceGroupName = $ResourceGroup
    Location = $Location
    AppLogConfigurationDestination = 'log-analytics'
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
}

New-AzContainerAppManagedEnv @EnvArgs

Rendszerkép üzembe helyezése tárolóalkalmazásban

Most, hogy létrehozott egy környezetet, létrehozhatja és üzembe helyezheti a tárolóalkalmazást a az containerapp create paranccsal.

Hozza létre és telepítse a tárolóalkalmazást az alábbi paranccsal.

Erősen megüt

az containerapp create \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $ACR_NAME.azurecr.io/$API_NAME \
  --target-port 8080 \
  --ingress external \
  --registry-server $ACR_NAME.azurecr.io \
  --query properties.configuration.ingress.fqdn

• A beállítással --ingress externala tárolóalkalmazás elérhető a nyilvános internetről.

• A target-port beállítás úgy van beállítva 8080 , hogy megfeleljen annak a portnak, amelyet a tároló a kérelmeket figyel.

• query Tulajdonság nélkül a hívás az containerapp create JSON-választ ad vissza, amely az alkalmazás részletes adatait tartalmazza. A lekérdezési paraméter hozzáadása csak az alkalmazás teljes tartománynevére (FQDN) szűri a kimenetet.

Azure PowerShell

A tárolóalkalmazás létrehozásához hozzon létre sablonobjektumokat, amelyeket argumentumként ad át a New-AzContainerApp parancsnak.

Hozzon létre egy sablonobjektumot a tárolórendszerkép paramétereinek definiálásához.

$ImageParams = @{
    Name = $APIName
    Image = $ACRName + '.azurecr.io/' + $APIName + ':latest'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams

Futtassa a következő parancsot a beállításjegyzék hitelesítő adatainak lekéréséhez.

$RegistryCredentials = Get-AzContainerRegistryCredential -Name $ACRName -ResourceGroupName $ResourceGroup

Hozzon létre egy beállításjegyzék-hitelesítő objektumot a beállításjegyzék adatainak meghatározásához, és egy titkos objektumot a beállításjegyzék jelszavának meghatározásához. A PasswordSecretRef titkos objektumra hivatkozik Name .

$RegistryArgs = @{
    Server = $ACRName + '.azurecr.io'
    PasswordSecretRef = 'registrysecret'
    Username = $RegistryCredentials.Username
}
$RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs

$SecretObj = New-AzContainerAppSecretObject -Name 'registrysecret' -Value $RegistryCredentials.Password

Kérje le a környezet azonosítóját.

$EnvId = (Get-AzContainerAppManagedEnv -EnvName $Environment -ResourceGroup $ResourceGroup).Id

Hozza létre a tárolóalkalmazást.

$AppArgs = @{
    Name = $APIName
    Location = $Location
    ResourceGroupName = $ResourceGroup
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $TemplateObj
    ConfigurationRegistry = $RegistryObj
    ConfigurationSecret = $SecretObj
    IngressTargetPort = 8080
    IngressExternal = $true
}
$MyApp = New-AzContainerApp @AppArgs

# show the app's fully qualified domain name (FQDN).
$MyApp.IngressFqdn

• A beállítással IngressExternal externala tárolóalkalmazás elérhető a nyilvános internetről.
• A IngressTargetPort paraméter úgy van beállítva 8080 , hogy megfeleljen annak a portnak, amelyet a tároló a kérelmeket figyel.

Az üzembe helyezés ellenőrzése

Másolja a teljes tartománynevet egy webböngészőbe. A webböngészőből lépjen a /albums teljes tartománynév végpontjára.

Az erőforrások eltávolítása

Ha nem folytatja a mikroszolgáltatások közötti kommunikáció oktatóanyagot, eltávolíthatja a rövid útmutató során létrehozott Azure-erőforrásokat. Futtassa a következő parancsot az erőforráscsoport és az ebben a rövid útmutatóban létrehozott összes erőforrás törléséhez.

Erősen megüt

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroup -Force

Tipp.

Problémákat tapasztal? Tudassa velünk a GitHubon, ha megnyit egy hibát az Azure Container Apps adattárában.

Következő lépések

Ez a rövid útmutató az Azure Container Apps különböző funkcióit bemutató progresszív oktatóanyagok kezdőpontja. A cikkből megtudhatja, hogyan engedélyezheti a kommunikációt egy webes előtérről, amely meghívja az ebben a cikkben üzembe helyezett API-t.

Oktatóanyag: Mikroszolgáltatások közötti kommunikáció