إنشاء مهام سير عمل تطبيق المنطق القياسي للتوزيع المختلط على البنية الأساسية الخاصة بك

ينطبق على: Azure Logic Apps (قياسي)

بالنسبة للسيناريوهات التي تحتاج فيها إلى استخدام البنية الأساسية الخاصة بك والتحكم فيها وإدارتها، يمكنك إنشاء مهام سير عمل تطبيق المنطق القياسي باستخدام نموذج التوزيع المختلط في Azure Logic Apps. يوفر هذا النموذج قدرات لك لإنشاء حلول تكامل واستضافتها للبيئات المتصلة جزئيا والتي تتطلب المعالجة المحلية والتخزين والوصول إلى الشبكة. يمكن أن تتضمن بنيتك الأساسية الأنظمة المحلية والسحب الخاصة والسحب العامة. باستخدام النموذج المختلط، يتم تشغيل سير عمل تطبيق المنطق القياسي بواسطة وقت تشغيل Azure Logic Apps، والذي تتم استضافته محليا كجزء من ملحق Azure Container Apps.

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

يوضح هذا الدليل الإرشادي كيفية إنشاء سير عمل تطبيق منطقي قياسي ونشره باستخدام نموذج التوزيع المختلط بعد إعداد الموارد المحلية الضرورية لاستضافة تطبيقك.

القيود

يصف القسم التالي القيود المفروضة على خيار التوزيع المختلط:

القيد	‏‏الوصف
مناطق Azure المدعومة	النشر المختلط متوفر حاليا ومدعم فقط في مناطق Azure التالية: - وسط الولايات المتحدة -شرق آسيا - شرق الولايات المتحدة - شمال وسط الولايات المتحدة -جنوب شرق آسيا - وسط السويد - جنوب المملكة المتحدة - غرب أوروبا - غرب الولايات المتحدة
تسجيل البيانات مع وقت تشغيل غير متصل	في الوضع المتصل جزئيا، يمكن أن يظل وقت تشغيل Azure Logic Apps غير متصل حتى 24 ساعة ولا يزال يحتفظ بسجلات البيانات. ومع ذلك، قد تفقد أي بيانات تسجيل تجاوزت هذه المدة.
القدرات غير المدعومة المتوفرة في Azure Logic Apps (قياسي) المستأجر الفردي وخدمات Azure ذات الصلة	- فتحات التوزيع - تتبع عملية Azure Business - صحة الموارد ضمن الدعم + استكشاف الأخطاء وإصلاحها في مدخل Microsoft Azure - مصادقة الهوية المدارة لعمليات الموصل. لا تدعم مجموعات Kubernetes الممكنة في Azure Arc حاليا مصادقة الهوية المدارة لاتصالات واجهة برمجة التطبيقات المدارة. بدلا من ذلك، يجب إنشاء تسجيل التطبيق الخاص بك باستخدام معرف Microsoft Entra. لمزيد من المعلومات، اتبع هذه الخطوات لاحقا في هذا الدليل.
المشغلات المستندة إلى الدالة	تتطلب بعض المشغلات المستندة إلى الوظائف، مثل Azure Blob وCosmos DB ومراكز الأحداث اتصالا بحساب تخزين Azure المقترن بتطبيق المنطق القياسي. إذا كنت تستخدم أي مشغلات مستندة إلى الدالة، في متغيرات بيئة تطبيق المنطق القياسي في مدخل Microsoft Azure أو في ملف local.settings.json لمشروع تطبيق المنطق في Visual Studio Code، أضف إعداد التطبيق المسمى AzureWebJobsStorage وقدم سلسلة اتصال حساب التخزين: "Values": { "name": "AzureWebJobsStorage", "value": "{storage-account-connection-string}" }

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

• حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فيجب التسجيل للحصول على حساب Azure مجاني.

