Azure Pipelines task reference

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

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

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

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

مهم

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

إنشاء المهام

مهمة	وصف
.NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	بناء أو اختبار أو تغليف أو نشر تطبيق .NET، أو تشغيل أمر CLI مخصص ب .NET.
تهيئة الأمان المتقدم 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@1 DockerCompose@0	إنشاء تطبيقات Docker متعددة الحاويات أو دفعها أو تشغيلها. يمكن استخدام المهمة مع سجل Docker أو Azure Container.
تحميل حزم GitHub Nuget DownloadGitHubNugetPackage@1	استعادة حزم nuget باستخدام dotnet CLI.
ذهب Go@0	احصل على تطبيق Go أو أنشئه أو اختبره، أو قم بتشغيل أمر Go مخصص.
جرادل Gradle@4 Gradle@3 Gradle@2 Gradle@1	إنشاء باستخدام برنامج تضمين Gradle النصي.
نعر Grunt@0	تشغيل مشغل مهمة Grunt JavaScript.
جولب gulp@1 gulp@0	قم بتشغيل نظام الإنشاء المستند إلى المهام Node.js gulp.
مصادر الفهرس ونشر الرموز PublishSymbols@2 PublishSymbols@1	قم بفهرسة كود المصدر الخاص بك ونشر الرموز على مشاركة ملفات أو خادم رموز البيانات الاصطناعية من Azure.
مهمة قائمة انتظار Jenkins JenkinsQueueJob@2	وضع مهمة في قائمة الانتظار على خادم Jenkins.
مهمة قائمة انتظار Jenkins JenkinsQueueJob@1	وضع مهمة في قائمة الانتظار على خادم Jenkins.
مخضرم Maven@4 Maven@3 Maven@2 Maven@1	إنشاء واختبار ونشر باستخدام Apache Maven.
MSBuild MSBuild@1	البناء باستخدام MSBuild.
إعداد تكوين التحليل SonarQubePrepare@8 SonarQubePrepare@7 SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	إعداد تكوين تحليل SonarQube Server.
نشر نتائج بوابة الجودة SonarQubePublish@8 SonarQubePublish@7 SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	نشر نتيجة Quality Gate الخاصة بخادم SonarQube على نتيجة بناء Azure DevOps، لاستخدامها بعد التحليل الفعلي.
run Code Analysis SonarQubeAnalyze@8 SonarQubeAnalyze@7 SonarQubeAnalyze@6 SonarQubeAnalyze@5 SonarQubeAnalyze@4	تشغيل الماسح الضوئي وتحميل النتائج إلى خادم SonarQube.
Visual Studio البناء VSBuild@1	قم بالبناء باستخدام MSBuild وضبط خاصية إصدار Visual Studio.
Xcode Xcode@5 Xcode@4	إنشاء مساحة عمل Xcode أو اختبارها أو أرشفتها على macOS. حزم تطبيق اختياريا.
إنشاء Xcode 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 تصدير AzureAppConfigurationExport@10	تصدير قيم المفاتيح من تكوين Azure App إلى متغيرات المهام في خطوط البناء أو النشر الخاصة بك.
تكوين Azure App استيراد AzureAppConfigurationImport@10	استيراد الإعدادات من ملفات التكوين إلى تكوين Azure App عبر خطوط البناء أو النشر.
تكوين Azure App لقطة AzureAppConfigurationSnapshot@1	إنشاء لقطة تكوين في تكوين Azure App من خلال خطوط البناء أو النشر.
"Azure App Service" كلاسيك (مهجور) AzureWebPowerShellDeployment@1	Create or update "Azure App Service" using Azure PowerShell.
"Azure App Service" الانتشار AzureRmWebAppDeployment@5 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 App Service".
"Azure App Service" الإعدادات AzureAppServiceSettings@1	قم بتحديث/إضافة إعدادات التطبيق لتطبيق Azure Web لنظام Linux أو Windows.
Azure CLI AzureCLI@3 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 نشر الخدمة السحابية AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Deploy an Azure Cloud Service.
Azure Container Apps النشر AzureContainerApps@1 AzureContainerApps@0	An Azure DevOps Task to build and deploy Azure Container Apps.
قاعدة بيانات Azure لـ MySQL الانتشار AzureMysqlDeployment@1	شغل السكربتات الخاصة بك وقم بإجراء تغييرات على قاعدة بيانات قاعدة بيانات Azure لـ MySQL.
Azure نسخة ملف AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	نسخ الملفات إلى مساحة تخزين Azure Blob أو الآلات الافتراضية.
Azure دالة على Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Deploy Azure function to Kubernetes cluster.
دالات Azure النشر AzureFunctionApp@2 AzureFunctionApp@1	قم بتحديث تطبيق الوظائف باستخدام تطبيقات ويب تعتمد على .NET وPython وJavaScript وPowerShell وتطبيقات الويب المبنية على Java.
دالات Azure للحاوية AzureFunctionAppContainer@1	تحديث تطبيق دالة باستخدام حاوية Docker.
Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	Download Azure Key Vault secrets.
تنبيهات 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 Apps AzureSpringCloud@0	نشر التطبيقات إلى Azure Spring Apps وإدارة النشرات.
قاعدة بيانات Azure SQL الانتشار SqlAzureDacpacDeployment@1	نشر قاعدة بيانات قاعدة بيانات Azure SQL باستخدام DACPAC أو تشغيل السكريبتات باستخدام SQLCMD.
Azure نشر مجموعة مقياس الآلات الافتراضية AzureVmssDeployment@1 AzureVmssDeployment@0	نشر صورة مجموعة مقياس الجهاز الظاهري.
Azure تطبيق الويب AzureWebApp@1	نشر تطبيق ويب على Azure لنظام Linux أو Windows.
Azure تطبيق ويب للحاويات AzureWebAppContainer@1	Deploy containers to "Azure App Service".
صورة جهاز Build PackerBuild@1 PackerBuild@0	قم ببناء صورة آلة باستخدام Packer، والتي يمكن استخدامها لنشر مجموعات Azure Virtual Machine على نطاق واسع.
تحقق من نهج Azure الامتثال AzurePolicyCheckGate@0	تقييم الأمان والامتثال ل نهج Azure.
Chef Chef@1	النشر إلى بيئات Chef عن طريق تحرير سمات البيئة.
Chef Knife ChefKnife@1	تشغيل البرامج النصية باستخدام أوامر Knife على محطة عمل Chef.
نسخ الملفات عبر SSH CopyFilesOverSSH@0	نسخ الملفات أو إنشاء البيانات الاصطناعية إلى جهاز بعيد عبر SSH.
النشر في Kubernetes KubernetesManifest@1 KubernetesManifest@0	استخدم ملفات بيان Kubernetes للتوزيع على أنظمة المجموعات أو حتى خبز ملفات البيان لاستخدامها في عمليات النشر باستخدام مخططات Helm.
تطبيق IIS على الويب نشر IISWebAppDeploymentOnMachineGroup@0	نشر موقع ويب أو تطبيق ويب باستخدام Web Deploy.
نشر IIS Web App (مهمل) IISWebAppDeployment@1	النشر باستخدام MSDeploy، ثم إنشاء/تحديث مواقع الويب وتجمعات التطبيقات.
إدارة تطبيق IIS على الويب IISWebAppManagementOnMachineGroup@0	إنشاء مواقع الويب أو تطبيقات الويب أو الدلائل الظاهرية أو تجمعات التطبيقات أو تحديثها.
استدعاء واجهة برمجة تطبيقات REST InvokeRESTAPI@1 InvokeRESTAPI@0	استدعاء واجهة برمجة تطبيقات REST كجزء من البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك.
Kubectl Kubernetes@1 Kubernetes@0	Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
التدخل اليدوي ManualIntervention@8	أوقف النشر مؤقتا وانتظر التدخل اليدوي. يعمل فقط مع خطوط أنابيب الإصدار الكلاسيكية.
التحقق اليدوي ManualValidation@1 ManualValidation@0	إيقاف تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية مؤقتا لانتظار التفاعل اليدوي. يعمل فقط مع مسارات YAML.
توزيع قاعدة بيانات MySQL MysqlDeploymentOnMachineGroup@1	تشغيل البرامج النصية وإجراء تغييرات على قاعدة بيانات MySQL.
حزم مخططات Helm وتوزيعها HelmDeploy@1 HelmDeploy@0	Deploy, configure, update a Kubernetes cluster in Azure Container Service by run helm commands.
PowerShell على الأجهزة المستهدفة PowerShellOnTargetMachines@3	تنفيذ البرامج النصية PowerShell على الأجهزة البعيدة باستخدام PSSession و Invoke-Command عن بعد.
PowerShell على الأجهزة المستهدفة PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	تنفيذ البرامج النصية PowerShell على الجهاز (الأجهزة) البعيدة.
Service Fabric Application deployment ServiceFabricDeploy@1	Deploy an Azure Service Fabric application to a cluster.
Service Fabric Compose deploy ServiceFabricComposeDeploy@0	Deploy a Docker Compose application to a Azure Service Fabric cluster.
SQL Server deploy database 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	مهمة المصادقة لعميل الشحن المستخدم لتثبيت توزيع صناديق Cargo.
CocoaPods CocoaPods@0	تثبيت تبعيات CocoaPods لمشاريع Swift Objective-C Cocoa.
بيئة Conda CondaEnvironment@1 CondaEnvironment@0	هذه المهمة مهملة. استخدم conda مباشرة في البرنامج النصي للعمل مع بيئات Anaconda.
تنزيل حزمة Github Npm DownloadGithubNpmPackage@1	قم بتثبيت حزم npm من GitHub.
مصادقة Maven MavenAuthenticate@0	يوفر بيانات اعتماد لخلاصات البيانات الاصطناعية من Azure ومستودعات maven الخارجية.
npm Npm@1 Npm@0	تثبيت حزم npm ونشرها، أو تشغيل أمر npm. يدعم npmjs.com السجلات والمصادقة مثل البيانات الاصطناعية من Azure.
مصادقة npm (لمشغلي المهام) npmAuthenticate@0	لا تستخدم هذه المهمة إذا كنت تستخدم أيضا مهمة npm. يوفر بيانات اعتماد npm لملف .npmrc في المستودع الخاص بك لنطاق البناء. وهذا يمكن مشغلي مهام npm مثل gulp وGreunt من المصادقة مع السجلات الخاصة.
NuGet NuGetCommand@2 NuGet@0	استعادة حزم NuGet أو حزمها أو دفعها، أو تشغيل أمر NuGet. يدعم NuGet.org وموجز المصادقة مثل البيانات الاصطناعية من Azure وMyGet. يستخدم NuGet.exe ويعمل مع تطبيقات إطار العمل .NET. بالنسبة لتطبيقات .NET Core و.NET Standard، استخدم مهمة .NET Core.
مصادقة NuGet NuGetAuthenticate@1 NuGetAuthenticate@0	Configure NuGet tools to authenticate with البيانات الاصطناعية من Azure and other NuGet repositories. يتطلب NuGet >= 4.8.5385 أو dotnet >= 6 أو MSBuild >= 15.8.166.59604.
NuGet Installer NuGetInstaller@0	تثبيت حزم NuGet المفقودة أو استعادتها. استخدم مهمة NuGetAuthenticate@0 للحصول على أحدث الإمكانات.
حزم NuGet NuGetPackager@0	مهمل: استخدم المهمة "NuGet" بدلا من ذلك. وهو يعمل مع إطار عمل Tool Installer الجديد بحيث يمكنك بسهولة استخدام إصدارات جديدة من NuGet دون انتظار تحديث مهمة، ويوفر دعما أفضل للموجزات المصادق عليها خارج هذه المؤسسة/المجموعة، ويستخدم NuGet 4 بشكل افتراضي.
ناشر NuGet NuGetPublisher@0	مهمل: استخدم المهمة "NuGet" بدلا من ذلك. وهو يعمل مع إطار عمل Tool Installer الجديد بحيث يمكنك بسهولة استخدام إصدارات جديدة من NuGet دون انتظار تحديث مهمة، ويوفر دعما أفضل للموجزات المصادق عليها خارج هذه المؤسسة/المجموعة، ويستخدم NuGet 4 بشكل افتراضي.
استعادة NuGet NuGetRestore@1	يستعيد حزم NuGet استعدادا لخطوة Visual Studio Build.
ناشر PyPI PyPIPublisher@0	إنشاء وتحميل sdist أو عجلة إلى فهرس متوافق مع PyPI باستخدام Twine.
Python pip authenticate PipAuthenticate@1 PipAuthenticate@0	مهمة المصادقة لعميل pip المستخدمة لتثبيت توزيعات Python.
Python تحميل التوثيق من التوطين TwineAuthenticate@1 TwineAuthenticate@0	قم بالتحقق من المصادقة عند رفع توزيعات Python باستخدام twine. أضف '-r FeedName/EndpointName --config-file $(PYPIRC_PATH)' إلى أمر التحميل المزدوج. بالنسبة للموجزات الموجودة في هذه المؤسسة، استخدم اسم الموجز كمستودع (-r). وإلا، استخدم اسم نقطة النهاية المحدد في اتصال الخدمة.
حزم العالمية UniversalPackages@0	تنزيل الحزم العالمية أو نشرها.

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

