Mulai cepat: Menyebarkan aplikasi Dapr ke Azure Container Apps menggunakan Azure CLI

Artikel
02/25/2025

Dapr (Distributed Application Runtime) membantu pengembang membangun layanan mikro yang tangguh dan andal. Dalam mulai cepat ini, Anda mempelajari cara mengaktifkan sidecar Dapr untuk berjalan bersama aplikasi kontainer layanan mikro Anda. Anda akan:

Buat lingkungan Aplikasi Kontainer dan penyimpanan status Azure Blog Storage untuk aplikasi kontainer Anda.
Sebarkan aplikasi kontainer Python yang menerbitkan pesan.
Sebarkan aplikasi kontainer Node.js yang berlangganan pesan dan mempertahankannya di penyimpanan status.
Verifikasi interaksi antara dua layanan mikro menggunakan portal Azure.

Diagram arsitektur untuk layanan mikro Dapr Hello World di Azure Container Apps

Mulai cepat ini mencerminkan aplikasi yang Anda sebarkan di mulai cepat Dapr sumber terbuka Halo Dunia.

Siapkan

Untuk masuk ke Azure dari CLI, jalankan perintah berikut dan ikuti perintah untuk menyelesaikan proses autentikasi.

Bash
PowerShell

az login

Connect-AzAccount

Untuk memastikan Anda menjalankan CLI versi terbaru, jalankan perintah peningkatan.

Bash
PowerShell

az upgrade

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

Abaikan peringatan apa pun tentang modul yang saat ini digunakan.

Selanjutnya, instal atau perbarui ekstensi Azure Container Apps untuk CLI.

Jika Anda menerima kesalahan tentang parameter yang hilang saat menjalankan az containerapp perintah di Azure CLI atau cmdlet dari Az.App modul di PowerShell, pastikan Anda memiliki versi terbaru ekstensi Azure Container Apps yang diinstal.

Bash
PowerShell

az extension add --name containerapp --upgrade

Catatan

Mulai Mei 2024, ekstensi Azure CLI tidak lagi mengaktifkan fitur pratinjau secara default. Untuk mengakses fitur pratinjau Container Apps, instal ekstensi Container Apps dengan --allow-preview true.

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

Install-Module -Name Az.App

Pastikan untuk memperbarui Az.App modul ke versi terbaru.

Update-Module -Name Az.App

Sekarang setelah ekstensi atau modul saat ini diinstal, daftarkan Microsoft.App namespace layanan dan Microsoft.OperationalInsights .

Bash
PowerShell

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Atur variabel lingkungan

Atur variabel lingkungan berikut. <PLACEHOLDERS> Ganti dengan nilai Anda:

Bash
PowerShell

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

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

Membuat Grup Sumber Daya Azure

Buat grup sumber daya untuk mengatur layanan yang terkait dengan penyebaran aplikasi kontainer Anda.

Bash
PowerShell

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

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Membuat lingkungan

Lingkungan di Aplikasi Kontainer Azure menciptakan batas aman di sekitar sekelompok aplikasi kontainer. Aplikasi Kontainer yang disebarkan ke lingkungan yang sama disebarkan di jaringan virtual yang sama dan menulis log ke ruang kerja Log Analytics yang sama.

Untuk membuat lingkungan, jalankan perintah berikut:

Bash
PowerShell

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

Ruang kerja Analitik Log diperlukan untuk lingkungan Aplikasi Kontainer. Perintah berikut membuat ruang kerja Analitik Log dan menyimpan ID ruang kerja dan kunci bersama utama ke variabel lingkungan.

$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

Untuk membuat lingkungan, jalankan perintah berikut:

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

New-AzContainerAppManagedEnv @EnvArgs

Menyiapkan penyimpanan status

Membuat akun Azure Blob Storage

Dengan lingkungan yang disebarkan, sebarkan akun Azure Blob Storage yang digunakan oleh aplikasi kontainer Node.js untuk menyimpan data. Sebelum menyebarkan layanan, pilih nama untuk akun penyimpanan. Nama akun penyimpanan harus unik dalam Azure dan panjangnya antara 3 hingga 24 karakter dan harus hanya boleh berisi angka dan huruf kecil.

Bash
PowerShell

STORAGE_ACCOUNT_NAME="<storage account name>"

$StorageAcctName = '<storage account name>'

Gunakan perintah berikut untuk membuat akun Azure Storage.

Bash
PowerShell

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

Install-Module Az.Storage

$StorageAcctArgs = @{
    Name = $StorageAcctName
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    SkuName = 'Standard_RAGRS'
    Kind = 'StorageV2'
}
$StorageAccount = New-AzStorageAccount @StorageAcctArgs

Mengonfigurasi identitas yang ditetapkan pengguna untuk aplikasi simpul

