DotNetCoreCLI@2 - مهمة .NET الأساسية v2

بناء أو اختبار أو تغليف أو نشر تطبيق .NET، أو تشغيل أمر CLI مخصص ب .NET.

إعراب

# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    #azureSubscription: # string. Alias: ConnectedServiceName. Azure Resource Manager connection. 
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s) or solution(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to Package. Default: $(BuildConfiguration).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Feeds and authentication
    #feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts feed. Select from the dropdown or enter [project name/]feed name. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Normal.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber' | 'bySemVerBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Normal.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.
# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    #azureSubscription: # string. Alias: ConnectedServiceName. Azure Resource Manager connection. 
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s) or solution(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to Package. Default: $(BuildConfiguration).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Feeds and authentication
    #feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts feed. Select from the dropdown or enter [project name/]feed name. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Normal.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Normal.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.
# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s) or solution(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to Package. Default: $(BuildConfiguration).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
  # Feeds and authentication
    #feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.
# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to Package. Default: $(BuildConfiguration).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
  # Feeds and authentication
    #feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.

المدخلات

<اتصال c0 />Azure Resource Manager
الاسم المستعار للإدخل: . Person.

حدد اتصال خدمة Azure Resource Manager مهيأ مع اتحاد هوية الحمل لاستخدام AzurePipelinesCredential في اختبارات التكامل. لمزيد من المعلومات، راجع استخدام AzurePipelinesCredential في اختبارات التكامل.

ملاحظه

يدعم هذا الإدخال اتصالات خدمة ARM التي تم تكوينها لاستخدام اتحاد هوية حمل العمل فقط.


أوامر
Person. مطلوب. القيم المسموح بها: (دفع nuget) . القيمة الافتراضية: .

الأمر dotnet للتشغيل. حدد لإضافة وسيطات أو استخدام أمر غير مدرج هنا.

مهم

مهمة NuGet Authenticate هي الطريقة الجديدة الموصى بها للمصادقة باستخدام البيانات الاصطناعية من Azure ومستودعات NuGet الأخرى. أوامر restore و push في مهمة CLI الأساسية .NET لم تعد تأخذ ميزات جديدة ويتم معالجة الأخطاء الحرجة فقط. راجع الملاحظات للحصول على التفاصيل.


نشر مشاريع الويب
Person. اختياري. استخدم عند . القيمة الافتراضية: .

إذا تم تعيين هذا الإدخال إلى ، يتم تخطي قيمة الخاصية ، وتحاول المهمة العثور على مشاريع الويب في المستودع وتشغيل أمر النشر عليها. يتم تحديد مشاريع ويب من خلال وجود ملف أو مجلد في الدليل. في غياب ملف web.config أو مجلد wwwroot، يتم اختيار المشاريع التي تستخدم حزمة تطوير البرمجيات (SDK) مثل Microsoft.NET.Sdk.Web.


المسار إلى المشروع (المشاريع) أو الحل (الحلول)
Person. اختياري. استخدم عند .

المسار إلى أو الملف (الملفات) المراد استخدامها. يمكنك استخدام أحرف البدل (على سبيل المثال، لجميع ملفات في جميع المجلدات الفرعية). لمزيد من المعلومات، راجع مرجع أنماط مطابقة الملفات .

هذا المسار نسبة إلى جذر المستودع بغض النظر عن إعداد .


المسار إلى المشروع (المشاريع)
Person. اختياري. استخدم عند .

المسار إلى الملف (الملفات) المراد استخدامها. يمكنك استخدام أحرف البدل (على سبيل المثال، لجميع ملفات في جميع المجلدات الفرعية). لمزيد من المعلومات، راجع مرجع أنماط مطابقة الملفات .

هذا المسار نسبة إلى جذر المستودع بغض النظر عن إعداد .


الأمر المخصص
Person. مطلوب عند .

الأمر الذي يجب تمريره إلى للتنفيذ. للحصول على قائمة كاملة بالأوامر المتوفرة، راجع وثائق dotnet CLI.


الوسيطات
Person. اختياري. استخدم عند .

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

يقبل هذا الإدخال حاليا وسيطات . إذا كنت ترغب في إضافة وسيطات لأمر غير مدرج، فاستخدم .


الوسيطات
Person. اختياري. استخدم عند .

يكتب الوسيطات الإضافية لتمريرها إلى الأمر .


نشر نتائج الاختبار وتغطية التعليمات البرمجية
Person. اختياري. استخدم عند . القيمة الافتراضية: .

سيؤدي تمكين هذا الخيار إلى إنشاء ملف TRX في ، وسيتم نشر النتائج على الخادم.

بالنسبة ل VSTest، يضاف هذا الخيار إلى وسيطات سطر الأوامر. بالنسبة ل Microsoft.Testing.Platform، عند اكتشافه كعريف اختبار في ، يضاف هذا الخيار إلى موسيط سطر الأوامر.

يمكن جمع تغطية الكود بإضافة خيار (ل VSTest) أو (ل Microsoft.Testing.Platform) إلى أوطال سطر الأوامر.


عنوان تشغيل Test
Person. اختياري. استخدم عند .

يوفر اسما لتشغيل الاختبار.


المشاريع المنشورة Zip
Person. اختياري. استخدم عند . القيمة الافتراضية: .

إذا تم تعيين هذا الإدخال إلى ، ضغط المجلدات التي تم إنشاؤها بواسطة أمر النشر وحذفها.


إضافة اسم مجلد المشروع لنشر مسار
Person. اختياري. استخدم عند . القيمة الافتراضية: .

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


موجزات لاستخدام
الاسم المستعار للإدخل: . Person. مطلوب عند . القيم المسموح بها: (الموجزات) التي أختارها هنا)، (الموجزات في NuGet.config). القيمة الافتراضية: .