• الموارد المحلية التالية، والتي يجب أن تكون كلها موجودة داخل نفس الشبكة للاتصال المطلوب:

  • نظام مجموعة Azure Kubernetes Service المتصل ب Azure Arc
  • قاعدة بيانات SQL لتخزين محفوظات تشغيل سير العمل والمدخلات والمخرجات محليا للمعالجة
  • مشاركة ملف Server Message Block (SMB) لتخزين البيانات الاصطناعية التي تستخدمها مهام سير العمل محليا

  لتلبية هذه المتطلبات، قم بإعداد هذه الموارد المحلية لدعم النشر المختلط لتطبيقات المنطق القياسية.

• للعمل في Visual Studio Code، تحتاج إلى ملحق Azure Logic Apps (قياسي) ل Visual Studio Code مع المتطلبات الأساسية ذات الصلة.

  تلميح

  إذا كان لديك تثبيت Visual Studio Code جديد، فتأكد من أنه يمكنك تشغيل سير عمل قياسي أساسي محليا قبل محاولة النشر إلى البنية الأساسية الخاصة بك. يساعد تشغيل الاختبار هذا في عزل أي أخطاء قد تكون موجودة في مشروع سير العمل القياسي.

إنشاء تطبيق المنطق القياسي

بوابة

أنشئ تطبيق المنطق القياسي للتوزيع المختلط باتباع الخطوات التالية:

1. في مربع البحث في مدخل Microsoft Azure، أدخل logic apps، وحدد Logic apps.

2. في شريط أدوات صفحة Logic apps ، حدد Add.

3. في صفحة Create Logic App ، ضمن Standard، حدد Hybrid.

4. في صفحة Create Logic App (Hybrid)، قم بتوفير المعلومات التالية:

   الخاصية	المطلوب	قيمة	‏‏الوصف
   الاشتراك	‏‏نعم‬	< "Azure-subscription-name">	اسم اشتراك Azure خاصتك. يستخدم هذا المثال الدفع أولًا بأول.
   مجموعة الموارد	‏‏نعم‬	< اسم مجموعة الموارد>	مجموعة موارد Azure حيث تقوم بإنشاء تطبيقك المختلط والموارد ذات الصلة. يجب أن يكون هذا الاسم فريدًا عبر المناطق ويمكن أن يحتوي فقط على أحرف وأرقام وواصلات (-) وتسطير سفلي (_) وأقواس (()) ونقاط (.). ينشئ هذا المثال مجموعة موارد تسمى Hybrid-RG.
   إدخال اسم التطبيق	‏‏نعم‬	< "logic-app-name">	اسم تطبيق المنطق الخاص بك، والذي يجب أن يكون فريدا عبر المناطق ويمكن أن يحتوي فقط على أحرف صغيرة أو أرقام أو واصلات (-). يستخدم هذا المثال my-logic-app-hybrid.
   المنطقة	‏‏نعم‬	< تحديد منطقة Azure>	منطقة Azure مدعومة لتطبيقات حاويات Azure على AKS التي تدعم Azure Arc. يستخدم هذا المثال شرق الولايات المتحدة.
   بيئة متصلة بتطبيق الحاوية	‏‏نعم‬	< اسم البيئة المتصلة>	مجموعة Kubernetes الممكنة بواسطة Arc التي قمت بإنشائها كبيئة نشر لتطبيق المنطق الخاص بك. لمزيد من المعلومات، راجع البرنامج التعليمي: تمكين تطبيقات حاوية Azure على Kubernetes التي تدعم Azure Arc.
   تكوين إعدادات التخزين	‏‏نعم‬	ممكن أو معطل	متابعة إلى علامة التبويب Storage في صفحة Create Logic App (Hybrid).

   يوضح المثال التالي صفحة إنشاء تطبيق المنطق في مدخل Microsoft Azure مع قيم العينة:

   

