Instal ekstensi Dapr untuk Azure Kubernetes Service (AKS) dan Kubernetes dengan dukungan Arc

Dapr menyederhanakan pembangunan aplikasi tangguh, tanpa status, dan stateful yang berjalan di cloud dan tepi dan merangkul keragaman bahasa dan kerangka kerja pengembang. Dengan arsitektur sespan Dapr, Anda dapat menjaga platform kode Anda tetap agnostik sambil mengatasi tantangan dalam membangun layanan mikro, seperti:

• Memanggil layanan lain dengan andal dan aman
• Membangun aplikasi berbasis peristiwa dengan pub/sub
• Membangun aplikasi yang portabel di beberapa layanan dan host cloud (misalnya, Kubernetes vs. komputer virtual)

Catatan

Jika Anda berencana menginstal Dapr di lingkungan produksi Kubernetes, lihat halaman dokumentasi Panduan Dapr untuk penggunaan produksi.

Cara kerjanya

Ekstensi Dapr menggunakan Azure CLI atau templat Bicep untuk menyediakan sarana kontrol Dapr pada kluster Kubernetes dengan dukungan AKS atau Arc, membuat layanan Dapr berikut:

Layanan Dapr	Deskripsi
dapr-operator	Mengelola pembaruan komponen dan titik akhir layanan Kubernetes untuk Dapr (penyimpanan status, pub/sub, dll.)
dapr-sidecar-injector	Menyuntikkan Dapr ke dalam pod penyebaran yang dianotasi dan menambahkan variabel DAPR_HTTP_PORT lingkungan dan DAPR_GRPC_PORT untuk memungkinkan aplikasi yang ditentukan pengguna untuk berkomunikasi dengan mudah dengan Dapr tanpa mengkodekan nilai port Dapr secara hard-coding.
dapr-placement	Digunakan hanya untuk aktor. Membuat tabel pemetaan yang memetakan instans aktor ke pod.
dapr-sentry	Mengelola mTLS antara layanan dan bertindak sebagai otoritas sertifikat. Untuk informasi selengkapnya, baca gambaran umum keamanan.

Setelah Dapr diinstal di kluster, Anda dapat mulai mengembangkan menggunakan API blok penyusun Dapr dengan menambahkan beberapa anotasi ke penyebaran Anda. Untuk gambaran umum yang lebih mendalam tentang API blok pembangun dan cara terbaik untuk menggunakannya, lihat Gambaran umum blok pembangun Dapr.

Peringatan

Jika Anda menginstal Dapr melalui ekstensi Kubernetes AKS atau Arc-enabled, rekomendasi kami adalah terus menggunakan ekstensi untuk pengelolaan Dapr di masa mendatang, bukan Dapr CLI. Menggabungkan kedua alat dapat menyebabkan konflik dan mengakibatkan perilaku yang tidak diinginkan.

Prasyarat

• Langganan Azure. Tidak punya satu? Buat akun gratis.
• Versi terbaru dari Azure CLI.
• Kluster AKS yang ada atau kluster Kubernetes yang didukung Arc yang terhubung.
• Peran Admin Kontrol Akses Berbasis Peran Azure Kubernetes Service

Pilih bagaimana Anda ingin menginstal, menyebarkan, dan mengonfigurasi ekstensi Dapr.

Azure CLI

Sebelum Anda mulai

Menambahkan ekstensi Azure CLI untuk ekstensi kluster

k8s-extension Instal ekstensi Azure CLI dengan menjalankan perintah berikut:

az extension add --name k8s-extension

Jika ekstensi k8s-extension sudah diinstal, Anda dapat memperbaruinya ke versi terbaru menggunakan perintah berikut:

az extension update --name k8s-extension

Mendaftarkan KubernetesConfiguration penyedia sumber daya

Jika Anda belum menggunakan ekstensi kluster, Anda mungkin perlu mendaftarkan penyedia sumber daya dengan langganan Anda. Anda dapat memeriksa status pendaftaran penyedia menggunakan perintah az provider list , seperti yang ditunjukkan dalam contoh berikut:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Penyedia Microsoft.KubernetesConfiguration harus dalam status Terdaftar, seperti yang ditunjukkan dalam contoh output berikut:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Jika penyedia menunjukkan sebagai TidakTerdaftar, daftarkan penyedia menggunakan register penyedia az seperti yang ditunjukkan dalam contoh berikut:

az provider register --namespace Microsoft.KubernetesConfiguration

Mendaftarkan fitur ke ExtenstionTypes langganan Azure Anda

