Oktatóanyag: Az első tárolóalkalmazás üzembe helyezése

Az Azure Container Apps szolgáltatás lehetővé teszi mikroszolgáltatások és tárolóalapú alkalmazások futtatását egy kiszolgáló nélküli platformon. A Container Apps használatával élvezheti a tárolók futtatásának előnyeit, miközben a felhőinfrastruktúra és az összetett tárolóvezénylők manuális konfigurálásával kapcsolatos aggodalmakat hagyja maga után.

Ebben az oktatóanyagban létrehoz egy biztonságos Container Apps-környezetet, és üzembe helyezi az első tárolóalkalmazást.

Megjegyzés

Ezt az alkalmazást az az containerapp up használatával is üzembe helyezheti a rövid útmutató utasításait követve: Az első tárolóalkalmazás üzembe helyezése a containerapp up cikk segítségével. 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 lehetőségei azonban nem érik el ugyanazt a szintet.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel.
  • Ha még nem rendelkezik fiókkal, ingyen létrehozhat egyet.
• Telepítse az Azure CLI-t.

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.

Bash

az login

PowerShell

Connect-AzAccount

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

Bash

az upgrade

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 containerapp az Azure CLI-ben vagy parancsmagokat a Az.App 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.

Bash

az extension add --name containerapp --upgrade

Megjegyzé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

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 Microsoft.App és Microsoft.OperationalInsights névtereket.

Bash

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Környezeti változók beállítása

Állítsa be a következő környezeti változókat. Cserélje le a <placeholders> karakterláncot a saját értékeivel.

Bash

RESOURCE_GROUP="<new-resource-group>"
LOCATION="<location>"
CONTAINERAPPS_ENVIRONMENT="<containerapps-environment>"

PowerShell

$ResourceGroupName = '<new-resource-group>'
$Location = '<location>'
$ContainerAppsEnvironment = '<containerapps-environment>'

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.

Bash

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

PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Környezet létrehozása

Az Azure Container Apps környezete biztonságos határt hoz létre a tárolóalkalmazások egy csoportja körül. Az ugyanabban a környezetben üzembe helyezett Tárolóalkalmazások ugyanabban a virtuális hálózaton vannak üzembe helyezve, és naplókat írnak ugyanarra a Log Analytics-munkaterületre.

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

Bash

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

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 mentik a munkaterület azonosítóját és az elsődleges megosztott kulcsot a környezeti változókba.

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

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

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

New-AzContainerAppManagedEnv @EnvArgs

Tárolóalkalmazás létrehozása

Most, hogy létrehozott egy környezetet, üzembe helyezheti az első tárolóalkalmazást. containerapp create A paranccsal helyezzen üzembe egy tárolórendszerképet az Azure Container Appsben.

Bash

az containerapp create \
  --name my-container-app \
  --resource-group $RESOURCE_GROUP \
  --environment $CONTAINERAPPS_ENVIRONMENT \
  --image mcr.microsoft.com/k8se/quickstart:latest \
  --target-port 80 \
  --ingress external \
  --query properties.configuration.ingress.fqdn

Megjegyzés

Győződjön meg arról, hogy a --image paraméter értéke kisbetűs.

--ingress external beállításával elérhetővé teszi a tárolóalkalmazást a nyilvános kérések számára.

PowerShell

$ImageParams = @{
    Name = 'my-container-app'
    Image = 'mcr.microsoft.com/k8se/quickstart:latest'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams
$EnvId = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).Id

$AppArgs = @{
    Name = 'my-container-app'
    Location = $Location
    ResourceGroupName = $ResourceGroupName
    ManagedEnvironmentId = $EnvId
    IdentityType = 'SystemAssigned'
    TemplateContainer = $TemplateObj
    IngressTargetPort = 80
    IngressExternal = $true

}
New-AzContainerApp @AppArgs

Megjegyzés

Győződjön meg arról, hogy a Image paraméter értéke kisbetűs.

Az IngressExternal$true értékre állításával elérhetővé teszi a tárolóalkalmazást a nyilvános kérések számára.

Az üzembe helyezés ellenőrzése

Bash

A create parancs visszaadja a tárolóalkalmazás teljes tartománynevét. Másolja ezt a helyet egy webböngészőbe.

PowerShell

Kérje le a konténeralkalmazás teljes domainnevét.

(Get-AzContainerApp -Name $AppArgs.Name -ResourceGroupName $ResourceGroupName).IngressFqdn

Másolja ezt a helyet egy webböngészőbe.

A tárolóalkalmazás üzembe helyezésekor a következő üzenet jelenik meg:

Erőforrások takarítása

Ha nem folytatja az alkalmazás használatát, futtassa az alábbi parancsot az erőforráscsoport és az oktatóanyagban létrehozott összes erőforrás törléséhez.

Figyelemfelhívás

Az alábbi parancs törli a megadott erőforráscsoportot és a benne lévő összes erőforrást. Ha az oktatóanyag hatókörén kívüli erőforrások szerepelnek a megadott erőforráscsoportban, akkor azok is törlődnek.

Bash

az group delete --name $RESOURCE_GROUP

PowerShell

Remove-AzResourceGroup -Name $ResourceGroupName -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

Mikroszolgáltatások közötti kommunikáció