5. في صفحة التخزين ، قم بتوفير المعلومات التالية حول موفر التخزين ومشاركة ملف SMB التي قمت بإعدادها مسبقا:

   الخاصية	المطلوب	قيمة	‏‏الوصف
   سلسلة اتصال SQL	‏‏نعم‬	< سلسلة اتصال SQL - خادم>	سلسلة الاتصال SQL Server الذي قمت بحفظه مسبقا. لمزيد من المعلومات، راجع إنشاء موفر تخزين SQL Server.
   اسم المضيف	‏‏نعم‬	< اسم مضيف مشاركة الملف>	اسم المضيف لمشاركة ملف SMB.
   مسار مشاركة الملف	‏‏نعم‬	< مسار مشاركة الملفات>	مسار مشاركة الملف لمشاركة ملف SMB.
   اسم المستخدم	‏‏نعم‬	< اسم مستخدم مشاركة الملف>	اسم المستخدم لمشاركة ملف SMB.
   كلمة المرور	‏‏نعم‬	< كلمة مرور مشاركة الملفات>	كلمة المرور لمشاركة ملف SMB.

6. عند الانتهاء، حدد Review + create. قم بتأكيد المعلومات المتوفرة، وحدد Create.

7. بعد اكتمال Azure للتوزيع، حدد Go to resource.

   يفتح مدخل Azure مورد تطبيق المنطق الخاص بك، على سبيل المثال:

   

8. في قائمة مورد تطبيق المنطق، ضمن Workflows، حدد Workflows.

9. في شريط أدوات صفحة مهام سير العمل ، حدد إضافة لإضافة سير عمل فارغ ذي حالة أو عديم الحالة.

10. بعد فتح المصمم، قم بإنشاء سير العمل الخاص بك عن طريق إضافة مشغل وإجراءات.

    لمزيد من المعلومات، راجع إنشاء سير عمل باستخدام مشغل وإجراءات.

إذا كنت ترغب في النشر مع مشاركة ملف SMB، فتأكد من استيفاء الشروط التالية قبل إنشاء تطبيق المنطق القياسي للتوزيع المختلط في Visual Studio Code:

• يمكن الوصول إلى خادم مشاركة ملفات SMB.
• المنفذ 445 مفتوح على الكمبيوتر حيث تقوم بتشغيل Visual Studio Code.

قم بإنشاء تطبيق منطقي

1. تشغيل Visual Studio Code كمسؤول.

2. في Visual Studio Code، في شريط النشاط، حدد أيقونة Azure.

3. في قسم مساحة العمل، من شريط الأدوات، حدد أيقونة Azure Logic Apps، ثم حدد إنشاء مشروع جديد.

4. استعرض وصولا إلى الموقع حيث تريد إنشاء المجلد لمشروع تطبيق المنطق القياسي. أنشئ مجلد المشروع، وحدد المجلد، ثم اختر تحديد.

5. من قائمة نوع سير العمل، حدد سير عمل الحالة أو سير العمل عديم الحالة. أدخل اسمًا لسير العمل الخاص بك.

   يحدد هذا المثال سير عمل Stateful ويستخدم my-stateful-workflow كاسم.

6. من القائمة التي تظهر، حدد فتح في النافذة الحالية.

   ينشئ Visual Studio Code مشروع تطبيق المنطق الخاص بك ويفتحه لإظهار ملف workflow.json .

7. من القائمة التي تظهر، حدد استخدام الموصلات من Azure.

8. من قائمة الاشتراك، حدد اشتراك Azure الخاص بك.

9. من قائمة مجموعة الموارد، حدد إنشاء مجموعة موارد جديدة. أدخل اسما لمجموعة الموارد الخاصة بك.

   يستخدم هذا المثال Hybrid-RG.

10. من قائمة المواقع، حدد منطقة Azure المدعومة لتطبيقات حاويات Azure على AKS التي تدعم Azure Arc.

    يستخدم هذا المثال شرق الولايات المتحدة.

11. في نافذة Explorer ، افتح القائمة المختصرة لملف workflow.json ، وحدد Open Designer.

12. أنشئ سير العمل كالمعتاد عن طريق إضافة مشغل وإجراءات. لمزيد من المعلومات، راجع إنشاء سير عمل باستخدام مشغل وإجراءات.

نشر تطبيق المنطق الخاص بك

