Guida introduttiva: Distribuire un'applicazione Dapr in App Azure Container con un modello di Azure Resource Manager o Bicep

Dapr (Distributed Application Runtime) consente agli sviluppatori di creare microservizi resilienti e affidabili. In questa guida introduttiva si abilitano i sidecar Dapr per l'esecuzione insieme a due app contenitore che producono e usano messaggi archiviati in un archivio stati Archiviazione BLOB di Azure. Usando i modelli di Azure Resource Manager o Bicep, è possibile:

• Passare i comandi dell'interfaccia della riga di comando di Azure per distribuire un modello che avvia tutto ciò che è necessario eseguire i microservizi.
• Verificare l'interazione tra i due microservizi nel portale di Azure.

Questa guida introduttiva rispecchia le applicazioni distribuite nell'argomento di avvio rapido di Dapr Hello World open source.

Prerequisiti

• Installare l' interfaccia della riga di comando di Azure
• Installare Git

• Bicep

• È richiesto un account Azure con una sottoscrizione attiva. Se non è già disponibile, è possibile creare un account gratuitamente.
• Un account GitHub. Se non si dispone già di uno, iscriversi per ottenere una versione di valutazione gratuita.

Attrezzaggio

Per accedere ad Azure dall'interfaccia della riga di comando, eseguire il comando seguente e seguire le istruzioni per completare il processo di autenticazione.

Bash

az login

Azure PowerShell

Connect-AzAccount

Assicurarsi di eseguire l'ultima versione dell'interfaccia della riga di comando eseguire il comando di aggiornamento.

Bash

az upgrade

Azure PowerShell

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

Ignorare eventuali avvisi sui moduli attualmente in uso.

Installare o aggiornare quindi l'estensione App contenitore di Azure per l'interfaccia della riga di comando.

Se si ricevono errori relativi ai parametri mancanti quando si eseguono comandi az containerapp nell'interfaccia della riga di comando di Azure o nei cmdlet del modulo Az.App in Azure PowerShell, assicurarsi di avere installato la versione più recente dell'estensione App contenitore di Azure.

Bash

az extension add --name containerapp --upgrade

Nota

A partire da maggio 2024, le estensioni dell'interfaccia della riga di comando di Azure non abilitano più le funzionalità di anteprima per impostazione predefinita. Per accedere alle funzionalità di anteprima di App contenitore, installare l'estensione App contenitore con --allow-preview true.

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

Azure PowerShell

Install-Module -Name Az.App

Assicurarsi di aggiornare il modulo Az.App alla versione più recente.

Update-Module -Name Az.App

Ora che l'estensione o il modulo corrente è installato, registrare gli spazi dei nomi Microsoft.App e Microsoft.OperationalInsights.

Bash

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Impostare le variabili di ambiente

Impostare le variabili di ambiente seguenti. Sostituire con i <PLACEHOLDERS> valori:

Bash

RESOURCE_GROUP="<RESOURCE_GROUP>"
LOCATION="<LOCATION>"
CONTAINERAPPS_ENVIRONMENT="<CONTAINERAPPS_ENVIRONMENT>"

Azure PowerShell

$ResourceGroupName = '<RESOURCE_GROUP>'
$Location = '<LOCATION>'
$ContainerAppsEnvironment = '<CONTAINERAPPS_ENVIRONMENT>'

Creare un gruppo di risorse di Azure

Creare un gruppo di risorse per organizzare i servizi correlati alla distribuzione dell'app contenitore.

Bash

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Preparare il repository GitHub

Passare al repository che contiene i modelli ARM e Bicep usati per distribuire la soluzione.

Selezionare il pulsante Fork nella parte superiore del repository per creare una copia tramite fork del repository nell'account.

È ora possibile clonare il fork per usarlo in locale.

Usare il comando git seguente per clonare il repository con fork nella directory acadapr-templates.

git clone https://github.com/$GITHUB_USERNAME/Tutorial-Deploy-Dapr-Microservices-ACA.git acadapr-templates

Distribuzione

Passare alla directory acadapr-templates ed eseguire il comando seguente:

Bash