يمكنك إما اختيار تغذية من البيانات الاصطناعية من Azure و/أو NuGet.org هنا، أو يمكنك ربط ملف nuget.config إلى مستودع الشيفرة المصدرية وضبط مساره باستخدام مدخل nugetConfigPath.


vstsFeed - استخدم الحزم من هذا الخلاصة البيانات الاصطناعية من Azure. اختر من القائمة المنسدلة أو أدخل [اسم المشروع/]الخلاصة.
الاسم المستعار للإدخل: . Person. اختياري. استخدم عند .

يتضمن الموجز المحدد في الذي تم إنشاؤه . يجب أن تكون إدارة الحزم مثبتة ومرخصة لتحديد موجز هنا. يتم استخدام لموجزات نطاق المشروع. يتم استخدام فقط للموجزات ذات نطاق المؤسسة. ملاحظة: هذا غير معتمد للأمر .


vstsFeed - استخدم الحزم من هذا الخلاصة البيانات الاصطناعية من Azure
الاسم المستعار للإدخل: . Person. اختياري. استخدم عند .

يتضمن الموجز المحدد في الذي تم إنشاؤه . يجب أن تكون إدارة الحزم مثبتة ومرخصة لتحديد موجز هنا. يتم استخدام لموجزات نطاق المشروع. يتم استخدام فقط للموجزات ذات نطاق المؤسسة. ملاحظة: هذا غير معتمد لأمر الاختبار.


استخدام الحزم من NuGet.org
Person. اختياري. استخدم عند . القيمة الافتراضية: .

يتضمن في الذي تم إنشاؤه .


المسار إلى NuGet.config
Person. اختياري. استخدم عند .

في المستودع الخاص بك الذي يحدد الموجزات التي يمكن استعادة الحزم منها.


بيانات الاعتماد للموجزات خارج المؤسسة/المجموعة هذه
الاسم المستعار للإدخل: . Person. اختياري. استخدم عند .

اسم اتصال الخدمة المراد استخدامه للسجلات الخارجية المدرجة في المحدد . بالنسبة للموجزات داخل نفس المؤسسة أو المجموعة، اترك هذا الإدخال فارغا؛ يتم استخدام بيانات اعتماد البنية تلقائيا.


تعطيل ذاكرة التخزين المؤقت المحلية
Person. اختياري. استخدم عند . القيمة الافتراضية: .

يمنع NuGet من استخدام الحزم من ذاكرة التخزين المؤقت للجهاز المحلي.


دليل الوجهة
الاسم المستعار للإدخل: . Person. اختياري. استخدم عند .

يحدد المجلد الذي تم تثبيت الحزم فيه. إذا لم يتم تحديد أي مجلد، تتم استعادة الحزم في ذاكرة التخزين المؤقت الافتراضية لحزمة NuGet.