بعد الانتهاء من إنشاء سير العمل الخاص بك، يمكنك نشر تطبيق المنطق الخاص بك إلى البيئة المحلية المتصلة ب Azure Container Apps.

نشر zip

يوفر نشر Zip المزايا التالية عبر خيار مشاركة ملف SMB.

• لا يحتاج Visual Studio Code إلى اتصال بمشاركة ملف SMB.
• لا تتطلب عمليات النشر اللاحقة بيانات اعتماد لمشاركة ملف SMB.
• يوفر توزيع Zip خيارا أكثر استقرارا وموثوقية عبر توزيع SMB، والذي يكون عرضة لتعارضات 409.

لاستخدام توزيع zip، اتبع الخطوات التالية:

1. إنشاء تسجيل تطبيق باستخدام معرف Microsoft Entra. في الخطوات المناسبة، قم بتوفير معرف العميل ومعرف الكائن وسر العميل.

2. لاستخدام توزيع zip مع مورد تطبيق منطق قياسي موجود في مدخل Microsoft Azure، يجب إضافة تسجيل التطبيق يدويا كإعداد تطبيق في مورد تطبيق المنطق القياسي.

   لمزيد من المعلومات، راجع إضافة قيم تسجيل التطبيق إلى تطبيق المنطق القياسي.

إذا كانت لديك مخاوف بشأن إنشاء تسجيل تطبيق، فلا يزال بإمكانك استخدام خيار نشر مشاركة ملف SMB.

1. في Visual Studio Code، في شريط النشاط، حدد Manage (gear icon) >Settings.

2. ضمن مساحة العمل، حدد Extensions>Azure Logic Apps (Standard)>استخدم SMBDeployment for Hybrid>Enable لاستخدام نشر SMB لتطبيقات المنطق المختلط.

3. اتبع القسم التالي لنشر مشاركة ملف SMB.

نشر مشاركة ملف SMB

1. في نافذة Visual Studio Code Explorer ، افتح القائمة المختصرة لعقدة سير العمل، وهي my-stateful-workflow في هذا المثال، وحدد Deploy to logic app.

2. من قائمة الاشتراك، حدد اشتراك Azure الخاص بك.

3. من قائمة تطبيقات المنطق المتوفرة، حدد Create new Logic App (Standard) في Azure. قم بتوفير اسم تطبيق منطقي فريد عالميا يستخدم فقط أحرف أبجدية رقمية صغيرة أو واصلات.

   يستخدم هذا المثال my-logic-app-hybrid.

4. من قائمة المواقع التي تظهر، حدد نفس منطقة Azure حيث لديك البيئة المتصلة.

   يستخدم هذا المثال شرق الولايات المتحدة.

5. من قائمة خطة الاستضافة، حدد Hybrid.

6. من قائمة مجموعة الموارد، حدد إنشاء مجموعة موارد جديدة. أدخل اسما لمجموعة الموارد الخاصة بك.

   يستخدم هذا المثال Hybrid-RG.

7. من قائمة البيئة المتصلة، حدد بيئتك.

8. قم بتوفير القيم المحفوظة مسبقا لاسم المضيف ومسار مشاركة ملف SMB واسم المستخدم وكلمة المرور لتخزين البيانات الاصطناعية.

9. قم بتوفير سلسلة الاتصال لقاعدة بيانات SQL التي قمت بإعدادها لتخزين وقت التشغيل.

   يبدأ Visual Studio Code عملية النشر لتطبيق المنطق القياسي.

10. لمراقبة حالة النشر وسجلات نشاط Azure، من القائمة عرض ، حدد الإخراج. في النافذة التي تفتح، حدد Azure.

    بعد اكتمال النشر، يمكنك الانتقال إلى مدخل Microsoft Azure لعرض تطبيق المنطق القياسي المنشور وسير العمل.

تعيين الإصدارات للنشر المختلط

ينشئ تطبيق المنطق القياسي مع خيار الاستضافة المختلط تلقائيا مراجعة جديدة، وهو مفهوم تعيين الإصدار من Azure Container Apps، كلما قمت بحفظ التغييرات على سير عمل تابع. قد تستغرق هذه المراجعة بعض الوقت للتنشيط، مما يعني أنه بعد حفظ أي تغييرات، قد تحتاج إلى الانتظار عدة لحظات قبل اختبار سير العمل.