Fitur ExtensionTypes ini perlu didaftarkan ke langganan Azure Anda. Di terminal, verifikasi bahwa Anda berada dalam langganan yang benar:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Daftarkan ExtenstionTypes fitur.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Pendaftaran fitur mungkin memakan waktu. Setelah beberapa menit, periksa status pendaftaran menggunakan perintah berikut:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Buat ekstensi dan instal Dapr di kluster Kubernetes AKS atau Arc-enabled Anda

Saat menginstal ekstensi Dapr, gunakan nilai bendera yang sesuai dengan jenis kluster Anda:

• Kluster AKS: --cluster-type managedClusters.
• Kluster Kubernetes yang mendukung Arc: --cluster-type connectedClusters.

Catatan

Jika Anda menggunakan Dapr OSS di kluster AKS dan ingin menginstal ekstensi Dapr untuk AKS, baca selengkapnya Cara agar berhasil bermigrasi ke ekstensi Dapr.

Buat ekstensi Dapr, yang menginstal Dapr pada kluster Kubernetes yang didukung AKS atau Arc.

Misalnya, instal dapr versi terbaru melalui ekstensi Dapr pada kluster AKS Anda:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false

Menjaga kluster AKS terkelola Anda tetap diperbarui ke versi terbaru

Berdasarkan lingkungan Anda (dev, test, atau production), Anda dapat terus memperbarui versi Dapr stabil terbaru.

Memilih kereta rilis

Saat mengonfigurasi ekstensi, Anda dapat memilih untuk menginstal Dapr dari kereta rilis tertentu. Tentukan salah satu dari dua nilai pelatihan rilis:

Nilai	Deskripsi
stable	Default.
dev	Rilis awal yang dapat berisi fitur eksperimental. Tidak cocok untuk produksi.

Contohnya:

--release-train stable

Mengonfigurasi pembaruan otomatis ke sarana kontrol Dapr

Peringatan

Peningkatan otomatis tidak cocok untuk lingkungan produksi. Hanya aktifkan pembaruan otomatis ke sarana kontrol Dapr di lingkungan pengembangan atau pengujian. Pelajari cara meningkatkan secara manual ke versi Dapr terbaru untuk lingkungan produksi.

Jika Anda menginstal Dapr tanpa menentukan versi, --auto-upgrade-minor-version diaktifkan secara otomatis, mengonfigurasi sarana kontrol Dapr untuk memperbarui versi minornya secara otomatis pada rilis baru.

Anda dapat menonaktifkan pembaruan otomatis dengan menentukan --auto-upgrade-minor-version parameter dan mengatur nilai ke false.

Penerapan versi Dapr dalam MAJOR.MINOR.PATCH format, yang berarti 1.12.0 1.11.0 adalah peningkatan versi minor.

--auto-upgrade-minor-version true

Menampilkan versi Dapr stabil terbaru yang tersedia

Untuk meningkatkan ke versi Dapr terbaru di lingkungan produksi, Anda perlu meningkatkan secara manual. Mulailah dengan melihat daftar versi Dapr stabil yang tersedia untuk kluster AKS terkelola Anda. Jalankan perintah berikut:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

Untuk melihat versi Dapr stabil terbaru yang tersedia untuk kluster AKS terkelola Anda, jalankan perintah berikut:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

Untuk melihat daftar versi Dapr stabil yang tersedia berdasarkan lokasi:

1. Pastikan Anda telah mendaftarkan fitur ke ExtenstionTypes langganan Azure Anda.
2. Jalankan perintah berikut.

az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr

Selanjutnya, perbarui Dapr secara manual ke versi stabil terbaru.

Menargetkan versi Dapr tertentu

Catatan

Dapr didukung dengan jendela bergulir, termasuk hanya versi saat ini dan sebelumnya. Merupakan tanggung jawab tim operasional Anda untuk tetap mengikuti perkembangan versi yang didukung ini. Jika Anda memiliki versi Dapr yang lebih lama, Anda mungkin harus melakukan peningkatan menengah untuk mendapatkan versi yang didukung.

Argumen baris perintah yang sama digunakan untuk menginstal versi Dapr tertentu atau mengembalikan ke versi sebelumnya. Atur --auto-upgrade-minor-version ke false dan --version ke versi Dapr yang ingin Anda instal. Jika parameter dihilangkan version , ekstensi menginstal dapr versi terbaru. Misalnya, untuk menggunakan Dapr 1.13.5:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.13.5

Bicep

Sebelum Anda mulai

Mendaftarkan KubernetesConfiguration penyedia sumber daya