az deployment group create \
  --resource-group "$RESOURCE_GROUP" \
  --template-file ./azuredeploy.json \
  --parameters environment_name="$CONTAINERAPPS_ENVIRONMENT"

Azure PowerShell

$params = @{
  environment_name = $ContainerAppsEnvironment

}

New-AzResourceGroupDeployment `
  -ResourceGroupName $ResourceGroupName `
  -TemplateParameterObject $params `
  -TemplateFile ./azuredeploy.json `
  -SkipTemplateParameterPrompt

Potrebbe essere visualizzato un avviso (BCP081). Questo avviso non ha alcun effetto sulla corretta distribuzione dell'applicazione.

Bash

az deployment group create \
  --resource-group "$RESOURCE_GROUP" \
  --template-file ./azuredeploy.bicep \
  --parameters environment_name="$CONTAINERAPPS_ENVIRONMENT"

Azure PowerShell

$params = @{
  environment_name = $ContainerAppsEnvironment

}

New-AzResourceGroupDeployment `
  -ResourceGroupName $ResourceGroupName `
  -TemplateParameterObject $params `
  -TemplateFile ./azuredeploy.bicep `
  -SkipTemplateParameterPrompt

---

Questo comando distribuisce:

• L'ambiente App contenitore e l'area di lavoro Log Analytics associata per l'hosting della soluzione Dapr hello world.
• Istanza di Application Insights per la traccia distribuita dapr.
• Il nodeapp server app in esecuzione con targetPort: 3000 Dapr abilitato e configurato usando:
  • "appId": "nodeapp"
  • "appPort": 3000
  • Identità assegnata dall'utente con accesso all'archiviazione BLOB di Azure tramite un'assegnazione di ruolo Collaboratore ai dati di archiviazione
• Componente Dapr con "type": "state.azure.blobstorage" ambito utilizzato da per l'archiviazione nodeapp dello stato.
• Dapr-enabled, headless pythonapp che richiama il nodeapp servizio usando la chiamata al servizio Dapr.
• Assegnazione di ruolo ID Entra Microsoft per l'app Node.js usata dal componente Dapr per stabilire una connessione all'archiviazione BLOB.

Verificare il risultato

Conferma l'avvenuta persistenza dello stato

È possibile verificare che i servizi funzionino correttamente visualizzando i dati nell'account di Archiviazione di Azure.

1. Aprire il portale di Azure nel browser.

2. Passare all'account di archiviazione appena creato nel gruppo di risorse.

3. Selezionare Contenitori di archiviazione dati>dal menu a sinistra.

4. Selezionare il contenitore creato.

5. Verificare che sia possibile visualizzare il file denominato order nel contenitore.

6. Selezionare il file .

7. Selezionare la scheda Modifica.

8. Selezionare il pulsante Aggiorna per osservare gli aggiornamenti.

Visualizza registri

I log delle app contenitore vengono archiviati nella tabella personalizzata ContainerAppConsoleLogs_CL nell'area di lavoro Log Analytics. È possibile visualizzare i log tramite il portale di Azure o tramite l'interfaccia della riga di comando. Inizialmente potrebbe verificarsi un piccolo ritardo per visualizzare la tabella nell'area di lavoro.

Usare il comando seguente per visualizzare i log in bash o PowerShell.

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 | take 5" \
  --out table

Azure PowerShell

$WorkspaceId = (Get-AzContainerAppManagedEnv -ResourceGroupName $ResourceGroupName -EnvName $ContainerAppsEnvironment).LogAnalyticConfigurationCustomerId

$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

L'output seguente illustra il tipo di risposta previsto dal comando.

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

Pulire le risorse

Poiché pythonapp effettua continuamente chiamate a nodeapp con messaggi che vengono salvati in modo permanente nell'archivio stati configurato, è importante completare questi passaggi di pulizia per evitare operazioni fatturabili in corso.

Per eliminare le risorse create come parte di questa procedura dettagliata, eseguire il comando seguente.

Bash

az group delete \
  --resource-group $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $RESOURCE_GROUP -Force

Suggerimento

Problemi? Segnalare i problemi su GitHub aprendo un ticket nel repository App contenitore di Azure.

Passaggi successivi

Altre informazioni sui componenti dapr in App Azure Container