إذا لم تظهر تغييراتك بعد في سير العمل، يمكنك التحقق مما إذا كانت المراجعة موجودة:

1. في مدخل Microsoft Azure، افتح المورد الخاص بك. في قائمة الموارد، ضمن Revisions، حدد Revisions and replicas.

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

لمزيد من المعلومات، راجع الموارد التالية:

• تحديث التغييرات ونشرها في Azure Container Apps

• إدارة المراجعات في Azure Container Apps

إعداد بيانات تتبع الاستخدام المحسنة أو OpenTelemetry لمراقبة الأداء

يمكنك إعداد مجموعة بيانات تتبع الاستخدام المحسنة في Application Insights لتطبيق المنطق القياسي ثم عرض البيانات التي تم جمعها بعد انتهاء سير العمل من التشغيل. تمنحك هذه الإمكانية تجربة أبسط للحصول على رؤى حول مهام سير العمل الخاصة بك والمزيد من التحكم في تصفية الأحداث في مصدر البيانات، ما يساعدك على تقليل تكاليف التخزين. تركز هذه التحسينات على مقاييس الأداء في الوقت الحقيقي التي توفر رؤى حول صحة النظام وسلوكه.

بالنسبة للسيناريوهات المتصلة جزئيا والسيناريوهات المحلية، يمكنك إعداد تطبيق المنطق القياسي لإصدار بيانات تتبع الاستخدام استنادا إلى إعدادات التطبيق المدعومة من OpenTelemetry التي تحددها للبيئة المحددة. بشكل افتراضي، يتم إرسال بيانات تتبع الاستخدام هذه إلى Application Insights. لمزيد من المعلومات، راجع تمكين القياس عن بعد المحسن في Application Insights لسير العمل القياسي في Azure Logic Apps.

تغيير وحدة المعالجة المركزية الظاهرية وتخصيص الذاكرة في مدخل Microsoft Azure

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

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي.

2. في قائمة الموارد، ضمن Settings، حدد Containers.

3. في شريط أدوات صفحة الحاويات ، حدد تحرير ونشر، الذي يفتح جزء تحرير حاوية .

4. في علامة التبويب Properties ، ضمن Container resource allocation، قم بتغيير القيم التالية لتناسب السيناريو الخاص بك:

   الخاصية	قيمة	‏‏الوصف
   مراكز وحدة المعالجة المركزية	- الافتراضي: 1 - الحد الأدنى: 0.25 - الحد الأقصى: 2	تحديد الذاكرات الأساسية لوحدة المعالجة المركزية الظاهرية لتعيينها إلى مثيل الحاوية. يمكنك زيادة هذه القيمة بمقدار 0.25 نواة حتى الحد الأقصى للقيمة. يقتصر العدد الإجمالي عبر جميع مثيلات الحاوية لهذا التطبيق المنطقي على نواتين.
   الذاكرة	- الافتراضي: 2 - الحد الأدنى: 0.1 - الحد الأقصى: 4	تحديد سعة الذاكرة في gibibytes (GiB) لتعيينها إلى مثيل الحاوية. يمكنك زيادة هذه القيمة بمقدار 0.1 غيغابايت حتى الحد الأقصى للقيمة. تقتصر السعة الإجمالية عبر جميع مثيلات الحاوية لهذا التطبيق المنطقي على 4 غيغابايت.

5. عندما تنتهي، حدد "Save".

تغيير تحجيم النسخة المتماثلة في مدخل Microsoft Azure

يمكنك التحكم في التحجيم التلقائي لنطاق النسخ المتماثلة التي يتم نشرها استجابة لحدث مشغل. النسخة المتماثلة هي مثيل جديد لمراجعة مورد تطبيق منطقي أو إصدار. لتغيير الحد الأدنى والحد الأقصى للقيم لهذا النطاق، يمكنك تعديل قواعد المقياس لتحديد أنواع الأحداث التي تؤدي إلى التحجيم. لمزيد من المعلومات، راجع تعيين قواعد التحجيم في Azure Container Apps.

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي.

