استخدام حزمة Azure Stream Analytics CI/CD NuGet للتكامل والتطوير
توضح هذه المقالة كيفية استخدام حزمة Azure Stream Analytics CI/CD NuGet لإعداد عملية التوزيع والتكامل المستمرة.
استخدم الإصدار 2.3.0000.0 أو أعلى من أدوات Stream Analytics لـ Visual Studio للحصول على دعم MSBuild.
تتوفر حزمة NuGet: Microsoft.Azure.Stream Analytics.CICD. يوفر MSBuild، والتشغيل المحلي، وأدوات التوزيع التي تدعم التكامل المستمر وعملية التوزيع لمشاريع Stream Analytics Visual Studio.
إشعار
يمكن استخدام حزمة NuGet فقط مع الإصدار 2.3.0000.0 أو أعلى لـ Stream Analytics Tools الخاصة بـ Visual Studio. إذا كان لديك مشاريع تم إنشاؤها في الإصدارات السابقة من أدوات Visual Studio، فما عليك سوى فتحها باستخدام الإصدار 2.3.0000.0 أو أعلى وحفظها. ثم يتم تمكين القدرات الجديدة.
لمزيد من المعلومات، راجع أدوات Stream Analytics لـ Visual Studio.
MSBuild
مثل تجربة MSBuild Visual Studio القياسية، لبناء مشروع لديك خياران. يمكنك النقر بزر الماوس الأيمن فوق المشروع، ثم اختيار إنشاء. يمكنك أيضاً استخدام MSBuild في حزمة NuGet من سطر الأوامر.
./build/msbuild /t:build [Your Project Full Path] /p:CompilerTaskAssemblyFile=Microsoft.WindowsAzure.StreamAnalytics.Common.CompileService.dll /p:ASATargetsFilePath="[NuGet Package Local Path]\build\StreamAnalytics.targets"
عند إنشاء مشروع Stream Analytics Visual Studio بنجاح، فإنه ينشئ ملفي قالب Azure Resource Manager التاليين ضمن المجلد bin/[Debug/Retail]/Deploy:
ملف Azure Resource Manager
[ProjectName].JobTemplate.jsonملف معلمات Resource Manager
[ProjectName].JobTemplate.parameters.json
المعلمات الافتراضية في ملف parameters.js من الإعدادات في مشروع Visual Studio الخاص بك. إذا كنت تريد التوزيع إلى بيئة أخرى، فاستبدل المعلمات وفقاً لذلك.
إشعار
بالنسبة لكافة بيانات الاعتماد، يتم تعيين القيم الافتراضية إلى خالٍ. أنت مطالب بتعيين القيم قبل التوزيع في السحابة.
"Input_EntryStream_sharedAccessPolicyKey": {
"value": null
},
تعرف على المزيد حول كيفية التوزيع باستخدام ملف قالب Resource Manager وAzure PowerShell. تعرف على كيفية استخدام عنصر كمعلمة في قالب Azure Resource Manager.
لاستخدام الهوية المدارة ل Azure Data Lake Store Gen2 كمتلقي إخراج، تحتاج إلى توفير الوصول إلى كيان الخدمة باستخدام PowerShell قبل النشر إلى Azure. تعرف على المزيد حول كيفية نشر ADLS Gen2 مع قالب الهوية المدارة باستخدام Resource Manager.
أداة سطر الأوامر
إنشاء المشروع
تحتوي حزمة NuGet على أداة سطر أوامر تسمى SA.exe. وهو يدعم بناء المشروع والاختبار المحلي على جهاز عشوائي، والذي يمكنك استخدامه في عملية التكامل المستمر والتسليم المستمر.
يتم وضع ملفات التوزيع تحت الدليل الحالي بشكل افتراضي. يمكنك تحديد مسار الإخراج باستخدام المعلمة OutputPath التالية:
./tools/SA.exe build -Project [Your Project Full Path] [-OutputPath <outputPath>]
اختبار البرنامج النصي محلياً
إذا كان مشروعك قد حدد ملفات الإدخال المحلية في Visual Studio، يمكنك تشغيل اختبار برنامج نصي تلقائي باستخدام الأمر localrun. يتم وضع نتيجة الإخراج ضمن الدليل الحالي.
localrun -Project [ProjectFullPath]
إنشاء ملف تعريف مهمة لاستخدامه مع واجهة برمجة تطبيقات Stream Analytics PowerShell
يأخذ أمر arm قالب المهمة وملفات معلمات قالب المهمة التي تم إنشاؤها من خلال البنية كإدخال. ثم يجمع بينهما في ملف JSON لتعريف المهمة الذي يمكن استخدامه مع Stream Analytics PowerShell API.
arm -JobTemplate <templateFilePath> -JobParameterFile <jobParameterFilePath> [-OutputFile <asaArmFilePath>]
مثال:
./tools/SA.exe arm -JobTemplate "ProjectA.JobTemplate.json" -JobParameterFile "ProjectA.JobTemplate.parameters.json" -OutputFile "JobDefinition.json"