Meskipun Container Apps mendukung identitas terkelola yang ditetapkan pengguna dan ditetapkan sistem, identitas yang ditetapkan pengguna menyediakan izin untuk mengakses akun penyimpanan blob dengan dukungan Dap Node.js r.

Membuat identitas yang ditetapkan pengguna.

Bash
PowerShell

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

Install-Module -Name AZ.ManagedServiceIdentity

New-AzUserAssignedIdentity -ResourceGroupName $ResourceGroupName -Name     'nodeAppIdentity' -Location $Location

principalId Ambil properti dan id dan simpan dalam variabel.

Bash
PowerShell

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 \")

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

Ambil ID langganan untuk langganan Anda saat ini.

Bash
PowerShell

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

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

Tetapkan Storage Blob Data Contributor peran ke identitas yang ditetapkan pengguna.

Bash
PowerShell

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"

Install-Module Az.Resources

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

Konfigurasikan komponen penyimpanan status

Meskipun Anda memiliki beberapa opsi untuk mengautentikasi ke sumber daya eksternal melalui Dapr. Contoh ini menggunakan penyimpanan status berbasis Azure, sehingga Anda dapat menyediakan akses langsung dari aplikasi Node.js ke penyimpanan Blob menggunakan Identitas Terkelola.

Di editor teks, buat file bernama statestore.yaml dengan properti yang Anda sumber dari langkah sebelumnya.

# 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

File ini membantu mengaktifkan aplikasi Dapr Anda untuk mengakses penyimpanan status Anda.

Navigasikan ke direktori tempat Anda menyimpan file yaml dan jalankan perintah berikut untuk mengonfigurasi komponen Dapr di lingkungan Container Apps.

Bash
PowerShell

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


$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 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'

Jika Anda menggunakan Azure Container Registry, sertakan --registry-server <REGISTRY_NAME>.azurecr.io bendera dalam perintah .

$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

Jika Anda menggunakan Azure Container Registry, sertakan RegistryServer = '<REGISTRY_NAME>.azurecr.io' bendera dalam perintah .

Secara default, gambar ditarik dari Docker Hub.

Menyebarkan aplikasi Python

Bash
PowerShell

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

Jika Anda menggunakan Azure Container Registry, sertakan --registry-server <REGISTRY_NAME>.azurecr.io bendera dalam perintah .


$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

Jika Anda menggunakan Azure Container Registry, sertakan RegistryServer = '<REGISTRY_NAME>.azurecr.io' bendera dalam perintah .

Memverifikasi hasil

Konfirmasikan persistensi status yang berhasil

Anda dapat mengonfirmasi bahwa layanan berfungsi dengan benar dengan melihat data di akun Microsoft Azure Storage Anda.

Buka portal Microsoft Azure di browser Anda dan navigasikan ke akun penyimpanan Anda.
Pilih Kontainer Penyimpanan>Data di menu sisi kiri.
Pilih aplikasi kontainer.
Verifikasi bahwa Anda dapat melihat file bernama order dalam kontainer.
Pilih file.
Pilih tab Edit.
Pilih tombol Refresh untuk melihat bagaimana data diperbarui secara otomatis.

Menampilkan log

Log dari aplikasi kontainer disimpan dalam ContainerAppConsoleLogs_CL tabel kustom di ruang kerja Analitik Log. Anda dapat melihat log melalui portal Azure atau melalui CLI. Mungkin ada penundaan kecil pada awalnya agar tabel muncul di ruang kerja.

Lihat log menggunakan baris perintah menggunakan perintah CLI berikut.

Bash
PowerShell

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


$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

Output berikut menunjukkan jenis respons yang diharapkan dari perintah CLI.

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

Membersihkan sumber daya

Karena pythonapp terus-menerus melakukan panggilan ke nodeapp dengan pesan yang disimpan ke penyimpanan status Anda yang dikonfigurasi, penting untuk menyelesaikan langkah penghapusan ini untuk menghindari operasi yang sedang berlangsung yang dapat ditagih.

Jika Anda ingin menghapus sumber daya yang dibuat sebagai bagian dari panduan ini, jalankan perintah berikut.

Perhatian

Perintah ini menghapus grup sumber daya yang ditentukan dan semua sumber daya yang terkandung di dalamnya. Jika sumber daya di luar lingkup artikel ini ada di grup sumber daya yang ditentukan, sumber daya tersebut juga akan dihapus.

Bash
PowerShell

az group delete --resource-group $RESOURCE_GROUP

Remove-AzResourceGroup -Name $ResourceGroupName -Force

Tip

Mengalami masalah? Beri tahu kami di GitHub dengan membuka masalah di repositori Azure Container Apps.

Langkah berikutnya

Pelajari selengkapnya tentang komponen Dapr di Azure Container Apps

Bagikan melalui