مرجع مهمة Azure Pipelines

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

تصف المقالات الواردة في هذا القسم المهام المضمنة ل Azure Pipelines وتحدد دلالات السمات التي تحمل معنى خاصا لكل مهمة.

يرجى الرجوع إلى مرجع YAML للحصول على steps.task للحصول على تفاصيل حول السمات العامة التي تدعمها المهام.

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

هام

لعرض مرجع المهمة للمهام المتوفرة للنظام الأساسي الخاص بك، تأكد من تحديد إصدار Azure DevOps الصحيح من محدد الإصدار الموجود أعلى جدول المحتويات. يختلف دعم الميزات اعتمادا على ما إذا كنت تعمل من خدمات Azure DevOps أو إصدار محلي من Azure DevOps Server.
لمعرفة الإصدار المحلي الذي تستخدمه، راجع البحث عن النظام الأساسي وإصدار Azure DevOps.

إنشاء المهام

المهمة	الوصف
.NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	إنشاء تطبيق dotnet أو اختباره أو حزمه أو نشره، أو تشغيل أمر dotnet مخصص.
البناء التلقائي للأمان المتقدم AdvancedSecurity-Codeql-Autobuild@1	يحاول إنشاء المستودع عن طريق البحث عن ملفات المشروع وبناءها في المجلد المصدر.
تهيئة الأمان المتقدم ل CodeQL AdvancedSecurity-Codeql-Init@1	تهيئة قاعدة بيانات CodeQL استعدادا للبناء.
تحليل CodeQL لأداء الأمان المتقدم AdvancedSecurity-Codeql-Analyze@1	إنهاء قاعدة بيانات CodeQL وتشغيل استعلامات التحليل.
نتائج نشر الأمان المتقدم Publish@1 الأمان المتقدم	يجمع بين ملف (ملفات) SARIF التي تنتجها أداة (أدوات) فحص التعليمات البرمجية، ويعزز ملف SARIF المدمج، وينشر ملف SARIF المحسن إلى خدمة الأمان المتقدم.
إصدار Android AndroidBuild@1	تم إهمال AndroidBuild@1. استخدم Gradle.
توقيع Android AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	قم بتوقيع ملفات Android APK ومحاذاتها.
النمل Ant@1	البناء باستخدام Apache Ant.
Azure IoT Edge AzureIoTEdge@2	إنشاء صورة Azure IoT Edge ونشرها.
⁧⁩CMake⁧⁩ CMake@1	البناء باستخدام نظام بناء CMake عبر الأنظمة الأساسية.
إنشاء الحاوية ContainerBuild@0	مهمة إنشاء الحاوية.
Docker Docker@2 Docker@1 Docker@0	إنشاء صور Docker أو دفعها أو تسجيل الدخول أو تسجيل الخروج أو بدء تشغيل الحاويات أو إيقافها أو تشغيل أمر Docker.
Docker Compose DockerCompose@0	إنشاء تطبيقات Docker متعددة الحاويات أو دفعها أو تشغيلها. يمكن استخدام المهمة مع Docker أو سجل حاوية Azure.
تنزيل GitHub Nuget Packages DownloadGitHubNugetPackage@1	استعادة حزم nuget باستخدام dotnet CLI.
انتقال Go@0	احصل على تطبيق Go أو أنشئه أو اختبره، أو قم بتشغيل أمر Go مخصص.
Gradle Gradle@3 Gradle@2 Gradle@1	إنشاء باستخدام برنامج تضمين Gradle النصي.
Grunt Grunt@0	تشغيل مشغل مهمة Grunt JavaScript.
جرعه gulp@1 gulp@0	قم بتشغيل نظام الإنشاء المستند إلى المهام Node.js gulp.
مصادر الفهرس ورموز النشر PublishSymbols@2 PublishSymbols@1	فهرسة التعليمات البرمجية المصدر ونشر الرموز إلى مشاركة ملف أو خادم رموز Azure Artifacts.
مهمة قائمة انتظار Jenkins JenkinsQueueJob@2	قائمة انتظار مهمة على خادم Jenkins.
مهمة قائمة انتظار Jenkins JenkinsQueueJob@1	قائمة انتظار مهمة على خادم Jenkins.
Maven Maven@4 Maven@3 Maven@2 Maven@1	إنشاء واختبار ونشر باستخدام Apache Maven.
MSBuild MSBuild@1	البناء باستخدام MSBuild.
إعداد تكوين التحليل SonarQubePrepare@5 SonarQubePrepare@4	إعداد تكوين تحليل SonarQube.
نشر نتيجة بوابة الجودة SonarQubePublish@5 SonarQubePublish@4	انشر نتيجة بوابة الجودة في SonarQube على نتيجة بناء Azure DevOps، لاستخدامها بعد التحليل الفعلي.
تشغيل تحليل التعليمات البرمجية SonarQubeAnalyze@5 SonarQubeAnalyze@4	قم بتشغيل الماسح الضوئي وتحميل النتائج إلى خادم SonarQube.
إنشاء Visual Studio VSBuild@1	أنشئ باستخدام MSBuild وقم بتعيين خاصية إصدار Visual Studio.
Xamarin.Android XamarinAndroid@1	إنشاء تطبيق Android باستخدام Xamarin.
Xamarin.iOS XamariniOS@2 XamariniOS@1	إنشاء تطبيق iOS باستخدام Xamarin على macOS.
Xcode Xcode@5 Xcode@4	إنشاء مساحة عمل Xcode أو اختبارها أو أرشفتها على macOS. حزم تطبيق اختياريا.
Xcode Build Xcode@3 Xcode@2	إنشاء مساحة عمل Xcode على macOS.
حزمة Xcode iOS XcodePackageiOS@0	إنشاء ملف .ipa من إخراج بناء Xcode باستخدام xcrun (Xcode 7 أو أقل).

