Rövid útmutató: Dapr-alkalmazás üzembe helyezése az Azure Container Appsben az Azure CLI használatával

Az elosztott alkalmazás-futtatókörnyezet (Dapr) segít a fejlesztőknek rugalmas, megbízható mikroszolgáltatások létrehozásában. Ebben a gyorsútmutatóban megtudhatja, hogyan engedélyezheti a Dapr sidecarokat a mikroszolgáltatások konténeralkalmazásai mellett való futtatásra. A következőt fogja:

• Hozzon létre egy Container Apps-környezetet és egy Azure Blog Storage-állapottárolót a tárolóalkalmazásokhoz.
• Üzeneteket közzétevő Python-tárolóalkalmazás üzembe helyezése.
• Helyezzen üzembe egy Node.js tárolóalkalmazást, amely feliratkozik az üzenetekre, és egy állapottárolóban tárolja őket.
• Ellenőrizze a két mikroszolgáltatás közötti interakciót az Azure Portal használatával.

Ez a gyorsindító a nyílt forráskódú Dapr „Helló világ!” gyorsindítóban üzembe helyezett alkalmazásokat tükrözi.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Ha nem rendelkezik ilyen fiókkal, hozzon létre ingyenes fiókot.
• Egy GitHub-fiók. Ha nincs fiókja, ingyenesen regisztrálhat egyet.
• Telepítse az Azure CLI-t.
• Telepítse Git.

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

Állapottároló beállítása

Azure Blob Storage-fiók létrehozása

A környezet üzembe helyezésével helyezzen üzembe egy Azure Blob Storage-fiókot, amelyet a Node.js tárolóalkalmazás használ az adatok tárolására. A szolgáltatás üzembe helyezése előtt válasszon nevet a tárfióknak.

A tárfiókok nevének egyedinek kell lennie az Azure-ban, 3–24 karakter hosszúságúnak kell lennie, és csak számokat és kisbetűket kell tartalmaznia.

Bash

STORAGE_ACCOUNT_NAME="<storage-account-name>"

PowerShell

$StorageAcctName = '<storage-account-name>'

Az Azure Storage-fiók létrehozásához használja az alábbi parancsot.

Bash

az storage account create \
  --name $STORAGE_ACCOUNT_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --sku Standard_RAGRS \
  --kind StorageV2

PowerShell

Install-Module Az.Storage

$StorageAcctArgs = @{
    Name = $StorageAcctName
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    SkuName = 'Standard_RAGRS'
    Kind = 'StorageV2'
}

$StorageAccount = New-AzStorageAccount @StorageAcctArgs

Felhasználó által hozzárendelt identitás konfigurálása a csomópontalkalmazáshoz

Bár a Container Apps a felhasználó által hozzárendelt és a rendszer által hozzárendelt felügyelt identitást is támogatja, a felhasználó által hozzárendelt identitások hozzáférést biztosítanak a Dapr-kompatibilis Node.js alkalmazásnak a Blob Storage-fiókhoz való hozzáféréshez.

1. Hozzon létre egy felhasználó által hozzárendelt identitást.

   Bash

   az identity create --resource-group $RESOURCE_GROUP --name "nodeAppIdentity" --output json
   

   PowerShell

   Install-Module -Name AZ.ManagedServiceIdentity
   
   New-AzUserAssignedIdentity -ResourceGroupName $ResourceGroupName -Name 'nodeAppIdentity' -Location $Location
   

