مرجع مهمة 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 مخصص.
Advanced Security AutoBuild 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@1 DockerCompose@0	إنشاء تطبيقات Docker متعددة الحاويات أو دفعها أو تشغيلها. يمكن استخدام المهمة مع سجل Docker أو Azure Container.
تنزيل حزم GitHub Nuget DownloadGitHubNugetPackage@1	استعادة حزم nuget باستخدام dotnet CLI.
Go 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@6 SonarQubePrepare@5 SonarQubePrepare@4	إعداد تكوين تحليل SonarQube.
نشر نتائج بوابة الجودة SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	نشر نتيجة بوابة الجودة في SonarQube على نتيجة بناء Azure DevOps، لاستخدامها بعد التحليل الفعلي.
تشغيل تحليل التعليمات البرمجية SonarQubeAnalyze@6 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 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 AzureAppConfigurationExport@10	قم بتنزيل قيم المفاتيح إلى متغيرات المهام من Azure App Configuration.
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 App Service 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 deploy AzureContainerApps@1 AzureContainerApps@0	مهمة Azure DevOps لإنشاء تطبيقات حاوية Azure ونشرها.
نشر Azure Database for 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 Functions الحاوية 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 Apps AzureSpringCloud@0	توزيع التطبيقات إلى Azure Spring Apps وإدارة عمليات التوزيع.
نشر قاعدة بيانات Azure SQL SqlAzureDacpacDeployment@1	نشر قاعدة بيانات Azure SQL باستخدام DACPAC أو تشغيل البرامج النصية باستخدام SQLCMD.
توزيع مجموعة مقياس جهاز Azure الظاهري AzureVmssDeployment@0	نشر صورة مجموعة مقياس الجهاز الظاهري.
Azure Web App AzureWebApp@1	نشر Azure Web App لنظام التشغيل Linux أو Windows.
Azure Web App للحاويات AzureWebAppContainer@1	نشر حاويات إلى Azure App Service.
صورة جهاز Build PackerBuild@1 PackerBuild@0	إنشاء صورة جهاز باستخدام Packer، والتي يمكن استخدامها لنشر مجموعة مقياس الجهاز الظاهري Azure.
التحقق من التوافق مع نهج Azure AzurePolicyCheckGate@0	تقييم الأمان والتوافق لنهج Azure.
Chef Chef@1	النشر إلى بيئات Chef عن طريق تحرير سمات البيئة.
Chef Knife ChefKnife@1	تشغيل البرامج النصية باستخدام أوامر Knife على محطة عمل Chef.
نسخ الملفات عبر SSH CopyFilesOverSSH@0	نسخ الملفات أو إنشاء البيانات الاصطناعية إلى جهاز بعيد عبر SSH.
Deploy to 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	نشر وتكوين وتحديث مجموعة Kubernetes في Azure Container Service عن طريق تشغيل أوامر kubectl.
التدخل اليدوي ManualIntervention@8	أوقف النشر مؤقتا وانتظر التدخل اليدوي.
التحقق اليدوي ManualValidation@1 ManualValidation@0	إيقاف تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية مؤقتا لانتظار التفاعل اليدوي. يعمل فقط مع مسارات YAML.
توزيع قاعدة بيانات MySQL MysqlDeploymentOnMachineGroup@1	تشغيل البرامج النصية وإجراء تغييرات على قاعدة بيانات MySQL.
حزم مخططات Helm وتوزيعها HelmDeploy@1 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	مهمة المصادقة لعميل الشحن المستخدم لتثبيت توزيع صناديق 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 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" بدلا من ذلك. وهو يعمل مع إطار عمل Tool Installer الجديد بحيث يمكنك بسهولة استخدام إصدارات جديدة من NuGet دون انتظار تحديث مهمة، ويوفر دعما أفضل للموجزات المصادق عليها خارج هذه المؤسسة/المجموعة، ويستخدم NuGet 4 بشكل افتراضي.
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 المصادقة PipAuthenticate@1 PipAuthenticate@0	مهمة المصادقة لعميل pip المستخدم لتثبيت توزيعات Python.
تحميل Python twine مصادقة TwineAuthenticate@1 TwineAuthenticate@0	المصادقة لتحميل توزيعات Python باستخدام twine. أضف '-r FeedName/EndpointName --config-file $(PYPIRC_PATH)' إلى أمر التحميل المزدوج. بالنسبة للموجزات الموجودة في هذه المؤسسة، استخدم اسم الموجز كمستودع (-r). وإلا، استخدم اسم نقطة النهاية المحدد في اتصال الخدمة.
حزم العالمية UniversalPackages@0	تنزيل الحزم العالمية أو نشرها.
استعادة مكون Xamarin XamarinComponentRestore@0	هذه المهمة مهملة. استخدم "NuGet" بدلا من ذلك.

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

