تثبيت ملحق Dapr لخدمة Azure Kubernetes (AKS) وKubernetes الممكنة بواسطة Arc

قبل البدء

إضافة ملحق Azure CLI لملحقات نظام المجموعة

k8s-extension تثبيت ملحق Azure CLI عن طريق تشغيل الأوامر التالية:

az extension add --name k8s-extension

إذا كان الملحق k8s-extension مثبتًا بالفعل، فإنه يمكنك تحديثه إلى أحدث إصدار باستخدام الأمر التالي:

az extension update --name k8s-extension

KubernetesConfiguration تسجيل موفر الموارد

إذا لم تكن تستخدم بالفعل ملحقات نظام المجموعة، فقد تحتاج إلى تسجيل موفر الموارد مع اشتراكك. يمكنك التحقق من حالة تسجيل الموفر باستخدام الأمر az provider list ، كما هو موضح في المثال التالي:

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

يجب على موفر Microsoft.ContainerInstance الإبلاغ على أنه مسجل، كما هو موضح في ناتج المثال التالي:

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

إذا ظهر الموفر كـ NotRegistered فقم بتسجيل الموفر باستخدام الأمر az provider register كما هو موضح في المثال التالي:

az provider register --namespace Microsoft.KubernetesConfiguration

تسجيل الميزة ExtenstionTypes في اشتراك Azure الخاص بك

يجب تسجيل الميزة ExtensionTypes في اشتراك Azure الخاص بك. في المحطة الطرفية، تحقق من أنك في الاشتراك الصحيح:

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

تسجيل الميزة ExtenstionTypes .

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

قد يستغرق تسجيل الميزة بعض الوقت. بعد بضع دقائق، تحقق من حالة التسجيل باستخدام الأمر التالي:

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

أنشئ الملحق وثبت Dapr على AKS أو مجموعة Kubernetes التي تدعم Arc

عند تثبيت ملحق Dapr، استخدم قيمة العلامة التي تتوافق مع نوع نظام المجموعة الخاص بك:

• مجموعة AKS: --cluster-type managedClusters.
• أنظمة مجموعة Kubernetes المُمكّنة في Arc: --cluster-type connectedClusters.

إنشاء ملحق Dapr، الذي يقوم بتثبيت Dapr على مجموعة Kubernetes أو AKS التي تدعم Arc.

على سبيل المثال، قم بتثبيت أحدث إصدار من Dapr عبر ملحق Dapr على نظام مجموعة AKS:

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

الاحتفاظ بمجموعة AKS المدارة محدثة إلى أحدث إصدار

استنادا إلى بيئتك (التطوير أو الاختبار أو الإنتاج)، يمكنك مواكبة أحدث إصدارات Dapr الثابتة.

اختيار قطار الإصدار

عند تكوين الملحق، يمكنك اختيار تثبيت Dapr من قطار إصدار معين. حدد إحدى قيمتي تدريب الإصدار:

على سبيل المثال:

--release-train stable

تكوين التحديثات التلقائية لمستوى تحكم Dapr

إذا قمت بتثبيت Dapr دون تحديد إصدار، --auto-upgrade-minor-version يتم تمكينه تلقائيا، وتكوين مستوى التحكم Dapr لتحديث إصداره الثانوي تلقائيا على الإصدارات الجديدة.

يمكنك تعطيل التحديث التلقائي عن طريق تحديد المعلمة --auto-upgrade-minor-version وتعيين القيمة إلى false.

تعيين إصدار Dapr بالتنسيقMAJOR.MINOR.PATCH، مما يعني 1.11.0 أن 1.12.0 هو ترقية إصدار ثانوي.

--auto-upgrade-minor-version true

عرض أحدث إصدارات Dapr الثابتة المتوفرة

للترقية إلى أحدث إصدار من Dapr في بيئة إنتاج، تحتاج إلى الترقية يدويا. ابدأ بعرض قائمة بإصدارات Dapr الثابتة المتوفرة لمجموعة AKS المدارة. شغّل الأمر التالي:

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