2. Kérje le a principalId tulajdonságokat, id és tárolja változókban.

   Bash

   PRINCIPAL_ID=$(az identity show -n "nodeAppIdentity" --resource-group $RESOURCE_GROUP --query principalId | tr -d \")
   IDENTITY_ID=$(az identity show -n "nodeAppIdentity" --resource-group $RESOURCE_GROUP --query id | tr -d \")
   CLIENT_ID=$(az identity show -n "nodeAppIdentity" --resource-group $RESOURCE_GROUP --query clientId | tr -d \")
   

   PowerShell

   $PrincipalId = (Get-AzUserAssignedIdentity -ResourceGroupName $ResourceGroupName -Name 'nodeAppIdentity').PrincipalId
   $IdentityId = (Get-AzUserAssignedIdentity -ResourceGroupName $ResourceGroupName -Name 'nodeAppIdentity').Id
   $ClientId = (Get-AzUserAssignedIdentity -ResourceGroupName $ResourceGroupName -Name 'nodeAppIdentity').ClientId
   

3. Kérje le az aktuális előfizetés előfizetés-azonosítóját.

   Bash

   SUBSCRIPTION_ID=$(az account show --query id --output tsv)
   

   PowerShell

   $SubscriptionId=$(Get-AzContext).Subscription.id
   

4. A felhasználó által hozzárendelt identitáshoz rendelje hozzá a Storage Blob Data Contributor szerepkört.

   Bash

   az role assignment create --assignee $PRINCIPAL_ID  \
   --role "Storage Blob Data Contributor" \
   --scope "subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Storage/storageAccounts/$STORAGE_ACCOUNT_NAME"
   

   PowerShell

   Install-Module Az.Resources
   
   New-AzRoleAssignment -ObjectId $PrincipalId -RoleDefinitionName 'Storage Blob Data Contributor' -Scope "/subscriptions/$SubscriptionId/resourceGroups/$ResourceGroupName/providers/Microsoft.Storage/storageAccounts/$StorageAcctName"
   

Az állapottároló összetevő konfigurálása

Bár több lehetősége is van a külső erőforrások Dapr-en keresztüli hitelesítésére. Ez a példa egy Azure-alapú állapottárolót használ, így közvetlen hozzáférést biztosíthat a Node.js alkalmazásból a Blob Store-ba felügyelt identitás használatával.

1. Egy szövegszerkesztőben hozzon létre egy statestore.yaml nevű fájlt az előző lépésekből származó tulajdonságokkal. Cserélje le a <placeholders> karakterláncot a saját értékeivel.

   # statestore.yaml for Azure Blob storage component
   componentType: state.azure.blobstorage
   version: v1
   metadata:
     - name: accountName
       value: "<storage-account-name>"
     - name: containerName
       value: mycontainer
     - name: azureClientId
       value: "<managed-identity-client-ID>"
   scopes:
     - nodeapp
   

   Ez a fájl lehetővé teszi a Dapr-alkalmazás számára az állapottároló elérését.

2. Lépjen arra a könyvtárra, amelyben a yaml-fájlt tárolta, és futtassa a következő parancsot a Dapr-összetevő konfigurálásához a Container Apps-környezetben.

   Bash

   az containerapp env dapr-component set \
       --name $CONTAINERAPPS_ENVIRONMENT --resource-group $RESOURCE_GROUP \
       --dapr-component-name statestore \
       --yaml statestore.yaml
   

   PowerShell

   $AcctName = New-AzContainerAppDaprMetadataObject -Name "accountName" -Value $StorageAcctName
   
   $ContainerName = New-AzContainerAppDaprMetadataObject -Name "containerName" -Value 'mycontainer'
   
   $ClientId = New-AzContainerAppDaprMetadataObject -Name "azureClientId" -Value $ClientId
   
   $DaprArgs = @{
       EnvName = $ContainerAppsEnvironment
       ResourceGroupName = $ResourceGroupName
       DaprName = 'statestore'
       Metadata = $AcctName, $ContainerName, $ClientId
       Scope = 'nodeapp'
       Version = 'v1'
       ComponentType = 'state.azure.blobstorage'
   }
   
   New-AzContainerAppManagedEnvDapr @DaprArgs
   

Az Node.js alkalmazás üzembe helyezése

Bash

az containerapp create \
  --name nodeapp \
  --resource-group $RESOURCE_GROUP \
  --user-assigned $IDENTITY_ID \
  --environment $CONTAINERAPPS_ENVIRONMENT \
  --image dapriosamples/hello-k8s-node:latest \
  --min-replicas 1 \
  --max-replicas 1 \
  --enable-dapr \
  --dapr-app-id nodeapp \
  --dapr-app-port 3000 \
  --env-vars 'APP_PORT=3000'

Ha Azure Container Registryt használ, vegye fel a --registry-server <registry-name>.azurecr.io jelölőt a parancsba.

PowerShell

$EnvId = (Get-AzContainerAppManagedEnv -ResourceGroupName $ResourceGroupName -EnvName $ContainerAppsEnvironment).Id

$EnvVars = New-AzContainerAppEnvironmentVarObject -Name APP_PORT -Value 3000

$TemplateArgs = @{
  Name = 'nodeapp'
  Image = 'dapriosamples/hello-k8s-node:latest'
  Env = $EnvVars
}

$ServiceTemplateObj = New-AzContainerAppTemplateObject @TemplateArgs

$ServiceArgs = @{
    Name = 'nodeapp'
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $ServiceTemplateObj
    ScaleMinReplica = 1
    ScaleMaxReplica = 1
    DaprEnabled = $true
    DaprAppId = 'nodeapp'
    DaprAppPort = 3000
    IdentityType = 'UserAssigned'
    IdentityUserAssignedIdentity = @{
        $IdentityId = @{}
    }
}

New-AzContainerApp @ServiceArgs

Ha Azure Container Registryt használ, vegye fel a RegistryServer = '<registry-name>.azurecr.io' jelölőt a parancsba.

Alapértelmezés szerint a képfájl a Docker Hubról kerül letöltésre.

A Python-alkalmazás üzembe helyezése

Bash

az containerapp create \
  --name pythonapp \
  --resource-group $RESOURCE_GROUP \
  --environment $CONTAINERAPPS_ENVIRONMENT \
  --image dapriosamples/hello-k8s-python:latest \
  --min-replicas 1 \
  --max-replicas 1 \
  --enable-dapr \
  --dapr-app-id pythonapp

Ha Azure Container Registryt használ, vegye fel a --registry-server <registry-name>.azurecr.io jelölőt a parancsba.

PowerShell

$TemplateArgs = @{
  Name = 'pythonapp'
  Image = 'dapriosamples/hello-k8s-python:latest'
}

$ClientTemplateObj = New-AzContainerAppTemplateObject @TemplateArgs

$ClientArgs = @{
    Name = 'pythonapp'
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $ClientTemplateObj
    ScaleMinReplica = 1
    ScaleMaxReplica = 1
    DaprEnabled = $true
    DaprAppId = 'pythonapp'
}

New-AzContainerApp @ClientArgs

Ha Azure Container Registryt használ, vegye fel a RegistryServer = '<registry-name>.azurecr.io' jelölőt a parancsba.

Az eredmények ellenőrzése

Az állapot sikeres megőrzésének megerősítése

Az Azure Storage-fiók adatainak megtekintésével ellenőrizheti, hogy a szolgáltatások megfelelően működnek-e.

1. Nyissa meg az Azure Portalt a böngészőben, és keresse meg a tárfiókot.

2. Az oldalsáv menüjében válassza az Adattárolók> lehetőséget.

3. Válassza ki a tárolóalkalmazást.

4. Ellenőrizze, hogy látható-e a tárolóban elnevezett order fájl.

5. Válassza ki a fájlt.

6. Válassza a Szerkesztés lapot.

7. A Frissítés gombra kattintva megfigyelheti, hogyan frissülnek automatikusan az adatok.

Naplók megtekintése

A tárolóalkalmazásokból származó naplók a ContainerAppConsoleLogs_CL Log Analytics-munkaterület egyéni táblájában vannak tárolva. A naplókat az Azure Portalon vagy a parancssori felületen tekintheti meg. Előfordulhat, hogy a tábla kezdetben kis késéssel jelenik meg a munkaterületen.

A naplók megtekintéséhez használja a parancssort a következő CLI-paranccsal.

Bash

LOG_ANALYTICS_WORKSPACE_CLIENT_ID=`az containerapp env show --name $CONTAINERAPPS_ENVIRONMENT --resource-group $RESOURCE_GROUP --query properties.appLogsConfiguration.logAnalyticsConfiguration.customerId --out tsv`

az monitor log-analytics query \
  --workspace $LOG_ANALYTICS_WORKSPACE_CLIENT_ID \
  --analytics-query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == 'nodeapp' and (Log_s contains 'persisted' or Log_s contains 'order') | project ContainerAppName_s, Log_s, TimeGenerated | sort by TimeGenerated | take 5" \
  --out table

PowerShell

$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId $WorkspaceId -Query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == 'nodeapp' and (Log_s contains 'persisted' or Log_s contains 'order') | project ContainerAppName_s, Log_s, TimeGenerated | take 5 "

$queryResults.Results

Az alábbi kimenet bemutatja a parancssori felületi parancstól elvárható válasz típusát.

ContainerAppName_s    Log_s                            TableName      TimeGenerated
--------------------  -------------------------------  -------------  ------------------------
nodeapp               Got a new order! Order ID: 61    PrimaryResult  2021-10-22T21:31:46.184Z
nodeapp               Successfully persisted state.    PrimaryResult  2021-10-22T21:31:46.184Z
nodeapp               Got a new order! Order ID: 62    PrimaryResult  2021-10-22T22:01:57.174Z
nodeapp               Successfully persisted state.    PrimaryResult  2021-10-22T22:01:57.174Z
nodeapp               Got a new order! Order ID: 63    PrimaryResult  2021-10-22T22:45:44.618Z

Erőforrások takarítása

Mivel a pythonapp folyamatosan hívásokat kezdeményez a nodeapp felé olyan üzenetekkel, amelyek az Ön által konfigurált állapottárolóban rögzítődnek, fontos elvégezni ezeket a tisztítási lépéseket a további számlázható műveletek elkerülése érdekében.

Ha törölni szeretné az útmutató részeként létrehozott erőforrásokat, futtassa a következő parancsot.

Figyelemfelhívás

Ez a 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 --resource-group $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és

Tudnivalók az Azure Container Apps Dapr-összetevőiről