مشاركة عبر

أتمتة البنية الأساسية لبرنامج ربط العمليات التجارية والبنية الأساسية لتطبيق المنطق وCI وCD في بيئات مختلفة

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

لتجنب إعادة إنشاء تطبيقات المنطق وإعادة تعيين عمليات الأعمال إلى عمليات سير عمل التطبيق المنطقي عند النشر في بيئات مختلفة، يمكنك إنشاء مسارات باستخدام Azure DevOps. تقوم المسارات بجميع الأعمال لأتمتة إنشاء البنية الأساسية والتكامل المستمر (CI) والنشر المستمر (CD). تنشئ هذه المسارات موارد لتطبيقات المنطق والعمليات التجارية وتعيينات بين مراحل عمليات الأعمال وعمليات سير العمل، وإعداد تتبع المعاملات في بيئات التوزيع الخاصة بك للتطوير والاختبار والإنتاج.

يوضح هذا الدليل كيفية إكمال المهام التالية:

  • إنشاء وتشغيل خطوط أنابيب للبنية الأساسية لتطبيق المنطق القياسي وCI وCD باستخدام Azure Logic Apps Standard Tasks ل Azure DevOps.

  • قم بإعداد عملية عملك ل CI وCD.

  • إنشاء وتشغيل خطوط أنابيب للبنية الأساسية لعملية العمل و CI و CD باستخدام Azure Logic Apps Standard Tasks ل Azure DevOps.

  • قم بتحديث وتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CI وCD بعد تكوين المكونات الضرورية الأخرى.

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

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

  • Visual Studio Code مثبت مع ملحق Azure Logic Apps (قياسي) والمتطلبات الأساسية المطلوبة.

    لمزيد من المعلومات، راجع إنشاء مهام سير عمل تطبيق المنطق القياسي باستخدام Visual Studio Code.

  • مساحة عمل Visual Studio Code مع مشروع تطبيق المنطق القياسي غير المنشور.

  • مؤسسة Azure DevOps ومشروع ومستودع Git حيث تقوم بتخزين التعليمات البرمجية المصدر والبيانات الاصطناعية.

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

    إذا لم يكن لديك مستودع، فاتبع الخطوات الواردة في إنشاء مستودع Git جديد في مشروعك. لإنشاء مستودع، تحتاج إلى حساب GitHub أو حساب Microsoft ومؤسسة Azure DevOps ومشروع Azure DevOps حيث لديك أذونات المسؤول، مثل أذونات مسؤول مجموعة المشاريع .

  • أحدث ملحق Azure Logic Apps Standard Tasks ل Azure Pipelines في مشروع Azure DevOps.

    يوفر هذا الملحق مهام تلقائية وبناء واتصالات ونشر وإصدار ل Azure Logic Apps (قياسي). للحصول على معلومات الملحق والمتطلبات الأساسية للمهمة، راجع Azure Logic Apps Standard Tasks.

  • أذونات دور المستخدم المناسبة لإنشاء اتصال خدمة أو عرضه أو استخدامه أو إدارته بين المسارات التي تقوم بإنشائها لاحقا في هذه المقالة.

    لمزيد من المعلومات، راجع تعيين أمان اتصال الخدمة في Azure Pipelines.

استنساخ المستودع الخاص بك في Azure DevOps

