استخدام Azure DevOps لإنشاء خط أنابيب CI/CD لمهمة Stream Analytics

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

في هذه المقالة، ستتعرف على كيفية إنشاء خطوط أنابيب Azure DevOpsوإصدارها باستخدام أدوات Ci/CD الخاصة ب Azure Stream Analytics.

تنفيذ مشروع "تحليلات البث"

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

تستخدم الخطوات الواردة في هذه المقالة مشروع "شفرة Visual Studio تحليلات البث". إذا كنت تستخدم مشروعا Visual Studio، فاتبع الخطوات الواردة في أتمتة عمليات إنشاء مهمة Azure Stream Analytics واختباراتها ونشرها باستخدام أدوات CI/CD.

أنشئ بناء خط أنابيب

في هذا القسم، ستتعرف على كيفية إنشاء خط أنابيب إنشاء.

1. افتح مستعرض ويب وانتقل إلى مشروعك في Azure DevOps.

2. ضمن خطوط الأنابيب في قائمة التنقل اليمنى، حدد عمليات الإنشاء. ثم حدد خط أنابيب جديد.

   

3. حدد استخدام المحرر الكلاسيكي لإنشاء خط أنابيب بدون YAML.

4. حدد نوع المصدر ومشروع الفريق والمستودع. ثم حدد Continue.

   

5. في الصفحة اختيار قالب ، حدد إفراغ المهمة.

تثبيت حزمة npm

1. في صفحة المهام ، حدد علامة الجمع الموجودة بجوار مهمة العامل 1. أدخل npm في البحث عن المهام وحدد npm.

   

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

   install -g azure-streamanalytics-cicd
   

   

اتبع الخطوات التالية إذا كنت بحاجة إلى استخدام وكيل Linux المستضاف:

1. حدد مواصفات الوكيل الخاص بك

   

2. في صفحة المهام ، حدد علامة الجمع الموجودة بجوار مهمة العامل 1. أدخل سطر الأوامر في البحث عن المهام وحدد سطر الأوامر.

   

3. امنح المهمة اسم عرض. أدخل الأمر التالي في البرنامج النصي. اترك الخيارات الافتراضية المتبقية.

   sudo npm install -g azure-streamanalytics-cicd --unsafe-perm=true --allow-root
   

   

إضافة مهمة إنشاء

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

   اسم المتغير	القيمة
   مشروعروتباث	[اسم مشروعك]
   مسار الإخراج	المخرجات
   نشر المسار	نشر

2. في صفحة المهام ، حدد علامة الجمع الموجودة بجوار مهمة العامل 1. ابحث عن سطر الأوامر.

3. قم بإعطاء المهمة اسم عرض وأدخل البرنامج النصي التالي. قم بتعديل البرنامج النصي باستخدام اسم المستودع واسم المشروع.

   azure-streamanalytics-cicd build -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(deployPath)
   

   تستخدم الصورة أدناه مشروع شفرة Visual Studio Stream Analytics كمثال.

   

إضافة مهمة اختبار

1. في صفحة المتغيرات ، حدد + إضافةفي متغيرات خط الأنابيب. أضف المتغيرات التالية. قم بتعديل القيم باستخدام مسار الإخراج واسم المستودع.

   اسم المتغير	القيمة
   testPath	الاختبار

   

2. في صفحة المهام ، حدد علامة الجمع الموجودة بجوار مهمة العامل 1. ابحث عن سطر الأوامر.

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

   راجع إرشادات الاختبار التلقائي للحصول على تفاصيل حول كيفية إضافة حالات الاختبار وتكوينها.

   azure-streamanalytics-cicd test -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(testPath) -testConfigPath $(projectRootPath)/test/testConfig.json 
   

   

إضافة مهمة نسخ الملفات

تحتاج إلى إضافة مهمة نسخ ملف لنسخ ملف ملخص الاختبار وملفات قالب Azure Resource Manager إلى مجلد artifact.

1. في صفحة المهام ، حدد التالي +لمهمة الوكيل 1. ابحث عن نسخ الملفات. ثم أدخل التكوينات التالية. من خلال التعيين ** إلى المحتويات، يتم نسخ جميع ملفات نتائج الاختبار.

   المعلمة	إدخال
   الاسم المعروض	نسخ الملفات إلى: $(build.artifactstagingdirectory)
   المجلد المصدر	$(system.defaultworkingdirectory)/$(outputPath)/
   المحتويات	**
   المجلد الهدف	$(build.artifactstagingdirectory)

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

   

إضافة مهمة نشر إنشاء القطع الأثرية

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

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

   

حفظ وتشغيل

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

تحقق من نتائج البناء والاختبار

يمكن العثور على ملف ملخص الاختبار وملفات Azure Resource Manager Template في المجلد المنشور.

الإصدار باستخدام خطوط أنابيب Azure

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

افتح مستعرض ويب وانتقل إلى مشروع Azure Stream Analytics Visual Studio Code.

1. ضمن خطوط الأنابيب في قائمة التنقل اليمنى، حدد الإصدارات. ثم حدد خط أنابيب جديد.

2. حدد البدء بمهمة فارغة.

3. في المربع القطع الأثرية ، حدد + إضافة قطعة أثرية. ضمن المصدر، حدد خط أنابيب الإنشاء الذي أنشأته وحدد إضافة.

   

4. تغيير اسم المرحلة 1 إلى نشر مهمة لاختبار البيئة.

5. إضافة مرحلة جديدة وتسميتها نشر مهمة إلى بيئة الإنتاج.

إضافة مهام النشر

1. من القائمة المنسدلة المهام، حدد نشر المهمة لاختبار البيئة.

2. حدد الوظيفة + التالية للوكيل وابحث عن نشر قالب ARM. أدخل المعلمات التالية:

   المعلمة	القيمة
   الاسم المعروض	نشر myASAProject
   اشتراك Azure	اختر اشتراكك.
   إجراء	إنشاء مجموعة موارد أو تحديثها
   مجموعة الموارد	اختر اسما لمجموعة موارد الاختبار التي ستحتوي على مهمة Stream Analytics.
   ‏‏الموقع	اختر موقع مجموعة موارد الاختبار.
   موقع القالب	قطعة أثرية مرتبطة
   قالب	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
   معلمات القالب	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
   Override template parameters	-<arm_template_parameter> "قيمتك". يمكنك تحديد المعلمات باستخدام المتغيرات.
   وضع النشر	الإضافية

3. من القائمة المنسدلة المهام، حدد نشر المهمة في بيئة الإنتاج.

4. حدد الوظيفة + التالية للوكيل وابحث عن نشر قالب ARM. أدخل المعلمات التالية:

   المعلمة	القيمة
   الاسم المعروض	نشر myASAProject
   اشتراك Azure	اختر اشتراكك.
   إجراء	إنشاء مجموعة موارد أو تحديثها
   مجموعة الموارد	اختر اسما لمجموعة موارد الإنتاج التي ستحتوي على وظيفة Stream Analytics.
   ‏‏الموقع	اختر موقع مجموعة موارد الإنتاج.
   موقع القالب	قطعة أثرية مرتبطة
   قالب	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
   معلمات القالب	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
   Override template parameters	-<arm_template_parameter> "قيمتك"
   وضع النشر	الإضافية

إنشاء إصدار

لإنشاء إصدار، حدد إنشاء إصدار في الزاوية العلوية اليسرى.

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

• التكامل المستمر والنشر المستمر لتحليلات تدفق Azure
• أتمتة إنشاء مهمة Azure Stream Analytics واختبارها ونشرها باستخدام أدوات CI/CD