مشاركة عبر

أتمتة الإنشاء والتوزيع لسير عمل تطبيق المنطق القياسي باستخدام Azure DevOps

  • مقالة

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

يوفر ملحق Azure Logic Apps (قياسي) أدوات لك لإنشاء وصيانة عمليات الإنشاء والتوزيع التلقائية باستخدام Azure DevOps. ومع ذلك، قبل بدء تشغيل هذه الأتمتة، ضع في اعتبارك العناصر التالية:

  • مورد تطبيق Azure logic حيث تقوم بإنشاء مهام سير العمل الخاصة بك

  • الاتصالات المستضافة من Azure التي تستخدمها مهام سير العمل ويتم إنشاؤها من موصلات تديرها Microsoft.

    تختلف هذه الاتصالات عن الاتصالات التي تعمل مباشرة وأصليا مع وقت تشغيل Azure Logic Apps.

  • الإعدادات والمعلمات المحددة للبيئات المختلفة التي تريد نشرها

يساعدك الملحق على إكمال المهام المطلوبة التالية لأتمتة الإنشاء والنشر:

  • تحديد معلمات مراجع الاتصال في وقت التصميم. تعمل هذه المهمة على تبسيط عملية تحديث المراجع في بيئات مختلفة دون قطع وظائف التطوير المحلية.

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

  • إنشاء برامج نصية تعمل على أتمتة النشر للاتصالات المستضافة من Azure.

  • قم بإعداد المعلمات الخاصة بالبيئة التي يمكنك إدخالها في حزمة Azure Logic Apps أثناء عملية الإنشاء دون كسر وظائف التطوير المحلي.

  • إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية عند الطلب باستخدام Azure DevOps لدعم نشر البنية الأساسية جنبا إلى جنب مع عمليات الإنشاء والإصدار.

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

  1. إنشاء مساحة عمل تطبيق منطقي ومشروع في Visual Studio Code يتضمن الملفات التي تنشئ مسارات لنشر البنية الأساسية والتكامل المستمر (CI) والنشر المستمر (CD).

  2. إنشاء اتصال بين مساحة العمل ومستودع Git في Azure DevOps.

  3. إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية في Azure DevOps.

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

المشكلات المعروفة والقيود

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

  • ينشئ الملحق مسارات لنشر البنية الأساسية والتكامل المستمر (CI) والنشر المستمر (CD). ومع ذلك، فأنت مسؤول عن توصيل المسارات ب Azure DevOps وإنشاء المشغلات ذات الصلة.

  • حاليا، يدعم الملحق قوالب Azure Resource Management (قوالب ARM) فقط للبرنامج النصي لتوزيع البنية الأساسية. توجد قوالب أخرى قيد التخطيط.

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

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

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

  2. في نافذة Azure ، على شريط أدوات مساحة العمل، افتح قائمة Azure Logic Apps ، وحدد Create new logic app workspace.

    تظهر لقطة الشاشة Visual Studio Code، وأيقونة Azure المحددة في القائمة اليسرى، وقسم مساحة العمل، والخيار المحدد لإنشاء مساحة عمل تطبيق منطقي جديد.

  3. اتبع المطالبات لإكمال المهام التالية:

    1. حدد المجلد لإنشاء مساحة العمل الخاصة بك.

    2. أدخل اسم مساحة العمل.

    3. حدد نوع المشروع: Logic app

    4. أدخل اسم مشروع تطبيق المنطق الخاص بك.

    5. حدد قالب سير العمل. أدخل اسم سير العمل الخاص بك.

    6. حدد ما إذا كنت تريد فتح مساحة العمل في نافذة Visual Studio Code الحالية أو نافذة جديدة.

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

  4. اتبع هذه الخطوات لفتح مصمم سير العمل:

    1. في مشروع تطبيق المنطق الخاص بك، قم بتوسيع المجلد باسم سير العمل الخاص بك.

    2. إذا لم يكن مفتوحا بالفعل، فافتح ملف workflow.json ، وافتح القائمة المختصرة للملف، وحدد Open Designer.

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

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

    4. اتبع المطالبات لتحديد هذه العناصر:

      • استخدام الموصلات من Azure

        إشعار

        إذا تخطيت هذه الخطوة، يمكنك استخدام الموصلات المضمنة المستضافة في وقت التشغيل فقط. لتمكين الموصلات التي تديرها Microsoft والمستضافة من Azure في وقت لاحق، اتبع الخطوات التالية:

        1. افتح القائمة المختصرة لملف workflow.json ، وحدد استخدام الموصلات من Azure.

        2. حدد مجموعة موارد Azure موجودة تريد استخدامها لتطبيق المنطق الخاص بك.

        3. إعادة تحميل مصمم سير العمل.

      • مجموعة موارد Azure الموجودة التي تريد استخدامها لتطبيق المنطق الخاص بك

  5. عند الانتهاء، أعد تحميل مصمم سير العمل. إذا طلب منك ذلك، فسجل الدخول إلى Azure.

    تظهر لقطة الشاشة Visual Studio Code وأيقونة Explorer المحددة في القائمة اليسرى ومشروع تطبيق المنطق ومصمم سير العمل.

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

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