بعد إنشاء مستودع، انسخ المستودع إلى الكمبيوتر بحيث يمكنك إجراء التغييرات ودفعها في المستودع المحلي إلى المستودع الأصلي في Azure DevOps:

  1. استنساخ المستودع إلى الكمبيوتر الخاص بك.

    يظهر المثال التالي مستودعا في Azure DevOps مع الفرع الافتراضي المسمى main. قد يكون لدى مستودع فريقك في Azure DevOps فرع افتراضي باسم مختلف.

    تظهر لقطة الشاشة Azure DevOps وصفحة الملفات وزر Clone المحدد.

  2. انسخ عنوان URL الخاص باستنساخ HTTPS واحفظه لاستخدامه لاحقا.

  3. في Visual Studio Code، افتح مشروع تطبيق المنطق القياسي.

  4. من قائمة "Terminal"، حدد "New Terminal".

  5. من موجه الأوامر، انتقل إلى المجلد الذي يحتوي على ملف مساحة عمل المشروع.

    مساحة العمل هي ملف نصي يحتوي على ملحق .code-workspace . للعثور على المجلد الذي يحتوي على هذا الملف، في المجلد الجذر للمشروع، افتح المجلد المسمى .vscode.

  6. من موجه الأوامر، قم بتشغيل أوامر Git التالية لإعداد المستودع المحلي الخاص بك، ولقطة مشروع تطبيق المنطق الخاص بك، وربط المستودع المحلي الخاص بك إلى المستودع في Azure DevOps، وإنشاء فرع افتراضي في المستودع المحلي الذي يشير إلى الفرع الافتراضي للم repo في Azure DevOps:

    git init
    git add -A
    git commit -m "<your-commit-comment>"
    git remote add origin <clone-URL>
    git push --set-upstream origin main

    تكمل هذه الأوامر المهام التالية:

    1. إنشاء مستودع محلي فارغ.

    2. أضف جميع الملفات الجديدة أو تحريرها من المجلد الحالي إلى الفهرس، وهي منطقة مرحلي أو ذاكرة تخزين مؤقت في المستودع المحلي.

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

    4. إنشاء ارتباط بين المستودع المحلي والم repo في Azure DevOps.

      في هذا المثال، يربط أمر Git git remote add origin <clone-URL> المستودع المحلي إلى المستودع في Azure DevOps الذي يستخدم <clone-URL>. يقوم الأمر أيضا بتعيين الأصل باسم مستعار يمكنك استخدامه لاحقا لهذا المستودع.

    5. أنشئ فرعا افتراضيا في المستودع المحلي، وهو أمر أساسي في هذا المثال، وقم بإعداد التتبع بين هذا الفرع والم repo في Azure DevOps.

    لمزيد من المعلومات، راجع مرجع Git.

  7. في المطالبة، قم بتوفير بيانات اعتماد Git الخاصة بك إلى Git Credential Manager.

إنشاء برامج نصية للتوزيع

الآن، قم بإنشاء برامج نصية للتوزيع من مشروع تطبيق المنطق الخاص بك. تتيح لك هذه المهمة إنشاء الملفات لإنشاء مورد تطبيق المنطق الخاص بك جنبا إلى جنب مع البنية الأساسية لبرنامج ربط العمليات التجارية CI وCD لأتمتة الإنشاء والنشر لتطبيق المنطق الخاص بك في Azure. لمزيد من المعلومات، راجع أتمتة الإنشاء والتوزيع لسير عمل تطبيق المنطق القياسي باستخدام Azure DevOps.

  1. إذا لم يكن مشروع تطبيق المنطق مرئيا حاليا، في Visual Studio Code، على شريط النشاط، حدد Explorer.

  2. في نافذة Explorer ، افتح القائمة المختصرة لمجلد المشروع، وحدد Generate deployment scripts.

  3. اتبع المطالبات لتوفير معلومات النشر التالية كما هو مطلوب لتطبيق المنطق الخاص بك:

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

    تنشئ عملية إنشاء البرنامج النصي للتوزيع مجلد نشر يحتوي على ملفات للبنية الأساسية و CI و CD مع ملفات المعلمات، على سبيل المثال:

    تظهر لقطة الشاشة Visual Studio Code وملفات البرنامج النصي للتوزيع التي تم إنشاؤها.

  4. من موجه الأوامر، قم بتشغيل أوامر Git التالية لإضافة التحديثات المحلية وحفظها ودفعها إلى Azure DevOps:

    git add -A
    git commit -m "<your-commit-comment>"
    git push

    لمزيد من المعلومات، راجع مرجع Git.

إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية لتطبيق المنطق

