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

Distributed Application Runtime (Dapr) membantu pengembang membangun layanan mikro yang tangguh dan andal. Dalam panduan cepat ini, Anda mempelajari cara mengaktifkan sidecar Dapr untuk berjalan bersama aplikasi kontainer mikroservis 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.

Panduan memulai cepat ini mencerminkan aplikasi yang Anda sebarkan dalam panduan memulai cepat Dapr sumber terbuka Hello World.

Prasyarat

• Sebuah akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun secara gratis.
• Akun GitHub. Jika Anda tidak memilikinya, daftar secara gratis.
• Instal Azure CLI.
• Pasang Git.

Siapkan

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

Bash

az login

PowerShell

Connect-AzAccount

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

Bash

az upgrade

PowerShell

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 commands di Azure CLI atau cmdlet dari modul Az.App di PowerShell, pastikan Anda telah menginstal versi terbaru dari ekstensi Azure Container Apps.

Bash

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

PowerShell

Install-Module -Name Az.App

Pastikan untuk memperbarui Az.App modul ke versi terbaru.

Update-Module -Name Az.App

Sekarang setelah ekstensi atau modul yang sedang digunakan diinstal, daftarkan namespace Microsoft.App dan Microsoft.OperationalInsights.

Bash

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Atur variabel lingkungan

Atur variabel lingkungan berikut. <placeholders> Ganti dengan nilai Anda.

Bash

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

PowerShell

$ResourceGroupName = '<new-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

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

PowerShell

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

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

PowerShell

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

STORAGE_ACCOUNT_NAME="<storage-account-name>"

PowerShell

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

Gunakan perintah berikut untuk membuat akun Azure Storage.

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

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 aplikasi Node.js yang mendukung Dapr dengan izin untuk mengakses akun penyimpanan blob.

1. Membuat identitas yang ditetapkan pengguna.

   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. Ambil properti principalId dan id, lalu simpan dalam variabel.

   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. Ambil ID langganan untuk langganan Anda saat ini.

   Bash

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

   PowerShell

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

4. Tetapkan Storage Blob Data Contributor peran untuk identitas yang ditetapkan pengguna.

   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"
   

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.

1. Di editor teks, buat file bernama statestore.yaml dengan properti yang Anda sumber dari langkah sebelumnya. <placeholders> Ganti dengan nilai Anda.

   # 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.

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

   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
   

Menyebarkan aplikasi Node.js

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'

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

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

Jika Anda menggunakan Azure Container Registry, sertakan RegistryServer = '<registry-name>.azurecr.io' flag dalam perintah.

Secara default, gambar ditarik dari Docker Hub.

Menyebarkan aplikasi Python

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

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

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

Jika Anda menggunakan Azure Container Registry, sertakan RegistryServer = '<registry-name>.azurecr.io' flag 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.

1. Buka portal Microsoft Azure di browser Anda dan navigasikan ke akun penyimpanan Anda.

2. Pilih Penyimpanan Data>Kontainer di menu bilah samping.

3. Pilih aplikasi kontainer.

4. Verifikasi bahwa Anda dapat melihat file bernama order dalam kontainer.

5. Pilih file.

6. Pilih tab Edit.

7. Pilih tombol Refresh untuk melihat bagaimana data diperbarui secara otomatis.

Lihat 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

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

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 melakukan panggilan ke nodeapp dengan pesan yang dipertahankan di penyimpanan status yang dikonfigurasi, penting untuk menyelesaikan langkah-langkah pembersihan ini untuk menghindari operasi berbiaya yang terus terjadi.

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 ada sumber daya di luar lingkup tutorial ini yang terdapat dalam grup sumber daya yang ditentukan, mereka juga akan dihapus.

Bash

az group delete --resource-group $RESOURCE_GROUP

PowerShell

Remove-AzResourceGroup -Name $ResourceGroupName -Force

Petunjuk

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

Langkah selanjutnya

Pelajari tentang komponen Dapr di Azure Container Apps