الإسهاب
Person. اختياري. استخدم عند . القيم المسموح بها: . القيمة الافتراضية: .

يحدد مقدار التفاصيل المعروضة في الإخراج للأمر .


الإسهاب
Person. اختياري. استخدم عند . القيم المسموح بها: . القيمة الافتراضية: .

يحدد مقدار التفاصيل المعروضة في الإخراج للأمر .


المسار إلى حزمة (حزم) NuGet لنشر
الاسم المستعار للإدخل: . Person. مطلوب عند . القيمة الافتراضية: .

النمط المراد مطابقته أو المسار إلى الملفات التي سيتم تحميلها. يمكن فصل أنماط متعددة بفواصل منقوطة، ويمكنك جعل النمط سالبا عن طريق بادئه . مثال: .


موقع موجز الهدف
Person. مطلوب عند . القيم المسموح بها: (هذه المؤسسة/المجموعة)، (خادم NuGet الخارجي (بما في ذلك المؤسسات/المجموعات الأخرى)). القيمة الافتراضية: .

تحديد ما إذا كان الموجز الهدف داخليا أم خارجيا.


موجز الهدف
الاسم المستعار للإدخل: . Person. مطلوب عند .

تحديد موجز مستضاف في هذه المؤسسة. يجب أن تكون إدارة الحزم مثبتة ومرخصة لتحديد موجز هنا.


نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية
Person. اختياري. استخدم عند . القيمة الافتراضية: .