بعد إنشاء سير العمل واختباره محليا، قم بإنشاء البرامج النصية للتوزيع.

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

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

  2. اتبع المطالبات لإكمال الخطوات التالية:

    1. حدد مجموعة موارد Azure الموجودة لاستخدامها لتطبيق المنطق الخاص بك.

    2. أدخل اسما فريدا لمورد تطبيق المنطق الخاص بك.

    3. أدخل اسما فريدا لمورد حساب التخزين الخاص بك.

    4. أدخل اسما فريدا لاستخدامه في خطة App Service.

    5. حدد مجلد مساحة العمل حيث تريد إنشاء الملفات.

      موقع مجلد النشر ‏‏الوصف
      مجلد نشر جديد (افتراضي) إنشاء مجلد جديد في مساحة العمل الحالية.
      اختيار مجلد آخر حدد مجلدا مختلفا في مساحة العمل الحالية.

    عند الانتهاء، ينشئ Visual Studio Code مجلدا باسم deployment/{logic-app-name} في جذر مساحة العمل الخاصة بك. يستخدم هذا المجلد نفس اسم تطبيق المنطق الذي قدمته في هذه الخطوات.

    إشعار

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

    تظهر لقطة الشاشة Visual Studio Code، وأيقونة المستكشف المحددة في القائمة اليسرى، ومشروع logic app، ومجلد البرامج النصية للتوزيع المميز مع المحتويات.

    ضمن المجلد {logic-app-name}، لديك البنية التالية:

    اسم المجلد اسم الملف ووصفه
    ADOPipelineScripts - CD-pipeline.yml: مسار التسليم المستمر الذي يحتوي على إرشادات لنشر التعليمات البرمجية لتطبيق المنطق إلى مورد تطبيق المنطق في Azure.

    - CD-pipeline-variables.yml: ملف YAML يحتوي على المتغيرات المستخدمة من قبل ملف CD-pipeline.yml.

    - CI-pipeline.yml: البنية الأساسية لبرنامج ربط العمليات التجارية للتكامل المستمر الذي يحتوي على إرشادات لإنشاء وإنشاء البيانات الاصطناعية المطلوبة لنشر مورد تطبيق المنطق إلى Azure.

    - CI-pipeline-variables.yml: ملف YAML يحتوي على المتغيرات المستخدمة من قبل ملف CI-pipeline.yml.

    - infrastructure-pipeline.yml: مسار YAML "البنية الأساسية كتعليمة برمجية" يحتوي على إرشادات لتحميل جميع قوالب ARM إلى Azure وتنفيذ الخطوات في ملف infrastructure-pipeline-template.yml.

    - infrastructure-pipeline-template.yml: ملف مسار YAML يحتوي على خطوات نشر مورد تطبيق منطقي مع جميع التبعيات المطلوبة ونشر كل اتصال مدار مطلوب بواسطة التعليمات البرمجية المصدر.

    - infrastructure-pipeline-variables.yml: مسار YAML يحتوي على جميع المتغيرات المطلوبة لتنفيذ الخطوات في ملف infrastructure-pipeline-template.yml.
    قوالب ArmTemplates - {connection-type}.parameters.json: ملف معلمات Resource Manager يحتوي على المعلمات المطلوبة لنشر اتصال مستضاف من Azure يسمى {connection-type} إلى Azure. هذا الملف موجود لكل اتصال مستضاف من Azure في سير العمل الخاص بك.

    - {connection-type}.template.json: ملف قالب Resource Manager يمثل اتصالا مستضافا من Azure يسمى {connection-reference} ويحتوي على المعلومات المستخدمة لنشر مورد الاتصال المقابل إلى Azure. هذا الملف موجود لكل اتصال مستضاف من Azure في سير العمل الخاص بك.

    - {logic-app-name}.parameters.json: ملف معلمات Resource Manager يحتوي على المعلمات المطلوبة لنشر مورد تطبيق المنطق القياسي المسمى {logic-app-name} إلى Azure، بما في ذلك جميع التبعيات.

    - {logic-app-name}.template.json: ملف قالب Resource Manager يمثل مورد تطبيق المنطق القياسي المسمى {logic-app-name} ويحتوي على المعلومات المستخدمة لنشر مورد تطبيق المنطق إلى Azure.
    معلمات سير العمل parameters.json: ملف JSON هذا هو نسخة من ملف المعلمات المحلي ويحتوي على نسخة من جميع المعلمات المعرفة من قبل المستخدم بالإضافة إلى إصدار السحابة من أي معلمات تم إنشاؤها بواسطة الملحق لتحديد معلمات الاتصالات المستضافة من Azure. يتم استخدام هذا الملف لإنشاء الحزمة التي يتم نشرها إلى Azure.