لهذه المهمة، راجع الخطوات العامة في إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية الأولى بالخطوات التالية:

  1. في مشروع Azure DevOps، في قائمة المشروع، حدد Pipelines>Pipelines.

  2. في صفحة Pipelines ، حدد Create pipeline، أو New pipeline إذا كانت المسارات موجودة، على سبيل المثال:

    تظهر لقطة الشاشة مشروع Azure DevOps وصفحة Pipelines والزر المحدد للبنية الأساسية لبرنامج ربط العمليات التجارية الجديدة.

  3. في علامة التبويب تحديد ، حدد نوع المستودع والم مستودع لاستخدامه.

    يحدد هذا المثال Azure DevOps.

  4. في علامة التبويب Inventory ، حدد Production أو Non-production، ثم حدد Configure pipeline.

  5. في علامة التبويب Configure ، حدد Existing Azure Pipeline YAML file.

  6. بالنسبة إلى Branch، ابحث عن الفرع وحدده باستخدام ملفات البرنامج النصي للتوزيع.

    يحدد هذا المثال الفرع الرئيسي .

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

  7. بالنسبة إلى Path، ابحث عن ملف infrastucture-pipeline.yaml وحدده في الموقع التالي:

    /pipelines/infrastructure-pipeline.yaml

  8. حدد Continue>Review pipeline. أدخل اسما للبنية الأساسية لبرنامج ربط العمليات التجارية. مجلد البنية الأساسية لبرنامج ربط العمليات التجارية اختياري.

  9. لإكمال هذه المهمة، حدد حفظ.

إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية CI لتطبيق المنطق الخاص بك

  1. اتبع الخطوات الواردة في إنشاء مسار للبنية الأساسية لتطبيق المنطق حتى تحدد مسار ملف تدفق CI.

  2. بالنسبة إلى Path، ابحث عن ملف CI-pipeline.yaml وحدده في الموقع التالي:

    /pipelines/CI-pipeline.yaml

  3. حدد Continue>Review pipeline. أدخل اسما للبنية الأساسية لبرنامج ربط العمليات التجارية. مجلد البنية الأساسية لبرنامج ربط العمليات التجارية اختياري.

  4. لإكمال هذه المهمة، حدد حفظ.

إنشاء مسار CD لتطبيق المنطق الخاص بك

  1. اتبع الخطوات الواردة في إنشاء مسار للبنية الأساسية لتطبيق المنطق حتى تحدد مسار ملف مسار CD.

  2. بالنسبة إلى Path، ابحث عن ملف CD-pipeline.yaml وحدده في الموقع التالي:

    /pipelines/CD-pipeline.yaml

  3. حدد Continue>Review pipeline. أدخل اسم البنية الأساسية لبرنامج ربط العمليات التجارية. مجلد البنية الأساسية لبرنامج ربط العمليات التجارية اختياري.

  4. لإكمال هذه المهمة، حدد حفظ.

إنشاء اتصال خدمة

اتصال الخدمة هو اتصال مصادق عليه بين المسارات والخدمات الخارجية أو البعيدة التي تستخدمها لإكمال المهام. في هذا السيناريو، يتيح اتصال الخدمة لمسارات CI/CD إنشاء الموارد وإدارتها في Azure. تنشئ هذه الخطوات تسجيل تطبيق Microsoft Entra ID لاستخدامه كبيانات اعتماد مصادقة. لمزيد من المعلومات، راجع إنشاء اتصال خدمة Azure Resource Manager الذي يستخدم اتحاد هوية حمل العمل.

  1. في مشروع Azure DevOps، انتقل إلى Project settings>Pipelines>Service connections.

  2. حدد Create service connection. في جزء New service connection ، حدد Azure Resource Manager كنوع اتصال الخدمة، ثم حدد Next.

  3. في جزء New Azure service connection ، قم بتوفير المعلومات التالية:

    المعلمة القيمة أو الوصف
    نوع الهوية تسجيل التطبيق (تلقائي)
    بيانات الاعتماد اتحاد هوية حمل العمل (مستحسن)
    مستوى النطاق الاشتراك
    الاشتراك اشتراك Azure الخاص بك.
    مجموعة الموارد مجموعة موارد Azure.
    اسم اتصال الخدمة اسم اتصال الخدمة.

  4. عندما تنتهي، حدد حفظ.

  5. لاحظ اسم تسجيل تطبيق Microsoft Entra ID الذي تم إنشاؤه.

البحث عن تسجيل تطبيق Microsoft Entra ID

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

  1. في مربع البحث في مدخل Microsoft Azure، أدخل اسم تطبيق معرف Microsoft Entra.

  2. تأكد من أن تطبيق معرف Microsoft Entra لديه حق وصول المساهم لمجموعة الموارد. إذا لم يكن الأمر كما هو، فعين هذا الوصول.

تحديث مسارات تطبيق المنطق مع اتصال الخدمة