مهمة	وصف
اختبار App Center AppCenterTest@1	اختبر حزم التطبيقات مع Visual Studio App Center.
اختبار تحميل Azure AzureLoadTest@1	أتمتة اختبار الانحدار بالأداء باستخدام اختبار تحميل Azure.
Azure خطة الاختبار AzureTestPlan@0	شغل نقاط الاختبار اليدوية والآلية لخطة الاختبار المختلفة مثل Maven وGradle لجافا Java، وPyTest ل Python وJest لجافا سكريبت.
اختبار بنية حاوية ContainerStructureTest@0	يستخدم اختبار بنية الحاوية (https://github.com/GoogleContainerTools/container-structure-test) للتحقق من صحة بنية الصورة استنادا إلى أربع فئات من الاختبارات - اختبارات الأوامر واختبارات وجود الملف واختبارات محتوى الملفات واختبارات بيانات التعريف.
اختبار Mobile Center VSMobileCenterTest@0	جرب حزم تطبيقات الجوال مع Visual Studio Mobile Center.
نتائج تغطية التعليمات البرمجية Publish PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	نشر أي من نتائج تغطية التعليمات البرمجية من إصدار.
نتائج اختبار Publish PublishTestResults@1	نشر نتائج الاختبار على Azure Pipelines.
نشر نتائج الاختبار PublishTestResults@2	نشر نتائج الاختبار على Azure Pipelines.
تشغيل الاختبارات الوظيفية RunVisualStudioTestsusingTestAgent@1	مهجورة: هذه المهمة ومهمتها المصاحبة (Visual Studio Test Agent Deployment) تم إلغاؤها. استخدم مهمة 'اختبار Visual Studio' بدلا من ذلك. يمكن لمهمة VSTest تشغيل الوحدة بالإضافة إلى الاختبارات الوظيفية. قم بتشغيل الاختبارات على عامل واحد أو أكثر باستخدام إعداد الوظيفة متعددة العوامل. استخدم مهمة 'Visual Studio Test Platform' لتشغيل الاختبارات دون الحاجة إلى Visual Studio على الوكيل. توفر مهمة VSTest أيضا قدرات جديدة مثل إعادة تشغيل الاختبارات الفاشلة تلقائيا.
Visual Studio اختبار VSTest@3 VSTest@2 VSTest@1	قم بتشغيل اختبارات الوحدة والوظيفية (Selenium، Appium، اختبار واجهة المستخدم المدمج، إلخ) باستخدام Visual Studio Test Runner (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 لتشغيل الاختبارات على مجموعة من الأجهزة.

مهام الأدوات

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

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

مهمة	وصف
فحص تبعية الأمان المتقدمة AdvancedSecurity-Dependency-Scanning@1	افحص نقاط الثغرات المتعلقة بالاعتماد على مصدر مفتوح في كودك المصدري.
ملفات الأرشيف ArchiveFiles@2	ضغط الملفات إلى .7z أو .tar.gz أو .zip.
ملفات الأرشيف ArchiveFiles@1	أرشفة الملفات باستخدام تنسيقات الضغط مثل .7z .rar.tar.gz .zip.
Azure Network Load Balancer AzureNLBManagement@1	قم بتوصيل أو فصل واجهة شبكة آلة Azure الافتراضية بمجموعة عناوين الخلفية في Load Balancer.
Bash Bash@3	شغل سكريبت Bash على macOS أو Linux أو Windows.
البرنامج النصي Batch BatchScript@1	شغل أمر Windows أو سكريبت دفعي وتسمح له اختياريا بتغيير البيئة.
ذاكرة التخزين المؤقت Cache@2	تخزين الملفات مؤقتا بين عمليات التشغيل.
ذاكرة التخزين المؤقت (بيتا) CacheBeta@1 CacheBeta@0	تخزين الملفات مؤقتا بين عمليات التشغيل.
سطر الأوامر CmdLine@2 CmdLine@1	شغل سكريبت سطر أوامر باستخدام Bash على لينكس وmacOS وcmd.exe على Windows.
نسخ ونشر البيانات الاصطناعية للبناء CopyPublishBuildArtifacts@1	تم إهمال CopyPublishBuildArtifacts@1. استخدم مهمة نسخ الملفات والمهمة نشر البيانات الاصطناعية للبناء بدلا من ذلك.
نسخ الملفات CopyFiles@2	نسخ الملفات من مجلد مصدر إلى مجلد هدف باستخدام أنماط مطابقة مسارات الملفات (وليس مسارات المجلدات).
نسخ الملفات CopyFiles@1	انسخ الملفات من المجلد المصدر إلى المجلد الهدف باستخدام أنماط المطابقات المصغرة (ستتطابق أنماط المطابقة المصغرة مع مسارات الملفات فقط، وليس مسارات المجلدات).
ملفات تحميل cURL cURLUploader@2 cURLUploader@1	استخدم بروتوكولات cURL المدعومة لتحميل الملفات.
فك تشفير الملف (OpenSSL) DecryptFile@1	فك تشفير ملف باستخدام OpenSSL.
تأخير Delay@1	تأخير تنفيذ سير عمل آخر لوقت ثابت.
حذف الملفات DeleteFiles@1	حذف المجلدات أو الملفات المطابقة لنمط.
نشر Azure تطبيق ويب ثابت AzureStaticWebApp@0	ابن ونشر تطبيق ويب ثابت لنظام Azure.
تنزيل البيانات الاصطناعية من مشاركة الملفات DownloadFileshareArtifacts@1	قم بتنزيل البيانات الاصطناعية من مشاركة ملف، مثل \share\drop.
تنزيل البيانات الاصطناعية للبناء DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	قم بتنزيل الملفات التي تم حفظها كقطع أثرية لبنية مكتملة.
تحميل GitHub الإصدار DownloadGitHubRelease@0	يقوم بتحميل إصدار GitHub من مستودع.
حزمة تنزيل DownloadPackage@1 DownloadPackage@0	قم بتنزيل حزمة من خلاصة إدارة الحزم في البيانات الاصطناعية من Azure.
تنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية 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 AzureFunction@1 AzureFunction@0	Invoke an Azure function.
Jenkins تنزيل البيانات الاصطناعية JenkinsDownloadArtifacts@2 JenkinsDownloadArtifacts@1	قم بتنزيل البيانات الاصطناعية التي تنتجها وظيفة Jenkins.
Node.js مثبت مشغل المهام NodeTaskRunnerInstaller@0	تثبيت إصدار Node.js معين لتشغيل مهام العقدة.
تدوين Notation@0	مهمة Azure Pipepine لإعداد CLI التدوين، توقيع والتحقق باستخدام Notation.
PowerShell PowerShell@2 PowerShell@1	شغل سكريبت PowerShell على لينكس أو macOS أو Windows.
Publish build artifacts PublishBuildArtifacts@1	نشر build artifacts إلى Azure Pipelines أو مشاركة ملفات Windows.
نشر البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية PublishPipelineArtifact@1 PublishPipelineArtifact@0	نشر (تحميل) ملف أو دليل كأداة مسماة للتشغيل الحالي.
نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية PublishPipelineMetadata@0	نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية إلى مخزن الأدلة.
انشر إلى ناقل خدمة Azure PublishToAzureServiceBus@2 PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	يرسل رسالة إلى ناقل خدمة Azure باستخدام اتصال خدمة Azure Resource Manager (لا يلزم وجود وكيل).
Python النص PythonScript@0	شغل ملف Python أو سكريبت داخلي.
Query Azure Monitor alerts AzureMonitor@1	Observe the configured Azure Monitor rules for active alerts.
استعلام Classic Azure Monitor alerts AzureMonitor@0	Observe the configured classic Azure Monitor rules for active alerts.
عناصر عمل الاستعلام queryWorkItems@0	تنفيذ استعلام عنصر عمل والتحقق من عدد العناصر التي تم إرجاعها.
تطبيق مراجعة ReviewApp@0	استخدم هذه المهمة ضمن موفر مرحلة التوزيع لإنشاء مورد ديناميكيا.
Service Fabric PowerShell ServiceFabricPowerShell@1	تشغيل سكريبت PowerShell في سياق اتصال cluster Azure Service Fabric.
البرنامج النصي Shell ShellScript@2	تشغيل برنامج نصي shell باستخدام Bash.
Update Service Fabric App Versions ServiceFabricUpdateAppVersions@1	يقوم تلقائيا بتحديث إصدارات تطبيق Service Fabric المعبأ.
تحديث الخدمة Fabric البيانات ServiceFabricUpdateManifests@2	تحديث أجزاء من بيانات التطبيقات والخدمات تلقائيا في تطبيق Azure Service Fabric معبأ.

مفتوح المصدر

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

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

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

يتم تعريف الإدخالات إلى مهمة بواسطة 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. توضح تسمية إدخال المضيفين المعروفين في مصمم البنية الأساسية لبرنامج ربط العمليات التجارية الكلاسيكية هذا الأمر، ولكنه ليس واضحا عند استخدام اسم في مسار 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 في موضع الاسم hostName في مجموعة aliases.

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

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

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

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

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

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

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

إنشاء تطبيقك

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

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

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

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

الإصدارات السابقة

• Azure DevOps Server 2020.1 مرجع المهمة
• Azure DevOps Server مرجع مهمة 2020
• Azure DevOps Server مرجع المهمة 2019.1
• Azure DevOps Server مرجع المهمة لعام 2019
• مرجع مهمة TFS 2018