توصيل مساحة العمل بمستودع Git الخاص بك

  1. اتبع هذه الخطوات لتهيئة المستودع الخاص بك:

    1. في Visual Studio Code، في شريط النشاط، حدد أيقونة التحكم بالمصادر.

    2. في نافذة التحكم بالمصادر، حدد تهيئة المستودع.

    3. من قائمة المطالبة، حدد اختيار مجلد. حدد المجلد الجذر لمساحة العمل، ثم حدد تهيئة المستودع.

      تظهر لقطة الشاشة Visual Studio Code ونافذة التحكم بالمصادر والخيار المحدد المسمى Initialize Repository.

    4. في نافذة التحكم بالمصادر، حدد Open Repository.

    5. من قائمة المطالبة، حدد المستودع الذي أنشأته للتو.

    لمزيد من المعلومات، راجع Visual Studio Code - تهيئة مستودع في مجلد محلي.

  2. اتبع هذه الخطوات للحصول على عنوان URL لمستودع Git الخاص بك بحيث يمكنك إضافة جهاز تحكم عن بعد:

    1. في Azure DevOps، افتح مشروع الفريق لمؤسسة Azure DevOps.

    2. في القائمة اليسرى، قم بتوسيع Repos، وحدد Files.

    3. في شريط أدوات جزء الملفات ، حدد استنساخ.

      تظهر لقطة الشاشة مشروع فريق Azure DevOps ومستودع Git والخيار المحدد المسمى Clone.

    4. في نافذة Clone Repository ، انسخ إصدار HTTPS من عنوان URL الخاص بالاستنساخ.

      لمزيد من المعلومات، راجع الحصول على عنوان URL المستنسخ لمستودع Git الخاص بك في Azure Repos.

  3. اتبع هذه الخطوات لإضافة جهاز تحكم عن بعد لمستودع Git الخاص بك:

    1. ارجع إلى Visual Studio Code وإلى نافذة التحكم بالمصادر.

    2. ضمن مستودعات التحكم بالمصادر، من شريط أدوات المستودع، افتح قائمة علامات الحذف (...) وحدد Remote>Add remote.

      تظهر لقطة الشاشة Visual Studio Code ونافذة التحكم بالمصادر والخيار المحدد المسمى Add remote.

  4. في المطالبة، الصق عنوان URL المنسخ، وأدخل اسما لجهاز التحكم عن بعد، الذي يكون عادة أصل.

    لقد أنشأت الآن اتصالا بين Visual Studio Code ومستودعك.

  5. قبل إعداد البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك في القسم التالي، افتح ملف CD-pipeline.yml ، وأعد تسمية CI Pipeline في السمة source لمطابقة اسم مسار CI الذي تريد استخدامه.

    تظهر لقطة الشاشة Visual Studio Code ونافذة التحكم بالمصادر وملف CD-pipeline.yml المفتوح وحقل المصدر المميز لاسم مسار CI.

  6. في نافذة التحكم بالمصادر، قم بتثبيت التغييرات ونشرها في المستودع.

    لمزيد من المعلومات، راجع مرحلة وتنفيذ تغييرات التعليمات البرمجية.

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