Jika Anda belum menggunakan ekstensi kluster, Anda mungkin perlu mendaftarkan penyedia sumber daya dengan langganan Anda. Anda dapat memeriksa status pendaftaran penyedia menggunakan perintah az provider list , seperti yang ditunjukkan dalam contoh berikut:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Penyedia Microsoft.KubernetesConfiguration harus dalam status Terdaftar, seperti yang ditunjukkan dalam contoh output berikut:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Jika penyedia menunjukkan sebagai TidakTerdaftar, daftarkan penyedia menggunakan register penyedia az seperti yang ditunjukkan dalam contoh berikut:

az provider register --namespace Microsoft.KubernetesConfiguration

Mendaftarkan fitur ke ExtenstionTypes langganan Azure Anda

Fitur ExtensionTypes ini perlu didaftarkan ke langganan Azure Anda. Di terminal, verifikasi bahwa Anda berada dalam langganan yang benar:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Daftarkan ExtenstionTypes fitur.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Pendaftaran fitur mungkin memakan waktu. Setelah beberapa menit, periksa status pendaftaran menggunakan perintah berikut:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Sebarkan ekstensi Dapr pada kluster Kubernetes yang didukung AKS atau Arc

Buat templat Bicep yang mirip dengan contoh berikut dan sebarkan ekstensi Dapr ke kluster yang ada.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedClusters 'Microsoft.ContainerService/managedClusters@2023-05-02-preview' existing = {
  name: clusterName
}

resource daprExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'dapr'
  scope: existingManagedClusters
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    autoUpgradeMinorVersion: true
    configurationProtectedSettings: {}
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.dapr'
    releaseTrain: 'stable'
    scope: {
      cluster: {
        releaseNamespace: 'dapr-system'
      }
    }
    version: '1.11.2'
  }
}

Atur variabel berikut, ubah nilai berikut ke grup sumber daya aktual dan nama kluster Anda.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Sebarkan templat Bicep menggunakan az deployment group perintah .

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

Mengonfigurasi pembaruan otomatis ke sarana kontrol Dapr

Peringatan

Anda dapat mengaktifkan pembaruan otomatis ke sarana kontrol Dapr hanya di lingkungan pengembangan atau pengujian. Peningkatan otomatis tidak cocok untuk lingkungan produksi.

Jika Anda menyebarkan Dapr tanpa menentukan versi, autoUpgradeMinorVersion diaktifkan secara otomatis, mengonfigurasi sarana kontrol Dapr untuk memperbarui versi minornya secara otomatis pada rilis baru.

Anda dapat menonaktifkan pembaruan otomatis dengan menentukan autoUpgradeMinorVersion parameter dan mengatur nilai ke false.

Penerapan versi Dapr dalam MAJOR.MINOR.PATCH format, yang berarti 1.12.0 1.11.0 adalah peningkatan versi minor.

properties {
  autoUpgradeMinorVersion: true
}

Menargetkan versi Dapr tertentu

Catatan

Dapr didukung dengan jendela bergulir, termasuk hanya versi saat ini dan sebelumnya. Merupakan tanggung jawab tim operasional Anda untuk tetap mengikuti perkembangan versi yang didukung ini. Jika Anda memiliki versi Dapr yang lebih lama, Anda mungkin harus melakukan peningkatan menengah untuk mendapatkan versi yang didukung.

Atur autoUpgradeMinorVersion ke false dan version ke versi Dapr yang ingin Anda instal. autoUpgradeMinorVersion Jika parameter diatur ke true, dan version parameter dihilangkan, ekstensi menginstal versi terbaru Dapr.

Misalnya, untuk menggunakan Dapr 1.11.2:

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

Memilih kereta rilis

Saat mengonfigurasi ekstensi, Anda dapat memilih untuk menginstal Dapr dari kereta rilis tertentu. Tentukan salah satu dari dua nilai pelatihan rilis:

Nilai	Deskripsi
stable	Default.
dev	Rilis awal yang dapat berisi fitur eksperimental. Tidak cocok untuk produksi.

Contohnya:

properties: {
  releaseTrain: 'stable'
}

Memecahkan masalah kesalahan ekstensi

Jika ekstensi gagal membuat atau memperbarui, coba saran dan solusi di panduan pemecahan masalah ekstensi Dapr.

Pemecahan Masalah Dapr

Memecahkan masalah kesalahan Dapr melalui masalah Dapr umum dan panduan solusi.

Menghapus ekstensi

Jika Anda perlu menghapus ekstensi dan menghapus Dapr dari kluster AKS, Anda dapat menggunakan perintah berikut:

az k8s-extension delete --resource-group <myResourceGroup> --cluster-name <myAKSCluster> --cluster-type managedClusters --name dapr

Atau Anda dapat menghapus templat Bicep.

Langkah berikutnya

Mengonfigurasi ekstensi Dapr untuk skenario unik Anda