2. في قائمة الموارد، ضمن Settings، حدد Scale.

3. في صفحة المقياس، ضمن إعداد قاعدة المقياس، قم بتغيير القيم التالية لتناسب السيناريو الخاص بك:

   الخاصية	قيمة	‏‏الوصف
   الحد الأدنى للنسخ المتماثلة	- الافتراضي: 1 - الحد الأدنى: 0 - الحد الأقصى: 1000	تحديد الحد الأدنى لعدد النسخ المتماثلة المسموح بها للمراجعة في أي وقت. تتجاوز هذه القيمة قواعد المقياس ويجب أن تكون أقل من الحد الأقصى لعدد النسخ المتماثلة.
   الحد الأقصى للنسخ المتماثلة	- الافتراضي: 30 - الحد الأدنى: 0 - الحد الأقصى: 1000	تحديد الحد الأقصى لعدد النسخ المتماثلة المسموح بها للمراجعة في أي وقت. تتجاوز هذه القيمة قواعد المقياس.

4. عندما تنتهي، حدد "Save".

التحكم في نسبة استخدام الشبكة الواردة إلى تطبيق المنطق في مدخل Microsoft Azure

يمكنك عرض تطبيق المنطق الخاص بك على الويب العام والشبكة الظاهرية والتطبيقات المنطقية الأخرى في بيئتك عن طريق تمكين الدخول. يفرض Azure إعدادات الدخول من خلال مجموعة من القواعد التي تتحكم في توجيه حركة المرور الخارجية والداخلية إلى تطبيق المنطق الخاص بك. عند تمكين الدخول، لا تحتاج إلى إنشاء موازن تحميل Azure أو عنوان IP عام أو أي موارد Azure أخرى لتمكين طلبات HTTP الواردة أو حركة مرور TCP. لمزيد من المعلومات، راجع الدخول في تطبيقات الحاوية.

إشعار

عند تمكين الدخول، سيتم توجيه جميع حركة المرور إلى أحدث مراجعة افتراضيا. انتقل إلى صفحة إدارة المراجعة لتغيير إعدادات نسبة استخدام الشبكة.

1. في قائمة الموارد، ضمن Settings، حدد Ingress.

2. في صفحة Ingress ، بجوار Ingress، حدد المربع Enabled .

3. استنادا إلى السيناريو الخاص بك، قم بتكوين الخيارات المتبقية.

   لمزيد من المعلومات، راجع الوثائق التالية:

   • تكوين الدخول لتطبيقك في Azure Container Apps
   • إعداد قيود دخول IP في Azure Container Apps

إعداد المصادقة لاتصالات واجهة برمجة التطبيقات المدارة

لمصادقة اتصالات واجهة برمجة التطبيقات المدارة في مهام سير عمل تطبيق المنطق القياسي المستضافة على مجموعات Kubernetes التي تدعم Azure Arc، يجب إنشاء تسجيل التطبيق الخاص بك باستخدام معرف Microsoft Entra. يمكنك بعد ذلك إضافة قيم تسجيل التطبيق هذا كمتغيرات بيئة في مورد تطبيق المنطق القياسي لمصادقة اتصالات واجهة برمجة التطبيقات بدلا من ذلك.

إنشاء تسجيل تطبيق باستخدام معرف Microsoft Entra

مدخل Azure

1. في مدخل Microsoft Azure، اتبع التشغيل السريع: تسجيل تطبيق باستخدام النظام الأساسي للهويات في Microsoft لإنشاء تسجيل تطبيق.

2. بعد اكتمال الإنشاء، ابحث عن تسجيل التطبيق الجديد في المدخل.

3. في قائمة الموارد، حدد Overview، واحفظ القيم التالية، والتي تحتاج إليها لاحقا لمصادقة الاتصال:

   • معرف العميل
   • معرف المستأجر
   • سر العميل