لإنشاء البنية الأساسية جنبا إلى جنب مع البنية الأساسية لبرنامج ربط العمليات التجارية CI وCD في Azure DevOps، كرر الخطوات التالية لكل ملف من ملفات البنية الأساسية لبرنامج ربط العمليات التجارية التالية:

  • infrastructure-pipeline.yml لمسار "البنية الأساسية كتعلم برمجي".
  • CI-pipeline.yml لمسار التكامل المستمر.
  • CD-pipeline.yml لمسار التسليم المستمر.

قم بإعداد تدفق

  1. في Azure DevOps، ارجع إلى مشروع الفريق وإلى جزء Repos>Files.

  2. في جزء Files ، حدد Set up build.

    تظهر لقطة الشاشة مشروع فريق Azure DevOps ومستودع Git والخيار المحدد المسمى Set up build.

  3. في جزء Inventory your pipeline ، تأكد من معلومات المستودع، وحدد Configure pipeline.

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

  4. في جزء Configure your pipeline ، حدد Existing Azure Pipelines YAML file.

    تظهر لقطة الشاشة صفحة تكوين لتحديد نوع مسار.

  5. في جزء تحديد ملف YAML موجود، اتبع الخطوات التالية لتحديد ملف Infrastructure-pipeline.yml :

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

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

      deployment/{logic-app-name}/ADOPipelineScripts/{infrastructure-pipeline-name}.yml

    3. عندما تكون مستعدا، حدد متابعة.

      لقطة شاشة تعرض جزء تحديد ملف YAML موجود.

  6. في جزء Configure your pipeline ، حدد Review pipeline.

  7. في جزء Review your governed pipeline ، قم بتوفير المعلومات التالية:

    • اسم المسار: أدخل اسما للبنية الأساسية لبرنامج ربط العمليات التجارية.
    • مجلد البنية الأساسية لبرنامج ربط العمليات التجارية: حدد المجلد الخاص بمكان حفظ البنية الأساسية لبرنامج ربط العمليات التجارية، والذي يسمى ./deployment/{logic-app-name}/pipelines.

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

    تظهر لقطة الشاشة الجزء المسمى Review governed pipeline.

عرض البنية الأساسية لبرنامج ربط العمليات التجارية وتشغيلها

للبحث عن البنية الأساسية لبرنامج ربط العمليات التجارية وتشغيلها، اتبع الخطوات التالية:

  1. في القائمة اليسرى لمشروع فريقك، قم بتوسيع Pipelines، وحدد Pipelines.

  2. حدد علامة التبويب الكل لعرض كافة المسارات المتوفرة. ابحث عن البنية الأساسية لبرنامج ربط العمليات التجارية وحددها.

  3. على شريط أدوات البنية الأساسية لبرنامج ربط العمليات التجارية، حدد تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية.

    تظهر لقطة الشاشة جزء البنية الأساسية لبرنامج ربط العمليات التجارية التي تم إنشاؤها والخيار المحدد لتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية.

لمزيد من المعلومات، راجع إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية الأولى.

(راجع أيضًا )