الآن، حدد اتصال الخدمة لاستخدامه مع مسارات تطبيق المنطق الخاص بك.

  1. في كل ملف مسار مدرج، ابحث عن الخاصية المسماة serviceConnectionName.

    • البنية الأساسية لبرنامج ربط العمليات التجارية: تحديث ملف infrastructure-pipeline-variables.yml .
    • CI pipeline: تحديث ملف CI-pipeline-variables.yml .
    • مسار CD: تحديث ملف CD-pipeline-variables.yml .

  2. بالنسبة للخاصية serviceConnectionName ، قم بتعيين القيمة إلى اسم اتصال الخدمة.

  3. في ملف CI-pipeline-variables.yml ، أضف خاصية جديدة باسم subscriptionId، وقم بتعيين قيمة الخاصية إلى معرف اشتراك Azure، على سبيل المثال:

    subscriptionId: '<Azure-subscription-ID>'

  4. تأكد من حفظ جميع ملفات البنية الأساسية لبرنامج ربط العمليات التجارية المحدثة.

  5. من موجه الأوامر، قم بتشغيل أوامر Git التالية لإضافة التحديثات المحلية وحفظها ودفعها إلى Azure DevOps:

    git add -A
    git commit -m "<your-commit-comment>"
    git push

    لمزيد من المعلومات، راجع مرجع Git.

تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية لتطبيق المنطق الخاص بك

لإنشاء مورد تطبيق المنطق القياسي في Azure، اتبع الخطوات التالية:

  1. في Azure DevOps، افتح البنية الأساسية للتطبيق المنطقي، وحدد Edit، وحدد الفرع المناسب، ثم حدد Run.

  2. إذا طلب منك ذلك، فقم بتوفير الأذونات اللازمة لتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية.

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

تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CI وCD لتطبيق المنطق الخاص بك

  1. قبل تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CD، قم بتحديث مسار CD لتضمين قيمة المصدر، وهو اسم مسار CI الخاص بك.

    يمكنك الالتزام مباشرة بالفرع، ولكن بعد ذلك قم بتشغيل git pull على المصدر المحلي لمزامنة هذا التغيير محليا.

  2. في Azure DevOps، قم بتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CI، ثم قم بتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CD.

  3. إذا طلب منك ذلك، فقم بتوفير الأذونات اللازمة لتشغيل المسارات.

بعد اكتمال البنية الأساسية لبرنامج ربط العمليات التجارية CD، يتم نشر المحتوى من مشروع تطبيق المنطق القياسي إلى مورد تطبيق المنطق الذي تم إنشاؤه مسبقا في مدخل Microsoft Azure.

إعداد عملية عملك ل CI وCD

بعد إنشاء مورد تطبيق منطق قياسي عامل ونشره في Azure، يمكنك تحديد مراحل عملية عملك وتعيينها لعمليات سير العمل حتى تتمكن من البدء في تعقب المعاملات. بعد إعداد عملية العمل ونشرها واختبارها، يمكنك إعداد عملية الأعمال ل CI/CD.

  1. في مدخل Microsoft Azure، ابحث عن مورد عملية العمل وافتحه.

  2. في قائمة التنقل بين الموارد، حدد Overview. على شريط الأدوات، حدد تصدير لاستخراج محتوى النشر كملف .zip.

    يحتوي ملف .zip هذا على قوالب Azure Resource Manager وملفات المعلمات ومسارات موارد عملية الأعمال التي يمكنك استخدامها لتوفير البنية الأساسية وعملية CI/CD في Azure DevOps.

  3. في Visual Studio Code، انتقل إلى مجلد نشر مشروع تطبيق المنطق، الذي تم إنشاؤه بعد إنشاء برامج نصية للتوزيع للمشروع، وأنشئ مجلدا باسم businessprocesses.

  4. استخرج ملف .zip المصدر، وأضف مجلدات عمليات الأعمال إلى مجلد عمليات الأعمال ، بحيث تبدو بنية مجلد المشروع مشابهة للمثال التالي:

    \deployment\businessprocesses\<business-process-name>

    تظهر لقطة الشاشة Visual Studio Code ومجلدات مشروع عملية الأعمال المصدرة.

تحديث متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية

الآن، قم بتحديث ملف business-process-pipelines-variables.yml لاستخدام اتصال الخدمة الذي تم إنشاؤه مسبقا.

  1. في Visual Studio Code، انتقل إلى مشروع تطبيق المنطق الخاص بك، وابحث عن مجلد المسارات ، وافتح الملف المسمى business-process-pipelines-variables.yml في نهاية هذا المسار:

    deployment\businessprocesses\<business-process-name>\pipelines\

    يحتوي ملف business-process-pipelines-variables.yml على عقدة تسمى businessProcessMapping. تتضمن هذه العقدة مراجع إلى تعيينات مرحلة عملية العمل وتطبيقات المنطق المحددة. تحتوي هذه المراجع على مسارات مع معرفات اشتراك Azure وأسماء مجموعات الموارد والتطبيقات المنطقية.

    ملاحظة

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

    هام

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

    تأكد من تخزين هذه المعلومات بأمان باستخدام معرف Microsoft Entra وAzure Key Vault. لا تقم بترميز هذه المعلومات أو مشاركتها مع مستخدمين آخرين أو حفظها في نص عادي في أي مكان يمكن للآخرين الوصول إليه. قم بإعداد خطة لتدوير الأسرار أو إبطالها في حالة تعرضها للخطر. لمزيد من المعلومات، راجع الموارد التالية:

  2. في ملف business-process-pipelines-variables.yml ، ابحث عن الخاصية serviceConnectionName ، وقم بتعيين قيمة الخاصية إلى اسم اتصال الخدمة.

  3. من موجه الأوامر، قم بتشغيل أوامر Git التالية لإضافة وحفظ جميع التغييرات المحلية إلى الملفات المتعقبة والدفع إلى Azure DevOps:

    git add -A
    git commit -a "<your-commit-comment>"
    git push

    لمزيد من المعلومات، راجع مرجع Git.

بعد الانتهاء من هذه الخطوات، تظهر مسارات عملية العمل الآن في مستودع Azure DevOps.

تظهر لقطة الشاشة Azure DevOps repo مع مسارات عمليات الأعمال التي تم تحميلها.

إعداد الأذونات والوصول إلى Azure Data Explorer

يستخدم Azure Business Process Tracking Azure Data Explorer كمخزن بيانات الخلفية. لذلك، تحتاج إلى التأكد من أن اتصال الخدمة الخاص بك يمكنه الاتصال بمجموعة Data Explorer وقاعدة البيانات والجداول والوصول إليها وتحديثها من خلال إكمال الخطوات التالية:

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

  1. في مجموعة Azure Database Explorer، انتقل إلى قاعدة بيانات Data Explorer.
  2. في قائمة قاعدة البيانات، ضمن Overview، حدد Permissions.
  3. أضف اتصال الخدمة، وقم بتعيين دور مسؤول قاعدة البيانات .

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

إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك

  1. اتبع الخطوات الواردة في إنشاء مسار للبنية الأساسية لتطبيق المنطق حتى تحدد مسار ملف البنية الأساسية لعملية الأعمال.

  2. بالنسبة إلى Path، ابحث عن ملف infrastucture-business-process-pipeline.yaml وحدده في الموقع التالي:

    التوزيع/العمليات التجارية/<اسم>/البنية الأساسية لبرنامج ربط العمليات التجارية/

  3. حدد Continue>Review pipeline. أدخل اسما لمجلد البنية الأساسية لبرنامج ربط العمليات التجارية والمسار.

  4. لإكمال هذه المهمة، حدد حفظ.

تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك

لإنشاء مورد عملية الأعمال في Azure، اتبع الخطوات التالية:

  1. في Azure DevOps، افتح البنية الأساسية لعملية العمل، وحدد Edit، وحدد الفرع المناسب، ثم حدد Run.

  2. إذا طلب منك ذلك، فقم بتوفير الأذونات اللازمة لتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية.

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

إنشاء مسار CD لعملية عملك

  1. اتبع الخطوات الواردة في إنشاء مسار للبنية الأساسية لتطبيق المنطق حتى تحدد مسار ملف مسار CD لعملية الأعمال.

  2. بالنسبة إلى Path، ابحث عن ملف deploy-business-process-pipeline.yaml وحدده في الموقع التالي:

    التوزيع/العمليات التجارية/<اسم>/البنية الأساسية لبرنامج ربط العمليات التجارية/

  3. حدد Continue>Review pipeline. أدخل اسما لمجلد البنية الأساسية لبرنامج ربط العمليات التجارية والمسار.

  4. لإكمال هذه المهمة، حدد حفظ.

تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CD لعملية عملك

لنشر محتوى من عملية العمل التي تم نشرها مسبقا إلى مورد عملية العمل الجديد في Azure، اتبع الخطوات التالية:

  1. في Azure DevOps، افتح مسار CD لعملية العمل، وحدد Edit، وحدد الفرع المناسب، ثم حدد Run.

  2. إذا طلب منك ذلك، فقم بتوفير الأذونات اللازمة لتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية.

تحديث مسار CI للتطبيق المنطقي مع مهمة عملية الأعمال

الآن، قم بتحديث مسار CI لتطبيق المنطق لاستخدام المهمة المسماة Azure Logic Apps (قياسي) Business Process Artifacts Build. يستخرج مسار CI للتطبيق المنطقي محتوى ملف تعريف التعقب من عملية العمل المنشورة ويتضمن هذا المحتوى في عمليات نشر تطبيق المنطق اللاحقة. يحتوي ملف تعريف التعقب هذا على إرشادات يستخدمها وقت تشغيل Azure Logic Apps (قياسي) لإرسال بيانات العمل إلى Azure Data Explorer.

ملاحظة

وفقا للمتطلبات الأساسية لهذا الدليل، تأكد من تثبيت أحدث ملحق المهام القياسية لتطبيقات Azure Logic ل Azure Pipelines في مشروع Azure DevOps.

  1. في Azure DevOps، افتح مسار CI للتطبيق المنطقي، وحدد Edit.

  2. في جزء المهام ، ابحث عن Azure Logic Apps (Standard) Business Process Artifacts Build وحدده.

  3. في جزء المعلمات أو في محرر ملف YAML، قم بتوفير قيم المعلمات التالية كما هو موضح في الجدول:

    تلميح

    عند تعيين قيم المعلمات هذه، حاول استخدام محرر الملفات في المستعرض بدلا من ذلك. يجعل المحرر إعادة استخدام المعلمات من مكان آخر في الحل أسهل وأكثر ملاءمة.

    المعلمة اسم YAML مطلوب القيمة الوصف
    اتصال خدمة Azure connectedServiceNameARM نعم < اسم اتصال الخدمة> جزء المعلمات:

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

    2. حدد تخويل.

    3. حدد اتصال الخدمة.

    لمزيد من المعلومات، راجع إنشاء اتصال خدمة.
    اسم تطبيق المنطق القياسي appName نعم < اسم التطبيق المنطقي> اسم تطبيق المنطق القياسي الحالي.
    معرف الاشتراك subscriptionId نعم < معرف الاشتراك> معرف اشتراك Azure الخاص بك.
    المجلد الهدف targetFolder نعم < اسم التطبيق المنطقي> اسم المجلد الذي يحتوي على تطبيق المنطق القياسي. المجلد الذي يحتوي على تطبيق المنطق القياسي وهو نفس مجلد المعلمة sourceFolder لمهمة AzureLogicAppsStandardBuild .
    مجلد التوزيع deploymentFolder لا < اسم التطبيق المنطقي> المجلد الذي يحتوي على مجلد workflowparameters ، والذي يحتوي على ملف parameters.json لتطبيق المنطق الخاص بك.
    مسار ملف إعدادات التطبيق stagingAppSettingsFilePath لا راجع المثال. المسار إلى ملف إعدادات التطبيق الذي تنشئه المهمة. يتضمن هذا الملف إعدادات التطبيق لمراحلي عملية العمل التي تم تعيينها لعمليات سير عمل تطبيق المنطق المحددة.

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

    لمزيد من المعلومات، راجع Azure Logic Apps Standard Business Process Artifacts Build Task.

  4. عند الانتهاء، تأكد من ظهور المقطع task المسمى AzureLogicAppsStandardBusinessProcessArtifactsBuild@0 أسفل العقدة المسماة steps: وفوق المسماة taskAzureLogicAppsStandardBuild@، على سبيل المثال:

    jobs:
  - job: logic_app_build
    displayName: 'Build and publish logic app'
    steps:
      - task: AzureLogicAppsStandardBusinessProcessArtifactsBuild@0
        inputs:
          connectedServiceNameARM: '$(serviceConnectionName)'
          appName: '$(logicAppName)'
          subscriptionId: '$(subscriptionId)'
          targetFolder: '$(Build.SourcesDirectory)/$(logicAppName)'
          deploymentFolder: '$(System.DefaultWorkingDirectory)/deployment/$(logicAppName)/'
          stagingAppSettingsFilePath: '$(Build.ArtifactStagingDirectory)/appsettings_businessprocess_$(Build.BuildId).json'
      - task: AzureLogicAppsStandardBuild@0
        displayName: 'Azure Logic Apps Standard Build'
        inputs:
          sourceFolder: '$(Build.SourcesDirectory)/$(logicAppName)'
          deploymentFolder: '$(System.DefaultWorkingDirectory)/deployment/$(logicAppName)/'
          archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'

  5. عندما تنتهي، حدد إضافة.

  6. في المحرر، قم بتحديث قيمة المعلمة targetPath إلى '$(Build.ArtifactStagingDirectory)'.

    - task: PublishPipelineArtifact@1
  displayName: 'Publish logic app zip artifact'
  inputs:
     targetPath: '$(Build.ArtifactStagingDirectory)'
     artifact: '$(logicAppCIArtifactName)'
     publishLocation: 'pipeline'

  7. عند الانتهاء، حدد التحقق من الصحة والحفظ.