لمشاهدة أحدث إصدار ثابت من Dapr متوفر لمجموعة AKS المدارة، قم بتشغيل الأمر التالي:

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

لعرض قائمة بإصدارات Dapr الثابتة المتوفرة حسب الموقع:

1. تأكد من تسجيل الميزة ExtenstionTypes في اشتراك Azure.
2. قم بتشغيل الأمر التالي.

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

بعد ذلك، قم بتحديث Dapr يدويا إلى أحدث إصدار مستقر.

استهداف إصدار Dapr محدد

يتم استخدام نفس وسيطة سطر الأوامر لتثبيت إصدار معين من Dapr أو التراجع إلى إصدار سابق. قُم بتّعيين --auto-upgrade-minor-version إلى false و--version إلى إصدار Dapr الذي ترغب في تثبيته وإلى الإصدار الخاص به. إذا تم حذف المعلمة version ، يقوم الملحق بتثبيت أحدث إصدار من Dapr. على سبيل المثال، لاستخدام 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

قبل البدء

KubernetesConfiguration تسجيل موفر الموارد

إذا لم تكن تستخدم بالفعل ملحقات نظام المجموعة، فقد تحتاج إلى تسجيل موفر الموارد مع اشتراكك. يمكنك التحقق من حالة تسجيل الموفر باستخدام الأمر az provider list ، كما هو موضح في المثال التالي:

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

يجب على موفر Microsoft.ContainerInstance الإبلاغ على أنه مسجل، كما هو موضح في ناتج المثال التالي:

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

إذا ظهر الموفر كـ NotRegistered فقم بتسجيل الموفر باستخدام الأمر az provider register كما هو موضح في المثال التالي:

az provider register --namespace Microsoft.KubernetesConfiguration

تسجيل الميزة ExtenstionTypes في اشتراك Azure الخاص بك

يجب تسجيل الميزة ExtensionTypes في اشتراك Azure الخاص بك. في المحطة الطرفية، تحقق من أنك في الاشتراك الصحيح:

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

تسجيل الميزة ExtenstionTypes .

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

قد يستغرق تسجيل الميزة بعض الوقت. بعد بضع دقائق، تحقق من حالة التسجيل باستخدام الأمر التالي:

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

نشر ملحق Dapr على نظام مجموعة Kubernetes التي تدعم Arc أو AKS

أنشئ قالب Bicep مشابها للمثال التالي وانشر ملحق Dapr إلى نظام المجموعة الحالي.

@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'
  }
}

تعيين المتغيرات التالية، وتغيير القيم التالية إلى مجموعة الموارد الفعلية وأسماء نظام المجموعة.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

انشر قالب Bicep باستخدام az deployment group الأمر .

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

تكوين التحديثات التلقائية لمستوى تحكم Dapr

إذا قمت بنشر Dapr دون تحديد إصدار، autoUpgradeMinorVersion يتم تمكينه تلقائيا، وتكوين مستوى التحكم Dapr لتحديث إصداره الثانوي تلقائيا على الإصدارات الجديدة.

يمكنك تعطيل التحديث التلقائي عن طريق تحديد المعلمة autoUpgradeMinorVersion وتعيين القيمة إلى false.

تعيين إصدار Dapr بالتنسيقMAJOR.MINOR.PATCH، مما يعني 1.11.0 أن 1.12.0 هو ترقية إصدار ثانوي.

properties {
  autoUpgradeMinorVersion: true
}

استهداف إصدار Dapr محدد

قُم بتّعيين autoUpgradeMinorVersion إلى false وversion إلى إصدار Dapr الذي ترغب في تثبيته وإلى الإصدار الخاص به. إذا تم تعيين المعلمة autoUpgradeMinorVersion إلى true، وتم version حذف المعلمة، يقوم الملحق بتثبيت أحدث إصدار من Dapr.

على سبيل المثال، لاستخدام Dapr 1.11.2:

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

اختيار قطار الإصدار

عند تكوين الملحق، يمكنك اختيار تثبيت Dapr من قطار إصدار معين. حدد إحدى قيمتي تدريب الإصدار:

على سبيل المثال:

properties: {
  releaseTrain: 'stable'
}