Ekstensi Dapr untuk Azure Kubernetes Service (AKS) dan Kubernetes berkemampuan 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 portabel di beberapa layanan cloud dan host (misalnya, Kubernetes vs. VM)

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.
• Instal versi terbaru Azure CLI.
• Jika Anda belum memilikinya, Anda perlu membuat kluster AKS atau menghubungkan kluster Kubernetes yang mendukung Arc.
• Pastikan Anda memiliki peran Admin RBAC Azure Kubernetes Service

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

Azure CLI

Menyiapkan 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 sebelumnya Anda belum menggunakan ekstensi kluster, Anda mungkin perlu mendaftarkan penyedia sumber daya dengan langganan Anda. Anda bisa memeriksa status pendaftaran penyedia menggunakan perintah [az provider list][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

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

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 menginstal Dapr tanpa menentukan versi, --auto-upgrade-minor-versiondiaktifkan 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.01.11.0 adalah peningkatan versi minor.

--auto-upgrade-minor-version 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.

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.11.2:

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.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, dapat berisi fitur eksperimental. Tidak cocok untuk produksi.

Contohnya:

--release-train stable

Bicep

Mendaftarkan KubernetesConfiguration penyedia sumber daya

Jika sebelumnya Anda belum menggunakan ekstensi kluster, Anda mungkin perlu mendaftarkan penyedia sumber daya dengan langganan Anda. Anda bisa memeriksa status pendaftaran penyedia menggunakan perintah [az provider list][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

Sebarkan ekstensi Dapr pada kluster Kubernetes yang didukung AKS atau Arc

Buat templat Bicep yang mirip dengan contoh berikut untuk menyebarkan 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 di bawah ini 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, autoUpgradeMinorVersiondiaktifkan 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.01.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, 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 cukup hapus templat Bicep.

Langkah berikutnya

• Pelajari selengkapnya tentang pengaturan dan preferensi tambahan yang dapat Anda atur pada ekstensi Dapr.
• Setelah berhasil menyediakan Dapr di kluster AKS, coba gunakan aplikasi sampel.
• Mencoba Alur Kerja Dapr pada ekstensi Dapr Anda untuk AKS