توزيع المهام

المهمة	الوصف
توزيع App Center AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	توزيع إصدارات التطبيق على المختبرين والمستخدمين عبر Visual Studio App Center.
توزيع قالب ARM AzureResourceManagerTemplateDeployment@3	نشر قالب Azure Resource Manager (ARM) إلى جميع نطاقات التوزيع.
Azure App Service Classic (مهمل) AzureWebPowerShellDeployment@1	الإنشاء أو تحديث Azure App Service باستخدام Azure PowerShell.
توزيع خدمة تطبيق Azure AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	انشر إلى Azure App Service تطبيق ويب أو هاتف محمول أو واجهة برمجة تطبيقات باستخدام Docker أو Java أو .NET أو .NET Core أو Node.js أو PHP أو Python أو Ruby.
إدارة Azure App Service AzureAppServiceManage@0	البدء أو الإيقاف أو إعادة التشغيل أو تبديل الفتحة أو حذف الفتحة أو تثبيت ملحقات الموقع أو تمكين المراقبة المستمرة لخدمة تطبيقات Azure.
إعدادات خدمة تطبيق Azure AzureAppServiceSettings@1	تحديث/إضافة إعدادات التطبيق لتطبيق ويب Azure لنظام التشغيل Linux أو Windows.
Azure CLI AzureCLI@2 AzureCLI@1	قم بتشغيل أوامر Azure CLI مقابل اشتراك Azure في برنامج نصي PowerShell Core/Shell عند التشغيل على عامل Linux أو برنامج PowerShell/PowerShell Core/Batch النصي عند التشغيل على عامل Windows.
معاينة Azure CLI AzureCLI@0	قم بتشغيل برنامج نصي Shell أو Batch باستخدام أوامر Azure CLI مقابل اشتراك azure.
توزيع Azure Cloud Service AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	توزيع خدمة سحابة Azure.
توزيع Azure Container Apps AzureContainerApps@1 AzureContainerApps@0	مهمة Azure DevOps لإنشاء تطبيقات حاوية Azure وتوزيعها.
قاعدة بيانات Azure لتوزيع MySQL AzureMysqlDeployment@1	قم بتشغيل البرامج النصية وإجراء تغييرات على قاعدة بيانات Azure ل MySQL.
نسخة ملف Azure AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	نسخ الملفات إلى Azure Blob Storage أو الأجهزة الظاهرية.
Azure Function على Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	توزيع دالة Azure إلى نظام مجموعة Kubernetes.
Azure Functions Deploy AzureFunctionApp@2 AzureFunctionApp@1	تحديث تطبيق دالة باستخدام تطبيقات الويب المستندة إلى .NET وPython وJavaScript وPowerShell وJava.
دالات Azure للحاوية AzureFunctionAppContainer@1	تحديث تطبيق دالة باستخدام حاوية Docker.
⁧⁩Azure Key Vault⁧⁩ AzureKeyVault@2 AzureKeyVault@1	قم بتنزيل أسرار Azure Key Vault.
تنبيهات Azure Monitor (مهملة) AzureMonitorAlerts@0	تكوين التنبيهات على المقاييس المتوفرة لمورد Azure (مهمل).
Azure PowerShell AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	قم بتشغيل برنامج نصي PowerShell داخل بيئة Azure.
توزيع مجموعة موارد Azure AzureResourceGroupDeployment@2	توزيع قالب Azure Resource Manager (ARM) إلى مجموعة موارد وإدارة الأجهزة الظاهرية.
نشر مجموعة موارد Azure AzureResourceGroupDeployment@1	توزيع مجموعات موارد Azure وبدء تشغيلها وإيقافها وحذفها.
تطبيقات Azure Spring AzureSpringCloud@0	توزيع التطبيقات إلى Azure Spring Apps وإدارة عمليات التوزيع.
توزيع قاعدة بيانات Azure SQL SqlAzureDacpacDeployment@1	توزيع قاعدة بيانات Azure SQL باستخدام DACPAC أو تشغيل البرامج النصية باستخدام SQLCMD.
توزيع مجموعة مقياس جهاز Azure الظاهري AzureVmssDeployment@0	نشر صورة مجموعة مقياس الجهاز الظاهري.
تطبيق الويب Azure AzureWebApp@1	توزيع Azure Web App لنظام التشغيل Linux أو Windows.
تطبيق ويب Azure للحاويات AzureWebAppContainer@1	توزيع الحاويات إلى Azure App Service.
إنشاء صورة الجهاز PackerBuild@1 PackerBuild@0	إنشاء صورة جهاز باستخدام Packer، والتي يمكن استخدامها لنشر مجموعة مقياس جهاز Azure الظاهري.
التحقق من توافق نهج Azure AzurePolicyCheckGate@0	تقييم الأمان والتوافق لنهج Azure.
Chef Chef@1	التوزيع إلى بيئات Chef عن طريق تحرير سمات البيئة.
سكين الشيف ChefKnife@1	قم بتشغيل البرامج النصية باستخدام أوامر Knife على محطة عمل Chef.
نسخ الملفات عبر SSH CopyFilesOverSSH@0	نسخ الملفات أو إنشاء البيانات الاصطناعية إلى جهاز بعيد عبر SSH.
النشر إلى Kubernetes KubernetesManifest@1 KubernetesManifest@0	استخدم ملفات بيان Kubernetes للتوزيع على المجموعات أو حتى خبز ملفات البيان لاستخدامها في عمليات النشر باستخدام مخططات Helm.
نشر تطبيق ويب IIS IISWebAppDeploymentOnMachineGroup@0	نشر موقع ويب أو تطبيق ويب باستخدام Web Deploy.
نشر تطبيق ويب IIS (مهمل) IISWebAppDeployment@1	النشر باستخدام MSDeploy، ثم إنشاء/تحديث مواقع الويب وتجمعات التطبيقات.
إدارة تطبيق ويب IIS IISWebAppManagementOnMachineGroup@0	الإنشاء مواقع الويب أو تطبيقات الويب أو الدلائل الظاهرية أو تجمعات التطبيقات أو تحديثها.
استدعاء واجهة برمجة تطبيقات REST InvokeRESTAPI@1 InvokeRESTAPI@0	استدعاء واجهة برمجة تطبيقات REST كجزء من البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك.
Kubectl Kubernetes@1 Kubernetes@0	توزيع وتكوين وتحديث مجموعة Kubernetes في Azure Container Service عن طريق تشغيل أوامر kubectl.
التدخل اليدوي ManualIntervention@8	أوقف النشر مؤقتا وانتظر التدخل اليدوي.
التحقق اليدوي ManualValidation@0	[معاينة] إيقاف تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية مؤقتا لانتظار التفاعل اليدوي. يعمل فقط مع مسارات YAML.
توزيع قاعدة بيانات MySQL MysqlDeploymentOnMachineGroup@1	تشغيل البرامج النصية وإجراء تغييرات على قاعدة بيانات MySQL.
حزم مخططات Helm وتوزيعها HelmDeploy@0	نشر وتكوين وتحديث مجموعة Kubernetes في Azure Container Service عن طريق تشغيل أوامر helm.
PowerShell على الأجهزة المستهدفة PowerShellOnTargetMachines@3	تنفيذ البرامج النصية PowerShell على الأجهزة البعيدة باستخدام PSSession Invoke-Command للاتصال عن بعد.
PowerShell على الأجهزة الهدف PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	تنفيذ البرامج النصية PowerShell على الجهاز (الأجهزة) البعيدة.
توزيع تطبيق Service Fabric ServiceFabricDeploy@1	نشر تطبيق Azure Service Fabric إلى نظام مجموعة.
نشر Service Fabric Compose ServiceFabricComposeDeploy@0	نشر تطبيق Docker Compose إلى نظام مجموعة Azure Service Fabric.
توزيع قاعدة بيانات SQL Server SqlDacpacDeploymentOnMachineGroup@0	توزيع قاعدة بيانات SQL Server باستخدام البرامج النصية DACPAC أو SQL.
توزيع قاعدة بيانات SQL Server (مهمل) SqlServerDacpacDeployment@1	توزيع قاعدة بيانات SQL Server باستخدام DACPAC.
SSH SSH@0	قم بتشغيل أوامر shell أو برنامج نصي على جهاز بعيد باستخدام SSH.
نسخة ملف جهاز Windows WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	نسخ الملفات إلى أجهزة Windows البعيدة.