إقران بيانات تعريف البنية/الإصدار (تشغيل #، معلومات التعليمات البرمجية المصدر) بالحزمة.


خادم NuGet
الاسم المستعار للإدخل: . Person. مطلوب عند .

اتصال خدمة NuGet الذي يحتوي على بيانات اعتماد خادم NuGet الخارجي.


المسار إلى ملف (ملفات) csproj أو nuspec لحزم
الاسم المستعار للإدخل: . Person. مطلوب عند . القيمة الافتراضية: .

النمط للبحث عن ملفات أو لحزمها.

يمكنك فصل أنماط متعددة بفواصل منقوطة، ويمكنك جعل النمط سالبا عن طريق بادئه . مثال: .


تكوين إلى حزمة
الاسم المستعار للإدخل: . Person. اختياري. استخدم عند . القيمة الافتراضية: .

عند استخدام ملف ، يحدد هذا الإدخال التكوين إلى حزمة.


مجلد حزمة
الاسم المستعار للإدخل: . Person. اختياري. استخدم عند . القيمة الافتراضية: .

المجلد الذي سيتم إنشاء الحزم فيه. إذا كان هذا المجلد فارغا، إنشاء الحزم إلى جانب ملف .


عدم إنشاء
Person. اختياري. استخدم عند . القيمة الافتراضية: .

تحديد أن المهمة لن تنشئ المشروع قبل التعبئة. تتوافق هذه المهمة مع المعلمة للأمر .


تضمين الرموز
Person. اختياري. استخدم عند . القيمة الافتراضية: .

إنشاء حزم NuGet للرمز. تتوافق هذه المهمة مع معلمة سطر الأوامر .


تضمين المصدر
Person. اختياري. استخدم عند . القيمة الافتراضية: .

يتضمن التعليمات البرمجية المصدر في الحزمة. تتوافق هذه المهمة مع معلمة سطر الأوامر .


تعيين إصدار الحزمة التلقائية
Person. مطلوب عند . القيم المسموح بها: ، (استخدم التاريخ والوقت)، (استخدم متغير البيئة)، (استخدم رقم البناء)، (استخدم رقم البناء الكامل لسيمفير). القيمة الافتراضية: .

لا يمكن استخدام هذه المهمة مع المشاريع المشار إليها المضمنة. إذا اخترت ، فسينشئ هذا إصدارا متوافقا مع SemVerبتنسيق حيث تختار .

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

إذا اخترت ، فسيستخدم هذا رقم الإصدار لإصدار الحزمة الخاصة بك. ملاحظة : ضمن ، قم بتعيين تنسيق رقم البنية إلى .


تعيين إصدار الحزمة التلقائية
Person. مطلوب عند . القيم المسموح بها: ، (استخدام التاريخ والوقت)، (استخدام متغير بيئة)، (استخدام رقم البناء). القيمة الافتراضية: .

لا يمكن استخدام هذه المهمة مع المشاريع المشار إليها المضمنة. إذا اخترت ، فسينشئ هذا إصدارا متوافقا مع SemVerبتنسيق حيث تختار .

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

إذا اخترت ، فسيستخدم هذا رقم الإصدار لإصدار الحزمة الخاصة بك. ملاحظة : ضمن ، قم بتعيين تنسيق رقم البنية إلى .


متغير البيئة
Person. مطلوب عند .

يحدد اسم المتغير دون أو أو أو .


الرئيسية
الاسم المستعار للإدخل: . Person. مطلوب عند . القيمة الافتراضية: .

في الإصدار X.Y.Z.


الثانوية
الاسم المستعار للإدخل: . Person. مطلوب عند . القيمة الافتراضية: .

في الإصدار X.Y.Z.


التصحيح
الاسم المستعار للإدخل: . Person. مطلوب عند . القيمة الافتراضية: .

في الإصدار X.Y.Z.


خصائص البنية الإضافية
Person. اختياري. استخدم عند .

يحدد قائمة أزواج ، مفصولة بفواصل منقوطة، حيث سيتم استبدال كل تكرار في ملف بالقيمة المحددة. يمكن أن تكون القيم سلاسل بعلامات اقتباس.


الإسهاب
Person. اختياري. استخدم عند . القيم المسموح بها: . القيمة الافتراضية: .

يحدد مقدار التفاصيل المعروضة في الإخراج للأمر .


الإسهاب
Person. اختياري. استخدم عند . القيم المسموح بها: . القيمة الافتراضية: .

يحدد مقدار التفاصيل المعروضة في الإخراج للأمر .


دليل العمل
Person. اختياري. استخدم عند .

دليل العمل الحالي حيث يتم تشغيل البرنامج النصي. هو جذر المستودع (البناء) أو البيانات الاصطناعية (الإصدار)، وهو .


تعيين المهلة لطلب تنزيل الحزمة
Person. القيمة الافتراضية: .

توفير قيمة مهلة لطلبات HTTP التي تقوم بها المهمة للحصول على حزمة .NET. القيمة بالمللي ثانية. الافتراضي هو 300000 مللي ثانية (5 دقائق). لا يمكن أن يكون أكثر من 600000 مللي ثانية (10 دقائق).


خيارات التحكم بالمهمة

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

متغيرات الإخراج

اي.

ملاحظات

مهم

مهمة NuGet Authenticate هي الطريقة الجديدة الموصى بها للمصادقة باستخدام البيانات الاصطناعية من Azure ومستودعات NuGet الأخرى. أوامر restore و push في مهمة CLI الأساسية .NET لم تعد تأخذ ميزات جديدة ويتم معالجة الأخطاء الحرجة فقط.

استخدام AzurePipelinesCredential في اختبارات التكامل

توفر مكتبات الهوية Azure ل .NET وC++ وGo و Java وJavaScript و Python دعم اتحاد هوية عبء العمل، بحيث يمكن للكود المنفذ من مهام AzureCLI@2 وAzurePowerShell@5 المصادقة مع Microsoft Entra ID (على سبيل المثال، للوصول إلى الشيفرة Azure) باستخدام فئة AzurePipelinesCredential.

يستخدم العديد من العملاء مكتبات عملاء Azure SDK في اختبارات التكامل التي يتم استدعاؤها من مهام أخرى. يمكن لمهام DotNetCoreCLI@2، Maven@4 و VSTest@3 الوصول إلى الموارد Azure باستخدام فئة AzurePipelinesCredential.

يمكنك تعيين خاصية connectedServiceName على اتصال خدمة Azure مكونا مع اتحاد هوية العبء. يتطلب تعيين SYSTEM_ACCESSTOKEN.

يوضح المثال التالي إدخال في مهمة . والاستخدام متشابهان.

- task: DotNetCoreCLI@2
  inputs:
    command: 'run'
    connectedServiceName: <Azure service connection configured with workload identity federation>
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)

لمزيد من المعلومات حول AzurePipelinesCredential، راجع تحسين وضعية الأمان في اتصالات الخدمة Azure باستخدام AzurePipelinesCredential.

لماذا تفشل خطوة الإنشاء أو النشر أو الاختبار لاستعادة الحزم؟

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

لإصلاح هذه المشكلة، أضف علامة إلى مربع نص .

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

