ملحق Dapr لخدمة Azure Kubernetes (AKS) وKubernetes التي تُمكّن Arc

يبسط Dapr بناء التطبيقات المرنة عديمة الحالة والحالية التي تعمل على السحابة والحافة وتحتضن تنوع اللغات وأطر عمل المطورين. باستخدام بنية Dapr الجانبية، يمكنك الحفاظ على منصة التعليمات البرمجية غير محددة مع معالجة التحديات المتعلقة ببناء الخدمات المصغرة، مثل:

• الاتصال بالخدمات الأخرى بشكل موثوق وآمن
• إنشاء تطبيقات تستند إلى الحدث باستخدام pub/sub
• بناء التطبيقات المحمولة عبر خدمات السحابة المتعددة والمضيفين (على سبيل المثال، Kubernetes مقابل جهاز ظاهري)

إشعار

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

طريقة العمل

يستخدم ملحق Dapr CLI Azure أو قالب Bicep لتوفير مستوى تحكم Dapr على نظام مجموعة Kubernetes التي تدعم AKS أو Arc، وإنشاء خدمات Dapr التالية:

خدمة Dapr	‏‏الوصف
dapr-operator	إدارة تحديثات المكونات ونقاط نهاية خدمات Kubernetes ل Dapr (مخازن الحالة و pub/subs وما إلى ذلك)
dapr-sidecar-injector	إدراج Dapr في حجيرات النشر ذات التعليقات التوضيحية وإضافة متغيرات DAPR_HTTP_PORTDAPR_GRPC_PORT البيئة وتمكين التطبيقات المعرفة من قبل المستخدم من الاتصال بسهولة مع Dapr دون قيم منفذ Dapr ذات الترميز المضمن.
dapr-placement	يستخدم للممثلين فقط. إنشاء جداول تعيين تعين مثيلات الممثل إلى pods.
dapr-sentry	يدير mTLS بين الخدمات ويعمل كمرجع مصدق. لمزيد من المعلومات، اقرأ نظرة عامة على الأمان.

بمجرد تثبيت Dapr على المجموعة الخاصة بك، يمكنك البدء في التطوير باستخدام واجهات برمجة تطبيقات كتلة إنشاء Dapr عن طريق إضافة بعض التعليقات التوضيحية إلى عمليات النشر الخاصة بك. للحصول على نظرة عامة أكثر تعمقًا على واجهات برمجة التطبيقات APIs لكتلة الإنشاء وكيفية استخدامها على أفضل وجه، اطلع على نظرة عامة على كتل الإنشاء Dapr.

تحذير

إذا قمت بتثبيت Dapr من خلال ملحق AKS أو ملحق Kubernetes الممكّن من Arc، فإن توصيتنا هي الاستمرار في استخدام الملحق للإدارة المستقبلية لـDapr بدلاً من Dapr CLI. يمكن أن يؤدي دمج الأداتين إلى حدوث تعارضات ويؤدي إلى حدوث سلوك غير مرغوب فيه.

المتطلبات الأساسية

• اشتراك Azure. ليس لديك واحد؟ يمكنك إنشاء حساب مجاني.
• قم بتثبيت أحدث إصدار من Azure CLI.
• إذا لم يكن لديك إصدار بالفعل، فأنت بحاجة إلى إنشاء مجموعة AKS أو توصيل مجموعة Kubernetes التي تدعم Arc.
• تأكد من أن لديك دور azure Kubernetes Service RBAC مسؤول

حدد كيفية تثبيت ملحق Dapr ونشره وتكوينه.

Azure CLI

إعداد ملحق البرنامج CLI Azure لملحقات مجموعة أجهزة كمبيوتر

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] كما هو موضح في المثال التالي:

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

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

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

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

إشعار

إذا كنت تستخدم Dapr OSS على نظام مجموعة AKS الخاص بك وترغب في تثبيت ملحق Dapr ل AKS، فاقرأ المزيد حول كيفية الترحيل بنجاح إلى ملحق Dapr.

إنشاء ملحق 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

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

تحذير

يمكنك تمكين التحديثات التلقائية لمستوى التحكم 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، قد تحتاج إلى القيام بترقيات متوسطة للوصول إلى إصدار معتمد.

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

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

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

قيمة	‏‏الوصف
stable	الإعداد الافتراضي.
dev	يمكن أن تحتوي الإصدارات المبكرة على ميزات تجريبية. غير مناسب للإنتاج.

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

--release-train stable

Bicep

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

إذا لم تكن قد استخدمت ملحقات نظام المجموعة مسبقا، فقد تحتاج إلى تسجيل موفر الموارد مع اشتراكك. يمكنك التحقق من حالة تسجيل الموفر باستخدام الأمر [az provider list][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

نشر ملحق 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 فقط في بيئات التطوير أو الاختبار. الترقية التلقائية غير مناسبة لبيئات الإنتاج.

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

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

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

properties {
  autoUpgradeMinorVersion: true
}

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

إشعار

إن Dapr معتمد مع إطار المتداول، بما في ذلك الإصدارات الحالية والسابقة فقط. تقع على عاتقك مسؤولية تشغيلية أن تظل على اطلاع على هذه الإصدارات المدعومة. إذا كان لديك إصدار قديم من Dapr، قد تحتاج إلى القيام بترقيات متوسطة للوصول إلى إصدار معتمد.

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

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

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

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

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

قيمة	‏‏الوصف
stable	الإعداد الافتراضي.
dev	يمكن أن تحتوي الإصدارات المبكرة على ميزات تجريبية. غير مناسب للإنتاج.

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

properties: {
  releaseTrain: 'stable'
}

استكشاف أخطاء الملحقات وإصلاحها

إذا فشل الملحق في الإنشاء أو التحديث، فجرب الاقتراحات والحلول في دليل استكشاف أخطاء ملحق Dapr وإصلاحها.

استكشاف أخطاء Dapr وإصلاحها

استكشاف أخطاء Dapr وإصلاحها عبر دليل حلول ومشكلات Dapr الشائعة.

قم بحذف الملحق

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

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

أو ببساطة قم بإزالة قالب Bicep.

الخطوات التالية

• تعرف على المزيد حول الإعدادات والتفضيلات الإضافية التي يمكنك تعيينها على ملحق Dapr.
• بمجرد نجاح توفير Dapr في الكتلة AKS حاول نشر تطبيق نموذج.
• جرب Dapr Workflow على ملحق Dapr الخاص بك ل AKS