مهام الحزمة

المهمة	الوصف
مصادقة Cargo (لمشغلي المهام) CargoAuthenticate@0	مهمة المصادقة لعميل الشحن المستخدم لتثبيت توزيع صناديق الشحن.
"CocoaPods" CocoaPods@0	تثبيت تبعيات CocoaPods لمشاريع Swift و Objective-C Cocoa.
بيئة Conda CondaEnvironment@1 CondaEnvironment@0	تم إهمال هذه المهمة. استخدم conda مباشرة في البرنامج النصي للعمل مع بيئات Anaconda.
تنزيل حزمة Github Npm DownloadGithubNpmPackage@1	تثبيت حزم npm من GitHub.
Maven Authenticate MavenAuthenticate@0	يوفر بيانات اعتماد لموجزات Azure Artifacts ومستودعات maven الخارجية.
⁧⁩npm⁧⁩ Npm@1 Npm@0	تثبيت حزم npm ونشرها، أو تشغيل أمر npm. يدعم npmjs.com والسجلات المصادق عليها مثل Azure Artifacts.
مصادقة npm (لمشغلي المهام) npmAuthenticate@0	لا تستخدم هذه المهمة إذا كنت تستخدم أيضا مهمة npm. يوفر بيانات اعتماد npm لملف .npmrc في المستودع الخاص بك لنطاق البناء. وهذا يمكن مشغلي مهام npm مثل gulp وGreunt من المصادقة مع السجلات الخاصة.
NuGet NuGetCommand@2	استعادة حزم NuGet أو حزمها أو دفعها، أو تشغيل أمر NuGet. يدعم NuGet.org والموجزات المصادق عليها مثل Azure Artifacts وMyGet. يستخدم NuGet.exe ويعمل مع تطبيقات .NET Framework. بالنسبة لتطبيقات .NET Core و.NET Standard، استخدم مهمة .NET Core.
مصادقة NuGet NuGetAuthenticate@1 NuGetAuthenticate@0	تكوين أدوات NuGet للمصادقة مع Azure Artifacts ومستودعات NuGet الأخرى. يتطلب NuGet >= 4.8.5385 أو dotnet >= 6 أو MSBuild >= 15.8.166.59604.
أمر NuGet NuGet@0	مهمل: استخدم مهمة "NuGet" بدلا من ذلك. يعمل مع إطار عمل مثبت الأدوات الجديد بحيث يمكنك بسهولة استخدام إصدارات جديدة من NuGet دون انتظار تحديث مهمة، ويوفر دعما أفضل للموجزات المصادق عليها خارج هذه المؤسسة/المجموعة، ويستخدم NuGet 4 بشكل افتراضي.
مثبت NuGet NuGetInstaller@0	تثبيت حزم NuGet المفقودة أو استعادتها. استخدم NuGetAuthenticate@0 المهمة للحصول على أحدث الإمكانات.
حزم NuGet NuGetPackager@0	مهمل: استخدم مهمة "NuGet" بدلا من ذلك. يعمل مع إطار عمل مثبت الأدوات الجديد بحيث يمكنك بسهولة استخدام إصدارات جديدة من NuGet دون انتظار تحديث مهمة، ويوفر دعما أفضل للموجزات المصادق عليها خارج هذه المؤسسة/المجموعة، ويستخدم NuGet 4 بشكل افتراضي.
ناشر NuGet NuGetPublisher@0	مهمل: استخدم مهمة "NuGet" بدلا من ذلك. يعمل مع إطار عمل مثبت الأدوات الجديد بحيث يمكنك بسهولة استخدام إصدارات جديدة من NuGet دون انتظار تحديث مهمة، ويوفر دعما أفضل للموجزات المصادق عليها خارج هذه المؤسسة/المجموعة، ويستخدم NuGet 4 بشكل افتراضي.
استعادة NuGet NuGetRestore@1	يستعيد حزم NuGet استعدادا لخطوة Visual Studio Build.
ناشر PyPI PyPIPublisher@0	الإنشاء وتحميل sdist أو عجلة إلى فهرس متوافق مع PyPI باستخدام Twine.
مصادقة Python pip PipAuthenticate@1 PipAuthenticate@0	مهمة المصادقة لعميل pip المستخدم لتثبيت توزيعات Python.
مصادقة تحميل Python twine TwineAuthenticate@1 TwineAuthenticate@0	المصادقة لتحميل توزيعات Python باستخدام twine. أضف '-r FeedName/EndpointName --config-file $(PYPIRC_PATH)' إلى أمر تحميل twine الخاص بك. بالنسبة للموجزات الموجودة في هذه المؤسسة، استخدم اسم الموجز كمستودع (-r). وإلا، استخدم اسم نقطة النهاية المحدد في اتصال الخدمة.
الحزم العالمية UniversalPackages@0	تنزيل الحزم العالمية أو نشرها.
استعادة مكون Xamarin XamarinComponentRestore@0	تم إهمال هذه المهمة. استخدم "NuGet" بدلا من ذلك.