تحديث مسار القرص المضغوط للتطبيق المنطقي باستخدام إعدادات التطبيق

توفر إعدادات التطبيق لتطبيق المنطق القياسي معلومات إعداد مهمة لوقت تشغيل Azure Logic Apps (قياسي) لإرسال البيانات إلى Azure Data Explorer. يتطلب مسار التسليم المستمر للتطبيق المنطقي التغييرات التالية:

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

  2. في محرر ملفات YAML، قم بتعيين الخاصية appSettings إلى القيمة التالية:

    '$(Pipeline.Workspace)/cipipeline/$(logicAppCIArtifactName)/appsettings_businessprocess_$(resources.pipeline.cipipeline.runID).json'

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

    - task: AzureLogicAppsStandardRelease@0
  displayName: 'Azure Logic Apps Standard Release'
  inputs:
     connectedServiceName: '$(serviceConnectionName)'
     appName: '$(logicAppName)'
     resourceGroupName: '$(resourceGroupName)'
     appSettings: '$(Pipeline.Workspace)/cipipeline/$(logicAppCIArtifactName)/appsettings_businessprocess_$(resources.pipeline.cipipeline.runID).json'
     package: '$(Pipeline.Workspace)/cipipeline/$(logicAppCIArtifactName)/$(resources.pipeline.cipipeline.runID).zip'

  3. عند الانتهاء، حدد التحقق من الصحة والحفظ.

  4. للحفاظ على تحديث المستودع المحلي الخاص بك بأحدث التغييرات في مستودع Azure DevOps، قم بتشغيل أمر Git التالي: git pull

تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CI وCD لتطبيق المنطق المحدث

  1. في Azure DevOps، قم بتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CI، ثم قم بتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية CD.

  2. إذا طلب منك ذلك، فقم بتوفير الأذونات اللازمة لتشغيل المسارات.

الآن بعد أن أكملت النشر لعمليات عملك وتطبيقات المنطق المحدثة، اختبر الحل للتحقق من تسجيل المعاملات.

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

إذا واجهت مشاكل عند تشغيل المعاملات، فتحقق من المناطق التالية للتأكد من صحة الإعداد.

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

  • بعد تشغيل مسار CD لتطبيق المنطق الذي يتضمن ملفات تعريف التعقب، يتضمن تطبيق المنطق المنشور معلمة جديدة تبدأ بالبادئة التالية:

    VersionForBusinessProcess-<business-process-name>

  • تأكد من وجود إعدادات التطبيق التالية في مورد تطبيق المنطق الخاص بك:

    1. في قائمة موارد تطبيق المنطق، ضمن Settings، حدد Environment variables.

    2. في علامة التبويب إعدادات التطبيق ، ابحث عن الإعدادات الجديدة التالية:

      • Workflows.BusinessEventTracking.DataExplorer.<BusinessProcessName>. اسم الجدول
      • Workflows.BusinessEventTracking.DataExplorer.<BusinessProcessName>. IngestConnectionString
      • Workflows.BusinessEventTracking.DataStore
      • Workflows.BusinessEventTracking.Enabled

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