4. بالنسبة إلى معرف العنصر، اتبع الخطوات التالية:

   1. في صفحة Overview ، حدد Managed application in local directory link لتسجيل التطبيق كما هو موضح:

      

   2. في الصفحة التي تفتح، انسخ قيمة معرف الكائن واحفظها:

      

5. الآن، أضف القيم المحفوظة كمتغيرات بيئة إلى مورد تطبيق المنطق القياسي.

Azure CLI

1. لإنشاء تسجيل التطبيق، استخدم الأمر az ad sp create.

2. لمراجعة جميع الخصائص، استخدم الأمر az ad sp show.

3. في الإخراج من كلا الأمرين، ابحث عن القيم التالية واحفظها، والتي تحتاج إليها لاحقا لمصادقة الاتصال:

   • معرف العميل
   • معرف الكائن
   • معرف المستأجر
   • سر العميل

4. الآن، أضف القيم المحفوظة كمتغيرات بيئة إلى مورد تطبيق المنطق القياسي.

إضافة قيم تسجيل التطبيق إلى تطبيق المنطق القياسي

1. في مدخل Microsoft Azure، انتقل إلى مورد تطبيق المنطق القياسي.

2. في قائمة الموارد، ضمن Settings، حدد Containers، ثم حدد علامة التبويب Environment variables .

   لمزيد من المعلومات حول إعدادات التطبيق وإعدادات المضيف، راجع تحرير إعدادات التطبيق وإعدادات المضيف.

3. في شريط الأدوات، حدد Edit and deploy.

4. في جزء تحرير حاوية ، حدد متغيرات البيئة، ثم حدد إضافة.

5. من الجدول التالي، أضف كل متغير بيئة بالقيمة المحددة:

   متغير البيئة	قيمة
   WORKFLOWAPP_AAD_CLIENTID	< معرف العميل الخاص بي>
   WORKFLOWAPP_AAD_OBJECTID	< معرف الكائن الخاص بي>
   WORKFLOWAPP_AAD_TENANTID	< معرف المستأجر الخاص بي>
   WORKFLOWAPP_AAD_CLIENTSECRET	< سر عميلي>

6. عندما تنتهي، حدد "Save".

تخزين ومرجع معرف العميل وسر العميل

يمكنك تخزين معرف العميل والقيم السرية للعميل في مورد تطبيق المنطق الخاص بك كأسرار ثم الرجوع إلى تلك القيم في علامة التبويب متغيرات البيئة بدلا من ذلك.

1. في مدخل Microsoft Azure، انتقل إلى مورد تطبيق المنطق الخاص بك.

2. في قائمة الموارد، ضمن Settings، حدد Secrets.

3. في شريط الأدوات، حدد إضافة.

4. في جزء إضافة بيانات سرية ، قم بتوفير المعلومات التالية لكل سر، ثم حدد إضافة:

   مفتاح	قيمة
   WORKFLOWAPP_AAD_CLIENTID	< معرف العميل الخاص بي>
   WORKFLOWAPP_AAD_CLIENTSECRET	< سر عميلي>

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

يصف القسم التالي المشكلات المعروفة حاليا وإرشادات استكشاف المشكلات الشائعة وإصلاحها.

مشاكل إعداد البيئة العامة أو نشر المدخل

لمساعدتك في تشخيص المشكلات المتعلقة بتكوين البيئة أو فشل نشر المدخل وتصحيحها، يمكنك محاولة تشغيل البرنامج النصيtroubleshoot.ps1 PowerShell المتوفر لخيار النشر المختلط.

1. انتقل إلى مستودع Azure Logic Apps GitHub: البرامج النصية/المجلد المختلط.

2. انسخ ملف troubleshoot.ps1 إلى مجلد في نفس الموقع المحلي مثل نشر تطبيق المنطق الخاص بك.

3. تشغيل البرنامج النصي باستخدام PowerShell.

مجموعات Kubernetes الممكنة بواسطة Arc

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

مضيف الدالة لا يعمل

