ملحق Dapr ل Azure Functions

ملحق Dapr ل Azure Functions هو مجموعة من الأدوات والخدمات التي تسمح للمطورين بدمج Azure Functions بسهولة مع النظام الأساسي لوقت تشغيل التطبيق الموزع (Dapr).

Azure Functions هي خدمة حساب مستندة إلى الحدث توفر مجموعة من المشغلات والروابط للاتصال بسهولة بخدمات Azure الأخرى. يوفر Dapr مجموعة من الكتل الإنشائية وأفضل الممارسات لبناء التطبيقات الموزعة، بما في ذلك الخدمات المصغرة وإدارة الحالة والمراسلة pub/sub والمزيد.

مع التكامل بين Dapr و Functions، يمكنك إنشاء وظائف تتفاعل مع الأحداث من Dapr أو الأنظمة الخارجية.

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

تمكين Dapr

يمكنك تكوين Dapr باستخدام مختلف [الوسيطات والتعليقات التوضيحية][dapr-args] استنادا إلى سياق وقت التشغيل. يمكنك تكوين Dapr ل Azure Functions من خلال قناتين:

• قوالب البنية الأساسية كتعليمية (IaC)، كما هو الحال في قوالب Bicep أو Azure Resource Manager (ARM)
• مدخل Microsoft Azure

عند استخدام قالب IaC، حدد الوسيطات التالية في properties قسم من تعريف مورد تطبيق الحاوية.

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

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

عند تكوين Dapr باستخدام مدخل Microsoft Azure، انتقل إلى تطبيق الوظائف وحدد Dapr من القائمة اليمنى:

منافذ Dapr والمستمعين

عند تشغيل دالة من Dapr، يعرض الملحق المنفذ 3001 تلقائيا للاستماع إلى الطلبات الواردة من Dapr sidecar.

بشكل افتراضي، عندما تحاول Azure Functions الاتصال ب Dapr، فإنه يستدعي Dapr عبر المنفذ الذي تم حله من متغير DAPR_HTTP_PORTالبيئة . إذا كان هذا المتغير فارغا، فسيتم تعيينه افتراضيا إلى المنفذ 3500.

يمكنك تجاوز عنوان Dapr المستخدم بواسطة روابط الإدخال والإخراج عن طريق تعيين الخاصية DaprAddress في function.json للربط (أو السمة). بشكل افتراضي، يستخدم http://localhost:{DAPR_HTTP_PORT}.

لا يزال تطبيق الوظائف يعرض منفذا آخر ونقطة نهاية لأشياء مثل مشغلات HTTP، والتي يتم تعيينها افتراضيا محليا إلى 7071، ولكن في الحاوية، يتم تعيينها افتراضيا إلى 80.

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

يصف هذا القسم كيفية استكشاف المشكلات التي يمكن أن تحدث عند استخدام ملحق Dapr لوظائف Azure وإصلاحها.

تأكد من تمكين Dapr في بيئتك

إذا كنت تستخدم روابط ومشغلات Dapr في Azure Functions، ولم يتم تمكين Dapr في بيئتك، فقد تتلقى رسالة الخطأ: Dapr sidecar isn't present. Please see (https://aka.ms/azure-functions-dapr-sidecar-missing) for more information. لتمكين Dapr في بيئتك:

• إذا تم نشر Azure Function في Azure Container Apps، فراجع إرشادات تمكين Dapr لملحق Dapr ل Azure Functions.

• إذا تم نشر Azure Function في Kubernetes، فتحقق من أن تكوين YAML الخاص بالنشر يحتوي على التعليقات التوضيحية التالية:

  annotations:
    ...
    dapr.io/enabled: "true"
    dapr.io/app-id: "functionapp"
    # You should only set app-port if you are using a Dapr trigger in your code.
    dapr.io/app-port: "<DAPR_APP_PORT>"
    ...
  

• إذا كنت تقوم بتشغيل Azure Function محليا، فقم بتشغيل الأمر التالي للتأكد من تشغيل تطبيق الوظائف باستخدام Dapr:

  dapr run --app-id functionapp --app-port <DAPR_APP_PORT>  --components-path <COMPONENTS_PATH> -- func host start 
  

التحقق من قيمة منفذ التطبيق في تكوين Dapr

يبدأ ملحق Dapr ل Azure Functions خادم HTTP على المنفذ 3001 بشكل افتراضي. يمكنك تكوين هذا المنفذ باستخدام DAPR_APP_PORT متغير البيئة.

إذا قمت بتوفير قيمة منفذ تطبيق غير صحيحة عند تشغيل تطبيق Azure Functions، فقد تتلقى رسالة الخطأ: The Dapr sidecar is configured to listen on port {portInt}, but the app server is running on port {appPort}. This may cause unexpected behavior. For more information, visit [this link](https://aka.ms/azfunc-dapr-app-config-error). لحل رسالة الخطأ هذه:

1. في إعدادات Dapr لتطبيق الحاوية:

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

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

2. تحقق من توفير قيمة منفذ التطبيق الصحيحة في تكوين Dapr.

   • إذا كنت تستخدم Azure Container Apps، فحدد منفذ التطبيق في Bicep:

     DaprConfig: {
        ...
        appPort: <DAPR_APP_PORT>
        ...
     }
     

   • إذا كنت تستخدم بيئة Kubernetes، فقم بتعيين dapr.io/app-port التعليق التوضيحي:

     annotations:
        ...
        dapr.io/app-port: "<DAPR_APP_PORT>"
        ...
     

   • إذا كنت تقوم بالتطوير محليا، فتحقق من تعيين --app-port عند تشغيل تطبيق الوظائف باستخدام Dapr:

     dapr run --app-id functionapp --app-port <DAPR_APP_PORT> --components-path <COMPONENTS_PATH> -- func host start 
     

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

تعرف على المزيد حول Dapr.