لماذا أحصل على تحذيرات NU1507 مع Package Source Mapping على الرغم من عدم وجود تحذيرات عند الإنشاء على جهازي؟

تنشئ الأوامر المختلفة التي تقوم باستعادة NuGet أو الوصول إلى موجز NuGet ملف مؤقت خاص يضيف مصادقة NuGet لموجزات NuGet الخاصة ب azure artifacts. تتعارض طريقة القيام بذلك مع المخطط الذي يستخدمه Package Source Mapping لتعيين الحزم إلى المصادر وكسر تكوين Package Source Mappin في ملف في المستودع الخاص بك. لحل هذا التعارض، يمكنك استخدام مهمة NuGet Authenticate للمصادقة وبعد ذلك الأمر المخصص لاستدعاء الأمر dotnet المطلوب دون تعديل .

# Authenticate Azure DevOps NuGet feed
- task: NuGetAuthenticate@1
  displayName: 'Authenticate Azure DevOps NuGet feed'

# Restore project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'restore'

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'build'
    arguments: '--no-restore'

لماذا يجب أن أتحقق من NuGet.config؟

يضمن التحقق من في التحكم بالمصادر توفر جزء رئيسي من المعلومات اللازمة لإنشاء مشروعك - موقع حزمه - لكل مطور يتحقق من التعليمات البرمجية الخاصة بك.

ومع ذلك، في الحالات التي يعمل فيها فريق من المطورين على مجموعة واسعة من المشاريع، من الممكن أيضا إضافة تغذية البيانات الاصطناعية من Azure إلى NuGet.config العالمي على جهاز كل مطور. في هذه الحالات، يؤدي استخدام الخيار في مهمة NuGet إلى نسخ هذا التكوين نسخا متماثلا.

استكشاف الاخطاء

توقف المشروع الذي يستخدم Entity Framework عن العمل على Hosted Agents

لا يحتوي .NET Core على إطار عمل الكيانات (EF) المدمج. ستحتاج إما إلى تثبيت EF قبل بدء التنفيذ أو إضافة global.json إلى المشروع مع النسخة المطلوبة .NET Core SDK. سيضمن ذلك استخدام SDK الصحيح لإنشاء مشروع EF. إذا لم يكن الإصدار المطلوب موجودا على الجهاز، أضف مهمة إلى البنية الأساسية لبرنامج ربط العمليات التجارية لتثبيت الإصدار المطلوب. لمزيد من المعلومات، راجع احصل على مدة تشغيل Entity Framework Core.

امثله

  • أمثلة Build
  • أمثلة دفع
  • أمثلة دفع
  • أمثلة حزمة
  • أمثلة Publish
  • استعادة الأمثلة
  • أمثلة اختبار

إنشاء أمثلة

إنشاء مشروع

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'

إنشاء مشاريع متعددة

# Build multiple projects
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: |
      src/proj1/proj1.csproj 
      src/proj2/proj2.csproj 
      src/other/other.sln    # Pass a solution instead of a csproj.

أمثلة الدفع

دفع حزم NuGet إلى الموجز الداخلي

# Push non test NuGet packages from a build to internal organization Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    searchPatternPush: '$(Build.ArtifactStagingDirectory)/*.nupkg;!$(Build.ArtifactStagingDirectory)/*.Tests.nupkg'
    feedPublish: 'FabrikamFeed'

دفع حزم NuGet إلى موجز خارجي

# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    nugetFeedType: 'external'
    externalEndPoint: 'MyNuGetServiceConnection'

أمثلة الحزمة

حزم NuGetPackage إلى دليل إخراج معين

# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'

حزم حزمة رمز

# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    includesymbols: true

نشر الأمثلة

نشر المشاريع إلى مجلد محدد

# Publish projects to specified folder.
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: 'publish'
    publishWebProjects: false
    arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
    zipAfterPublish: true
    modifyOutputPath: true

استعادة الأمثلة

#Restore packages with the .NET Core CLI task
- task: DotNetCoreCLI@2
  displayName: 'dotnet restore'
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    feedRestore: 'projectName/feedName'
    projects: '**/*.csproj'
    includeNuGetOrg: true

أمثلة الاختبار

تشغيل الاختبارات في المستودع الخاص بك

# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
  inputs:
    command: 'test'

المتطلبات

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