اختبار المهام

المهمة	الوصف
اختبار App Center AppCenterTest@1	اختبار حزم التطبيقات باستخدام Visual Studio App Center.
اختبار تحميل Azure AzureLoadTest@1	أتمتة اختبار تراجع الأداء باستخدام Azure Load Testing.
اختبار بنية الحاوية ContainerStructureTest@0	يستخدم container-structure-test (https://github.com/GoogleContainerTools/container-structure-test) للتحقق من صحة بنية الصورة استنادا إلى أربع فئات من الاختبارات - اختبارات الأوامر واختبارات وجود الملف واختبارات محتوى الملف واختبارات بيانات التعريف.
اختبار مركز الأجهزة المحمولة VSMobileCenterTest@0	اختبار حزم تطبيقات الأجهزة المحمولة باستخدام Visual Studio Mobile Center.
نشر نتائج تغطية التعليمات البرمجية PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	نشر أي من نتائج تغطية التعليمات البرمجية من إصدار.
نشر نتائج الاختبار PublishTestResults@1	نشر نتائج الاختبار إلى Azure Pipelines.
نشر نتائج الاختبار PublishTestResults@2	نشر نتائج الاختبار إلى Azure Pipelines.
تشغيل الاختبارات الوظيفية RunVisualStudioTestsusingTestAgent@1	مهمل: يتم إهمال هذه المهمة والمهمة المصاحبة لها (نشر عامل اختبار Visual Studio). استخدم مهمة "Visual Studio Test" بدلا من ذلك. يمكن لمهمة VSTest تشغيل الوحدة بالإضافة إلى الاختبارات الوظيفية. قم بتشغيل الاختبارات على عامل واحد أو أكثر باستخدام إعداد الوظيفة متعددة العوامل. استخدم مهمة "Visual Studio Test Platform" لتشغيل الاختبارات دون الحاجة إلى Visual Studio على العامل. توفر مهمة VSTest أيضا قدرات جديدة مثل إعادة تشغيل الاختبارات الفاشلة تلقائيا.
Visual Studio Test VSTest@2 VSTest@1	قم بتشغيل الوحدة والاختبارات الوظيفية (Selenium وAppium واختبار واجهة المستخدم المشفرة وما إلى ذلك) باستخدام مشغل Visual Studio Test (VsTest). يمكن تشغيل أطر عمل الاختبار التي تحتوي على محول اختبار Visual Studio مثل MsTest وxUnit وNUnit وChutzpah (لاختبارات JavaScript باستخدام QUnit وMocha وJasmine)، وما إلى ذلك. يمكن توزيع الاختبارات على عوامل متعددة باستخدام هذه المهمة (الإصدار 2).
توزيع عامل اختبار Visual Studio DeployVisualStudioTestAgent@2	تم إهمال DeployVisualStudioTestAgent@2. استخدم مهمة اختبار Visual Studio لتشغيل الوحدة والاختبارات الوظيفية.
توزيع عامل اختبار Visual Studio DeployVisualStudioTestAgent@1	توزيع وتكوين Test Agent لتشغيل الاختبارات على مجموعة من الأجهزة.
Xamarin Test Cloud XamarinTestCloud@1	[مهمل] اختبر تطبيقات الأجهزة المحمولة باستخدام Xamarin Test Cloud باستخدام Xamarin.UITest. بدلا من ذلك، استخدم مهمة "اختبار مركز التطبيقات".

مهام الأدوات

المهمة	الوصف
مثبت .NET Core SDK/وقت التشغيل DotNetCoreInstaller@1 DotNetCoreInstaller@0	احصل على إصدار معين من .NET Core SDK من الإنترنت أو ذاكرة التخزين المؤقت المحلية وأضفه إلى PATH.
مثبت Docker CLI DockerInstaller@0	تثبيت Docker CLI على جهاز العامل.
مثبت أداة Duffle DuffleInstaller@0	قم بتثبيت إصدار محدد من Duffle لتثبيت مجموعات CNAB وإدارتها.
مثبت أداة Go GoTool@0	ابحث في ذاكرة التخزين المؤقت أو قم بتنزيل إصدار معين من Go وأضفه إلى PATH.
مثبت أداة Helm HelmInstaller@1 HelmInstaller@0	تثبيت Helm على جهاز عامل.
تثبيت Azure Func Core Tools FuncToolsInstaller@0	تثبيت Azure Func Core Tools.
مثبت أداة Java JavaToolInstaller@0	احصل على إصدار معين من Java من Azure blob الذي يوفره المستخدم أو ذاكرة التخزين المؤقت للأداة وتعيينات JAVA_HOME.
مثبت أداة Kubectl KubectlInstaller@0	تثبيت Kubectl على جهاز العامل.
مثبت أداة Kubelogin KubeloginInstaller@0	يساعد على تثبيت kubelogin.
مثبت أداة NuGet NuGetToolInstaller@1 NuGetToolInstaller@0	يكتسب إصدارا معينا من NuGet من الإنترنت أو ذاكرة التخزين المؤقت للأدوات ويضيفه إلى PATH. استخدم هذه المهمة لتغيير إصدار NuGet المستخدم في مهام NuGet.
استخدام .NET Core UseDotNet@2	يكتسب إصدارا معينا من .NET Core SDK من الإنترنت أو ذاكرة التخزين المؤقت المحلية ويضيفه إلى PATH. استخدم هذه المهمة لتغيير إصدار .NET Core المستخدم في المهام اللاحقة. بالإضافة إلى ذلك، يوفر دعم الوكيل.
استخدام النظام البيئي Node.js UseNode@1 NodeTool@0	قم بإعداد بيئة Node.js وإضافتها إلى PATH، بالإضافة إلى توفير دعم الوكيل.
استخدام إصدار Python UsePythonVersion@0	استخدم الإصدار المحدد من Python من ذاكرة التخزين المؤقت للأداة، وإضافته اختياريا إلى PATH.
استخدام إصدار Ruby UseRubyVersion@0	استخدم الإصدار المحدد من Ruby من ذاكرة التخزين المؤقت للأداة، وإضافته اختياريا إلى PATH.
مثبت النظام الأساسي لاختبار Visual Studio VisualStudioTestPlatformInstaller@1	احصل على النظام الأساسي للاختبار من nuget.org أو ذاكرة التخزين المؤقت للأداة. يلبي الطلب "vstest" ويمكن استخدامه لتشغيل الاختبارات وجمع البيانات التشخيصية باستخدام مهمة Visual Studio Test.

مهام الأداة المساعدة

المهمة	الوصف
فحص تبعية الأمان المتقدم الأمان المتقدم-التبعية-Scanning@1	افحص بحثا عن مصدر مفتوح الثغرات الأمنية في التبعية في التعليمات البرمجية المصدر.
أرشفة الملفات ArchiveFiles@2	ضغط الملفات في .7z أو .tar.gz أو .zip.
أرشفة الملفات ArchiveFiles@1	أرشفة الملفات باستخدام تنسيقات الضغط مثل .7z .rar .tar.gz .zip.
موازن تحميل شبكة Azure AzureNLBManagement@1	قم بتوصيل واجهة شبكة جهاز Azure الظاهري أو قطع اتصالها بتجمع عناوين النهاية الخلفية لموازن التحميل.
Bash Bash@3	قم بتشغيل برنامج Bash النصي على macOS أو Linux أو Windows.
البرنامج النصي الدفعي BatchScript@1	قم بتشغيل أمر Windows أو برنامج نصي دفعي والسماح له بشكل اختياري بتغيير البيئة.
ذاكرة تخزين مؤقت Cache@2	تخزين الملفات مؤقتا بين عمليات التشغيل.
ذاكرة التخزين المؤقت (بيتا) CacheBeta@1 CacheBeta@0	تخزين الملفات مؤقتا بين عمليات التشغيل.
سطر الأوامر CmdLine@2 CmdLine@1	قم بتشغيل برنامج نصي سطر الأوامر باستخدام Bash على Linux وmacOS cmd.exe على Windows.
نسخ ونشر البيانات الاصطناعية للبناء CopyPublishBuildArtifacts@1	تم إهمال CopyPublishBuildArtifacts@1. استخدم مهمة Copy Files ومهمة Publish Build Artifacts بدلا من ذلك.
نسخ الملفات CopyFiles@2	نسخ الملفات من مجلد مصدر إلى مجلد هدف باستخدام أنماط مطابقة مسارات الملفات (وليس مسارات المجلدات).
نسخ الملفات CopyFiles@1	انسخ الملفات من المجلد المصدر إلى المجلد الهدف باستخدام أنماط minimatch (ستتطابق أنماط المطابقة المصغرة فقط مع مسارات الملفات، وليس مسارات المجلدات).
cURL Upload Files cURLUploader@2 cURLUploader@1	استخدم بروتوكولات cURL المدعومة لتحميل الملفات.
فك تشفير الملف (OpenSSL) DecryptFile@1	فك تشفير ملف باستخدام OpenSSL.
تاخير Delay@1	تأخير المزيد من تنفيذ سير العمل لفترة زمنية محددة.
حذف الملفات DeleteFiles@1	حذف المجلدات أو الملفات المطابقة لنمط.
توزيع Azure Static Web App AzureStaticWebApp@0	إنشاء ونشر Azure Static Web App.
تنزيل البيانات الاصطناعية من مشاركة الملفات DownloadFileshareArtifacts@1	قم بتنزيل البيانات الاصطناعية من مشاركة ملف، مثل \share\drop.
تنزيل البيانات الاصطناعية للبناء DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	قم بتنزيل الملفات التي تم حفظها كقطع أثرية لبنية مكتملة.
تنزيل إصدار GitHub DownloadGitHubRelease@0	تنزيل إصدار GitHub من مستودع.
تنزيل الحزمة DownloadPackage@1 DownloadPackage@0	قم بتنزيل حزمة من موجز إدارة الحزمة في Azure Artifacts.
تنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	قم بتنزيل البيانات الاصطناعية للبنية والمسار.
تنزيل ملف آمن DownloadSecureFile@1	قم بتنزيل ملف آمن إلى جهاز العامل.
استخراج الملفات ExtractFiles@1	استخراج مجموعة متنوعة من ملفات الأرشيف والضغط مثل .7z .rar .tar.gz .zip.
تحويل الملف FileTransform@2 FileTransform@1	استبدل الرموز المميزة بقيم متغيرة في ملفات تكوين XML أو JSON.
تحميل FTP FtpUpload@2 FtpUpload@1	تحميل الملفات باستخدام FTP.
تعليق GitHub GitHubComment@0	اكتب تعليقا إلى كيان GitHub الخاص بك، أي مشكلة أو طلب سحب (PR).
إصدار GitHub GitHubRelease@1 GitHubRelease@0	الإنشاء إصدار GitHub أو تحريره أو حذفه.
تثبيت شهادة Apple InstallAppleCertificate@2	تثبيت شهادة Apple المطلوبة للبناء على جهاز عامل macOS.
تثبيت شهادة Apple InstallAppleCertificate@1 InstallAppleCertificate@0	قم بتثبيت شهادة Apple المطلوبة للبناء على عامل macOS.
تثبيت ملف تعريف تزويد Apple InstallAppleProvisioningProfile@1	قم بتثبيت ملف تعريف تزويد Apple المطلوب للبناء على جهاز عامل macOS.
تثبيت ملف تعريف توفير Apple InstallAppleProvisioningProfile@0	قم بتثبيت ملف تعريف تزويد Apple المطلوب للبناء على عامل macOS.
تثبيت مفتاح SSH InstallSSHKey@0	قم بتثبيت مفتاح SSH قبل الإنشاء أو التوزيع.
استدعاء Azure Function AzureFunction@1 AzureFunction@0	استدعاء دالة Azure.
البيانات الاصطناعية لتنزيل Jenkins JenkinsDownloadArtifacts@1	قم بتنزيل البيانات الاصطناعية التي تنتجها مهمة Jenkins.
Node.js مثبت مشغل المهام NodeTaskRunnerInstaller@0	قم بتثبيت إصدار Node.js محدد لتشغيل مهام العقدة.
الرمز Notation@0	مهمة Azure Pipepine لإعداد Notation CLI، والتوقيع والتحقق باستخدام Notation.
PowerShell PowerShell@2 PowerShell@1	قم بتشغيل برنامج نصي PowerShell على Linux أو macOS أو Windows.
نشر البيانات الاصطناعية للبناء PublishBuildArtifacts@1	نشر البيانات الاصطناعية للبنية إلى Azure Pipelines أو مشاركة ملف Windows.
نشر البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية PublishPipelineArtifact@1 PublishPipelineArtifact@0	نشر (تحميل) ملف أو دليل كقطعة اصطناعية مسماة للتشغيل الحالي.
نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية PublishPipelineMetadata@0	نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية إلى مخزن الأدلة.
نشر إلى ناقل خدمة Azure PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	يرسل رسالة إلى ناقل خدمة Azure باستخدام اتصال خدمة (لا يلزم وجود عامل).
البرنامج النصي Python PythonScript@0	قم بتشغيل ملف Python أو برنامج نصي مضمن.
تنبيهات Query Azure Monitor AzureMonitor@1	لاحظ قواعد Azure Monitor المكونة للتنبيهات النشطة.
الاستعلام عن تنبيهات Azure Monitor الكلاسيكية AzureMonitor@0	لاحظ قواعد Azure Monitor الكلاسيكية المكونة للتنبيهات النشطة.
عناصر عمل الاستعلام queryWorkItems@0	تنفيذ استعلام عنصر عمل والتحقق من عدد العناصر التي تم إرجاعها.
مراجعة التطبيق ReviewApp@0	استخدم هذه المهمة ضمن توزيع موفر المرحلة لإنشاء مورد ديناميكيا.
Service Fabric PowerShell ServiceFabricPowerShell@1	قم بتشغيل برنامج نصي PowerShell في سياق اتصال نظام مجموعة Azure Service Fabric.
البرنامج النصي Shell ShellScript@2	تشغيل برنامج نصي shell باستخدام Bash.
تحديث إصدارات تطبيق Service Fabric ServiceFabricUpdateAppVersions@1	يحدث تلقائيا إصدارات تطبيق Service Fabric المحزم.
تحديث بيانات Service Fabric ServiceFabricUpdateManifests@2	تحديث أجزاء من بيانات التطبيق والخدمة تلقائيا في تطبيق Azure Service Fabric المحزم.
ترخيص Xamarin XamarinLicense@1	[مهمل] الترقية إلى الإصدار المجاني من Xamarin: https://store.xamarin.com.

مفتوح المصدر

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

الأسئلة المتداولة

ما هي الأسماء المستعارة لإدخال المهمة؟

يتم تحديد المدخلات إلى مهمة بواسطة label، name، وقد تتضمن واحدة أو أكثر اختيارية aliases. المثال التالي هو مقتطف من التعليمات البرمجية المصدر لإدخال إدخال المضيفين المعروفين لمهمة InstallSSHKey@0 .

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

قبل تقديم مسارات YAML في عام 2019، تم إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية وتحريرها باستخدام محرر البنية الأساسية لبرنامج ربط العمليات التجارية المستندة إلى واجهة المستخدم، وتم استخدام فقط label من قبل مؤلفي البنية الأساسية لبرنامج ربط العمليات التجارية للإشارة إلى إدخال مهمة.

عند تقديم مسارات YAML في عام 2019، بدأ مؤلفو البنية الأساسية لبرنامج ربط العمليات التجارية باستخدام YAML باستخدام إدخال name المهمة للإشارة إلى إدخال مهمة. في بعض الحالات، لم تكن أسماء إدخال المهمة وصفية، لذلك aliases تمت إضافتها لتوفير أسماء وصفية إضافية لإدخالات المهام.

على سبيل المثال، تحتوي المهمة على InstallSSHKey@0 إدخال المضيفين المعروفين المسمى hostName الذي يتوقع إدخالا من ملف known_hosts . توضح تسمية إدخال المضيفين المعروفة في مصمم البنية الأساسية لبرنامج ربط العمليات التجارية الكلاسيكية هذا الأمر بوضوح، ولكنه ليس واضحا عند استخدام hostName الاسم في البنية الأساسية لبرنامج ربط العمليات التجارية YAML. تم تقديم الأسماء المستعارة لإدخال المهمة للسماح لمؤلفي المهام بتوفير أسماء غير مطابقة للمهام التي تم تأليفها مسبقا، وبالنسبة للمهمةInstallSSHKey@0، تمت إضافة اسم مستعارknownHostsEntry، مع الاحتفاظ بالاسم الأصلي hostName للتوافق مع المسارات الموجودة باستخدام هذا الاسم.

أي عناصر في إدخال aliases مهمة قابلة للتبديل مع في name مسار YAML. مقتطفا YAML التاليان متطابقان وظيفيا، مع المثال الأول باستخدام knownHostsEntry الاسم المستعار والمثال الثاني باستخدام hostName.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

بدءا من Azure DevOps Server 2019.1، تم تقديم محرر البنية الأساسية لبرنامج ربط العمليات التجارية YAML، والذي يوفر وظيفة نوع intellisense.

يستخدم محرر البنية الأساسية لبرنامج ربط العمليات التجارية YAML Yamlschema - Get REST API لاسترداد المخطط المستخدم للتحقق من الصحة في المحرر. إذا كان إدخال مهمة يحتوي على اسم مستعار، يقوم المخطط بترقية الاسم المستعار إلى اسم YAML الأساسي لإدخال المهمة، ويتم اقتراح الاسم المستعار بواسطة intellisense.

المثال التالي هو إدخال مهمة إدخال المضيفين المعروفين للمهمة InstallSSHKey@0 من مخطط YAML، مع knownHostsEntry إدراجها في موضع الاسم وفي hostNamealiases المجموعة.

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

نظرا لأن intellisense في محرر مسار YAML يعرض knownHostsEntry، ويستخدم YAML الذي تم إنشاؤه بواسطة مساعدknownHostsEntry المهمة في YAML الذي تم إنشاؤه، يعرض alias مرجع المهمة من التعليمات البرمجية لمصدر المهمة كاسم YAML لإدخال مهمة. إذا كانت المهمة تحتوي على أكثر من اسم مستعار واحد (هناك عدد قليل يحتوي على اسمين مستعارين)، يتم استخدام الاسم المستعار الأول كاسم.

لماذا تغير مرجع المهمة؟

تم نقل الوثائق المرجعية لمهام Azure Pipelines إلى موقعها الحالي لدعم التحسينات التالية.

• يتم إنشاء مقالات المهام باستخدام التعليمات البرمجية لمصدر المهمة من مهام Azure Pipelines مصدر مفتوح المستودع.
• يتم إنشاء أسماء إدخال المهمة والأسماء المستعارة من مصدر المهمة بحيث تكون محدثة دائما.
• يتم إنشاء كتل بناء جملة YAML من مصدر المهمة بحيث تكون محدثة.
• يدعم مساهمات المجتمع مع محتوى المستخدم المتكامل مثل أوصاف إدخال المهام المحسنة والملاحظات والأمثلة.
• يوفر تغطية المهام لجميع إصدارات Azure DevOps المدعومة.
• تم تحديث كل دورة متكررة لتغطية آخر التحديثات.

للمساهمة، راجع المساهمة في محتوى المهام.

أين يمكنني تعلم كيفية إنشاء تطبيقي خطوة بخطوة؟

بناء تطبيقك

هل يمكنني إضافة مهام الإنشاء الخاصة بي؟

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

ما هي مهام المثبت؟

لمعرفة المزيد حول مهام مثبت الأدوات، راجع مثبتات الأدوات.