بعد نشر تطبيق المنطق القياسي، تأكد من أن تطبيقك يعمل بشكل صحيح.

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق الخاص بك.

2. في قائمة الموارد، حدد Overview.

3. في صفحة Overview ، بجوار حقل Application Url ، حدد عنوان URL للمورد.

   إذا كان تطبيقك يعمل بشكل صحيح، يتم فتح نافذة مستعرض وتعرض الرسالة التالية:

   

   وإلا، إذا كان التطبيق الخاص بك يحتوي على أي حالات فشل، فتحقق من تشغيل جرابات AKS بشكل صحيح. من Windows PowerShell، قم بتشغيل الأوامر التالية:

   az aks get-credentials --resource-group {resource-group-name} --name {aks-cluster-name} --admin
   kubectl get ns
   kubectl get pods -n logicapps-aca-ns
   kubectl describe pod {logic-app-pod-name} -n logicapps-aca-ns 
   

   لمزيد من المعلومات، راجع الوثائق التالية:

   • az aks get-credentials
   • أداة سطر الأوامر (kubectl)

لا يحتوي نظام المجموعة على عقد كافية

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

Warning: FailedScheduling  4m52s (x29 over 46m)  default-scheduler  0/2 nodes are available: 2 Too many pods. preemption: 0/2 nodes are available: 2 No preemption victims found for incoming pod.

لزيادة عدد العقد وإعداد التحجيم التلقائي، اتبع الخطوات التالية:

1. في مدخل Microsoft Azure، انتقل إلى مثيل خدمة Kubernetes.

2. في قائمة المثيل، ضمن Settings، حدد Node pools.

3. في شريط أدوات صفحة Node tools ، حدد + Add node pool.

لمزيد من المعلومات، راجع الوثائق التالية:

• إنشاء تجمعات عقدة لنظام مجموعة في خدمة Azure Kubernetes (AKS)
• إدارة تجمعات العقد لنظام مجموعة في خدمة Azure Kubernetes (AKS)
• نظرة عامة على التحجيم التلقائي لنظام المجموعة في خدمة Azure Kubernetes (AKS)
• استخدام مقياس المجموعة التلقائي في خدمة Azure Kubernetes (AKS)

برنامج تشغيل واجهة تخزين حاويات SMB (CSI) غير مثبت

بعد تشغيل الأمر السابق kubectl describe pod ، إذا ظهر التحذير التالي، فتأكد من تثبيت برنامج تشغيل CSI لمشاركة ملف SMB بشكل صحيح:

Warning FailedScheduling 5m16s (x2 over 5m27s)  default-scheduler 0/14 nodes are available: pod has unbound immediate PersistentVolumeClaims. preemption: 0/14 nodes are available: 14 Preemption is not helpful for scheduling.

Normal NotTriggerScaleUp 9m49s (x31 over 14m) cluster-autoscaler pod didn't trigger scale-up: 3 pod has unbound immediate PersistentVolumeClaims

للتأكيد، من Windows PowerShell، قم بتشغيل الأوامر التالية:

kubectl get csidrivers

إذا لم تتضمن قائمة النتائج التي تظهر smb.csi.k8s.io، من موجه أوامر Windows، وقم بتشغيل الأمر التالي:

helm repo add csi-driver-smb
helm repo update helm install csi-driver-smb csi-driver-smb/csi-driver-smb --namespace kube-system --version v1.15.0

للتحقق من حالة CSI SMB Driver pods، من موجه أوامر Windows، قم بتشغيل الأمر التالي:

kubectl --namespace=kube-system get pods --selector="app.kubernetes.io/name=csi-driver-smb" --watch

لمزيد من المعلومات، راجع برامج تشغيل واجهة تخزين الحاويات (CSI) على خدمة Azure Kubernetes (AKS).

المحتوى ذو الصلة

• إعداد متطلبات نشر تطبيق المنطق القياسي على البنية الأساسية الخاصة بك
• تمكين بيانات تتبع الاستخدام المحسنة في Application Insights لسير العمل القياسي في Azure Logic Apps