مهمة	وصف
اختبار App Center AppCenterTest@1	اختبار حزم التطبيقات باستخدام Visual Studio App Center.
اختبار تحميل Azure AzureLoadTest@1	أتمتة اختبار تراجع الأداء باستخدام اختبار تحميل Azure.
اختبار بنية حاوية 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) مهملة. استخدم مهمة "Visual Studio Test" بدلا من ذلك. يمكن لمهمة VSTest تشغيل الوحدة بالإضافة إلى الاختبارات الوظيفية. قم بتشغيل الاختبارات على عامل واحد أو أكثر باستخدام إعداد الوظيفة متعددة العوامل. استخدم مهمة "Visual Studio Test Platform" لتشغيل الاختبارات دون الحاجة إلى Visual Studio على العامل. توفر مهمة VSTest أيضا قدرات جديدة مثل إعادة تشغيل الاختبارات الفاشلة تلقائيا.
اختبار Visual Studio VSTest@3 VSTest@2 VSTest@1	قم بتشغيل الوحدة والاختبارات الوظيفية (Selenium وAppium واختبار Coded UI وما إلى ذلك) باستخدام مشغل 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.

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

مهمة	وصف
فحص تبعية الأمان المتقدمة AdvancedSecurity-Dependency-Scanning@1	افحص بحثا عن ثغرات تبعية مفتوحة المصدر في التعليمات البرمجية المصدر.
ملفات الأرشيف ArchiveFiles@2	ضغط الملفات إلى .7z أو .tar.gz أو .zip.
ملفات الأرشيف ArchiveFiles@1	أرشفة الملفات باستخدام تنسيقات الضغط مثل .7z .rar.tar.gz .zip.
استيراد تكوين تطبيق Azure AzureAppConfigurationImport@10	دفع قيم المفاتيح إلى مثيل Azure App Configuration.
لقطة تكوين تطبيق Azure AzureAppConfigurationSnapshot@1	إنشاء لقطة في مثيل Azure App Configuration.
موازن تحميل شبكة Azure 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 على Linux و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 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.
Publish build artifacts PublishBuildArtifacts@1	نشر البيانات الاصطناعية للبناء إلى Azure Pipelines أو مشاركة ملف Windows.
نشر البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية PublishPipelineArtifact@1 PublishPipelineArtifact@0	نشر (تحميل) ملف أو دليل كأداة مسماة للتشغيل الحالي.
نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية PublishPipelineMetadata@0	نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية إلى مخزن الأدلة.
نشر إلى ناقل خدمة Microsoft Azure PublishToAzureServiceBus@2 PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	إرسال رسالة إلى ناقل خدمة Microsoft Azure باستخدام اتصال خدمة Azure Resource Manager (لا يلزم وجود عامل).
البرنامج النصي Python PythonScript@0	تشغيل ملف Python أو برنامج نصي مضمن.
الاستعلام عن تنبيهات Azure Monitor AzureMonitor@1	راقب قواعد Azure Monitor المكونة للتنبيهات النشطة.
تنبيهات Query Classic 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. نرحب بالتعليقات والمساهمات. راجع سجل تغيير مهمة 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 المدعومة.
• تحديث كل دورة متكررة لتغطية آخر التحديثات.

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

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

إنشاء تطبيقك

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

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

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

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