DotNetCoreCLI@2 - .NET Core v2 görevi
Bir dotnet uygulaması derleyin, test edin, paketleyin veya yayımlayın ya da özel bir dotnet komutu çalıştırın.
Bir dotnet uygulaması derleyin, test edin, paketleyin veya yayımlayın ya da özel bir dotnet komutu çalıştırın. Paket komutları için Paket Yönetimi ve MyGet gibi NuGet.org ve kimliği doğrulanmış akışları destekler.
Önemli
NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarıyla kimlik doğrulaması yapmak için önerilen yeni yoldur. restore
Bu .NET Core CLI görevinin ve push
komutları artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir. Ayrıntılar için açıklamalara bakın.
Syntax
# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet 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 && command = push. 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 && command != pack && command != push && command != restore. Working directory.
# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet 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 && command = push. 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 && command != pack && command != push && command != restore. Working directory.
# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet 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.
#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 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 && command = push. 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 != pack && command != push && command != restore. Working Directory.
# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet command. For package commands, supports NuGet.org and authenticated feeds like Package Management and MyGet.
- 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.
#publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
#zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip Published Projects. Default: true.
#modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project 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.
# 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/TFS 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.
# 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 != pack && command != push && command != restore. Working Directory.
Girişler
command
- Komut
string
. Gereklidir. İzin verilen değerler: build
, push
(nuget push), pack
, publish
, restore
, run
, test
, custom
. Varsayılan değer: build
.
Çalıştırılacak dotnet komutu. Bağımsız değişken eklemek için belirtin custom
veya burada listelenmeyen bir komut kullanın.
Önemli
NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarıyla kimlik doğrulaması yapmak için önerilen yeni yoldur. restore
Bu .NET Core CLI görevinin ve push
komutları artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir. Ayrıntılar için açıklamalara bakın.
publishWebProjects
- Web projelerini yayımlama
boolean
. İsteğe bağlı. when command = publish
kullanın. Varsayılan değer: true
.
Bu giriş olarak true
projects
ayarlanırsa, özellik değeri atlanır ve görev depodaki web projelerini bulmaya çalışır ve bu projelerde yayımla komutunu çalıştırır. Web projeleri, dizindeki bir web.config
dosyanın veya wwwroot
klasörün varlığıyla tanımlanır. Bir dosya veya wwwroot
klasör olmadığındaweb.config
, gibi Microsoft.NET.Sdk.Web
bir web SDK'sı kullanan projeler seçilir.
publishWebProjects
- Web Projelerini Yayımla
boolean
. İsteğe bağlı. when command = publish
kullanın. Varsayılan değer: true
.
Bu giriş olarak true
projects
ayarlanırsa, özellik değeri atlanır ve görev depodaki web projelerini bulmaya çalışır ve bu projelerde yayımla komutunu çalıştırır. Web projeleri, dizindeki bir web.config
dosyanın veya wwwroot
klasörün varlığıyla tanımlanır. Bir dosya veya wwwroot
klasör olmadığındaweb.config
, gibi Microsoft.NET.Sdk.Web
bir web SDK'sı kullanan projeler seçilir.
projects
- Proje veya çözüm yolu
string
. İsteğe bağlı. when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false
kullanın.
Kullanılacak veya .sln
dosyasının .csproj
yolu. Joker karakterler kullanabilirsiniz (örneğin **/*.csproj
, tüm alt klasörlerdeki tüm .csproj
dosyalar için). Daha fazla bilgi için bkz. dosya eşleştirme desenleri başvurusu.
Bu yol, ayardan bağımsız olarak deponun köküne workingDirectory
göredir.
projects
- Proje yolu
string
. İsteğe bağlı. when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false
kullanın.
Kullanılacak dosya yolu .csproj
. Joker karakterler kullanabilirsiniz (örneğin **/*.csproj
, tüm alt klasörlerdeki tüm .csproj
dosyalar için). Daha fazla bilgi için bkz. dosya eşleştirme desenleri başvurusu.
Bu yol, ayardan bağımsız olarak deponun köküne workingDirectory
göredir.
custom
- Özel komut
string
. olduğunda command = custom
gereklidir.
Yürütme için geçirilir dotnet.exe
komutu. Kullanılabilir komutların tam listesi için dotnet CLI belgelerine bakın.
arguments
- Bağımsız değişken
string
. İsteğe bağlı. when command = build || command = publish || command = run || command = test || command = custom
kullanın.
Seçili komutun bağımsız değişkenlerini belirtir. Örneğin, derleme yapılandırması, çıkış klasörü ve çalışma zamanı. Bağımsız değişkenler, seçilen komuta bağlıdır.
Bu giriş şu anda yalnızca , , publish
, test
run
ve custom
bağımsız değişkenlerini kabul ederbuild
. Listelenmeyen bir komut için bağımsız değişkenler eklemek isterseniz kullanın custom
.
restoreArguments
- Bağımsız değişken
string
. İsteğe bağlı. when command = restore
kullanın.
Komutuna geçirilecek restore
ek bağımsız değişkenleri yazar.
publishTestResults
- Test sonuçlarını ve kod kapsamını yayımlama
boolean
. İsteğe bağlı. when command = test
kullanın. Varsayılan değer: true
.
Bu seçeneğin etkinleştirilmesi, içinde $(Agent.TempDirectory)
bir test results
TRX dosyası oluşturur ve sonuçlar sunucuda yayımlanır.
Bu seçenek komut satırı bağımsız değişkenlerine eklenir --logger trx --results-directory $(Agent.TempDirectory)
.
Kod kapsamı, komut satırı bağımsız değişkenlerine seçeneği eklenerek --collect "Code coverage"
toplanabilir.
testRunTitle
- Test çalıştırması başlığı
string
. İsteğe bağlı. when command = test
kullanın.
Test çalıştırması için bir ad sağlar.
zipAfterPublish
- Yayımlanan projeleri zip ile yayımlama
boolean
. İsteğe bağlı. when command = publish
kullanın. Varsayılan değer: true
.
Bu giriş olarak ayarlanırsa true
, yayımla komutu tarafından oluşturulan klasörler daraltılır ve silinir.
zipAfterPublish
- Zip Yayımlanan Projeler
boolean
. İsteğe bağlı. when command = publish
kullanın. Varsayılan değer: true
.
Bu giriş olarak ayarlanırsa true
, yayımla komutu tarafından oluşturulan klasör daraltılır ve silinir.
modifyOutputPath
- Yayımlama yoluna projenin klasör adını ekleme
boolean
. İsteğe bağlı. when command = publish
kullanın. Varsayılan değer: true
.
Bu giriş olarak true
ayarlanırsa, çıkış yolu bağımsız değişkenlerde açıkça belirtildiğinde, yayımla komutu tarafından oluşturulan klasörlerin klasör adlarına proje dosya adı ön eki eklenir. Aynı klasöre birden çok proje yayımlamak istiyorsanız bu yararlı olur.
modifyOutputPath
- Yayımlama yoluna proje adı ekleme
boolean
. İsteğe bağlı. when command = publish
kullanın. Varsayılan değer: true
.
Bu giriş olarak true
ayarlanırsa, çıkış yolu bağımsız değişkenlerde açıkça belirtildiğinde, yayımla komutu tarafından oluşturulan klasörlerin klasör adlarına proje dosya adı ön eki eklenir. Aynı klasöre birden çok proje yayımlamak istiyorsanız bu yararlı olur.
feedsToUse
- Kullanılacak akışlar
Giriş diğer adı: selectOrConfig
. string
. olduğunda command = restore
gereklidir. İzin verilen değerler: select
(Burada seçtiğim akışlar), config
(NuGet.config akışlar). Varsayılan değer: select
.
Azure Artifacts'ten ve/veya buradan bir akış seçebilir veya NuGet.org
bir nuget.config
dosyayı kaynak kod deponuza işleyebilir ve girişi kullanarak nugetConfigPath
yolunu ayarlayabilirsiniz.
vstsFeed
- Bu Azure Artifacts akışındaki paketleri kullan
Giriş diğer adı: feedRestore
. string
. İsteğe bağlı. when selectOrConfig = select && command = restore
kullanın.
Seçilen akışı oluşturulan NuGet.config
içine ekler. Burada bir akış seçmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir. projectName
/feedName
proje kapsamlı akışlar için kullanılır. Yalnızca FeedName
kuruluş kapsamındaki akışlar için kullanılır. Not: Bu, test komutu için desteklenmez.
vstsFeed
- Bu Azure Artifacts/TFS akışındaki paketleri kullan
Giriş diğer adı: feedRestore
. string
. İsteğe bağlı. when selectOrConfig = select && command = restore
kullanın.
Seçilen akışı oluşturulan NuGet.config
içine ekler. Burada bir akış seçmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir. projectName
/feedName
, proje kapsamlı akışlar için kullanılır. Yalnızca FeedName
kuruluş kapsamındaki akışlar için kullanılır. Not: Bu, test komutu için desteklenmez.
includeNuGetOrg
- NuGet.org paketlerini kullanma
boolean
. İsteğe bağlı. when selectOrConfig = select && command = restore
kullanın. Varsayılan değer: true
.
Oluşturulan NuGet.config
öğesine eklerNuGet.org
.
nugetConfigPath
- NuGet.configyolu
string
. İsteğe bağlı. when selectOrConfig = config && command = restore
kullanın.
NuGet.config
Deponuzda, paketlerin geri yükleneceği akışları belirten .
externalFeedCredentials
- Bu kuruluş/koleksiyon dışındaki akışlar için kimlik bilgileri
Giriş diğer adı: externalEndpoints
. string
. İsteğe bağlı. when selectOrConfig = config && command = restore
kullanın.
Seçili NuGet.config
içinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgileri. Bu kuruluştaki/koleksiyondaki akışlar için bu girişi boş bırakın; derlemenin kimlik bilgileri otomatik olarak kullanılır.
noCache
- Yerel önbelleği devre dışı bırakma
boolean
. İsteğe bağlı. when command = restore
kullanın. Varsayılan değer: false
.
NuGet'in yerel makine önbelleklerindeki paketleri kullanmasını engeller.
restoreDirectory
- Hedef dizin
Giriş diğer adı: packagesDirectory
. string
. İsteğe bağlı. when command = restore
kullanın.
Paketlerin yüklendiği klasörü belirtir. Hiçbir klasör belirtilmezse paketler varsayılan NuGet paket önbelleğine geri yüklenir.
verbosityRestore
- Ayrıntı
string
. İsteğe bağlı. when command = restore
kullanın. İzin verilen değerler: -
, Quiet
, Minimal
, Normal
, , Diagnostic
Detailed
. Varsayılan değer: Detailed
.
Komutun çıktısında restore
görüntülenen ayrıntı miktarını belirtir.
packagesToPush
- Yayımlayacak NuGet paketlerinin yolu
Giriş diğer adı: searchPatternPush
. string
. olduğunda command = push
gereklidir. Varsayılan değer: $(Build.ArtifactStagingDirectory)/*.nupkg
.
Eşleştirilecek desen veya karşıya yüklenecek dosyaların yolu nupkg
. Birden çok desen noktalı virgülle ayrılabilir ve ön ek !
olarak ekleyerek deseni negatif yapabilirsiniz. Örnek: **/*.nupkg;!**/*.Tests.nupkg
.
nuGetFeedType
- Hedef akış konumu
string
. olduğunda command = push
gereklidir. İzin verilen değerler: internal
(Bu kuruluş/koleksiyon), external
(Dış NuGet sunucusu (diğer kuruluşlar/koleksiyonlar dahil)). Varsayılan değer: internal
.
Hedef akışın iç mi yoksa dış mı olduğunu belirtir.
publishVstsFeed
- Hedef akış
Giriş diğer adı: feedPublish
. string
. olduğunda command = push && nuGetFeedType = internal
gereklidir.
Bu kuruluşta barındırılan bir akışı belirtir. Burada bir akış seçmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.
publishPackageMetadata
- İşlem hattı meta verilerini yayımlama
boolean
. İsteğe bağlı. when command = push && nuGetFeedType = internal && command = push
kullanın. Varsayılan değer: true
.
Bu derleme/yayın işlem hattının meta verilerini (#, kaynak kodu bilgilerini çalıştır) paketle ilişkilendirir.
publishFeedCredentials
- NuGet sunucusu
Giriş diğer adı: externalEndpoint
. string
. olduğunda command = push && nuGetFeedType = external
gereklidir.
Dış NuGet sunucusunun kimlik bilgilerini içeren NuGet hizmet bağlantısı .
packagesToPack
- Pakete csproj veya nuspec dosyası yolu
Giriş diğer adı: searchPatternPack
. string
. olduğunda command = pack
gereklidir. Varsayılan değer: **/*.csproj
.
Aranacak .csproj
desen veya .nuspec
paketlenmek üzere dosyalar.
Birden çok deseni noktalı virgülle ayırabilir ve ön ekiyle !
ekleyerek deseni negatif yapabilirsiniz. Örnek: **/*.csproj;!**/*.Tests.csproj
.
configuration
- Yapılandırmadan Pakete
Giriş diğer adı: configurationToPack
. string
. İsteğe bağlı. when command = pack
kullanın. Varsayılan değer: $(BuildConfiguration)
.
Bir .csproj
dosya kullanılırken, bu giriş pakete eklenecek yapılandırmayı belirtir.
packDirectory
- Paket Klasörü
Giriş diğer adı: outputDir
. string
. İsteğe bağlı. when command = pack
kullanın. Varsayılan değer: $(Build.ArtifactStagingDirectory)
.
Paketlerin oluşturulacağı klasör. Bu klasör boşsa, dosyayla csproj
birlikte paketler oluşturulur.
nobuild
- Derleme
boolean
. İsteğe bağlı. when command = pack
kullanın. Varsayılan değer: false
.
Görevin paketlemeden önce projeyi oluşturacağını belirtir. Bu görev, komutun --no-build
parametresine build
karşılık gelir.
includesymbols
- Simgeleri Dahil Et
boolean
. İsteğe bağlı. when command = pack
kullanın. Varsayılan değer: false
.
Simge NuGet paketleri oluşturur. Bu görev komut satırı parametresine --include-symbols
karşılık gelir.
includesource
- Kaynağı Dahil Et
boolean
. İsteğe bağlı. when command = pack
kullanın. Varsayılan değer: false
.
Pakete kaynak kodu ekler. Bu görev komut satırı parametresine --include-source
karşılık gelir.
versioningScheme
- Otomatik paket sürümü oluşturma
string
. olduğunda command = pack
gereklidir. İzin verilen değerler: off
, byPrereleaseNumber
(Tarih ve saati kullanın), byEnvVar
(Ortam değişkeni kullanın), byBuildNumber
(Derleme numarasını kullanın). Varsayılan değer: off
.
Bu görev, eklenen başvurulan projelerle kullanılamaz. öğesini seçersenizUse the date and time
, bu, , Y
ve Z
seçeneklerini belirlediğiniz X
şekilde biçimlendirilmiş X.Y.Z-ci-datetime
SemVer uyumlu bir sürüm oluşturur.
seçerseniz Use an environment variable
, bir ortam değişkeni seçmeniz ve kullanmak istediğiniz sürüm numarasını içerdiğinden emin olmanız gerekir.
öğesini seçerseniz Use the build number
, paketinizin sürümünü oluşturmak için derleme numarası kullanılır. Not: altında Options
, derleme numarası biçimini olarak $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
ayarlayın.
versionEnvVar
- Ortam değişkeni
string
. olduğunda versioningScheme = byEnvVar && command = pack
gereklidir.
değişken adını , $env
veya %
olmadan $
belirtir.
majorVersion
- Büyük
Giriş diğer adı: requestedMajorVersion
. string
. olduğunda versioningScheme = byPrereleaseNumber && command = pack
gereklidir. Varsayılan değer: 1
.
X.Y.ZX
sürümündeki.
minorVersion
- Küçük
Giriş diğer adı: requestedMinorVersion
. string
. olduğunda versioningScheme = byPrereleaseNumber && command = pack
gereklidir. Varsayılan değer: 0
.
X.Y.ZY
sürümündeki.
patchVersion
- Yama
Giriş diğer adı: requestedPatchVersion
. string
. olduğunda versioningScheme = byPrereleaseNumber && command = pack
gereklidir. Varsayılan değer: 0
.
X.Y.ZZ
sürümündeki.
buildProperties
- Ek derleme özellikleri
string
. İsteğe bağlı. when command = pack
kullanın.
Dosyadaki .nuspec
her oluşumun token = value
$token$
verilen değerle değiştirileceği noktalı virgülle ayrılmış çiftlerin listesini belirtir. Değerler, tırnak işaretleri içindeki dizeler olabilir.
verbosityPack
- Ayrıntı
string
. İsteğe bağlı. when command = pack
kullanın. İzin verilen değerler: -
, Quiet
, Minimal
, Normal
, , Diagnostic
Detailed
. Varsayılan değer: Detailed
.
Komutun çıktısında pack
görüntülenen ayrıntı miktarını belirtir.
workingDirectory
- Çalışma dizini
string
. İsteğe bağlı. when command != restore && command != push && command != pack && command != pack && command != push && command != restore
kullanın.
Betiğin çalıştırıldığı geçerli çalışma dizini. Empty
, deponun (derleme) veya yapıtların (yayın) köküdür $(System.DefaultWorkingDirectory)
.
workingDirectory
- Çalışma Dizini
string
. İsteğe bağlı. when command != pack && command != push && command != restore
kullanın.
Betiğin çalıştırıldığı geçerli çalışma dizini. Empty
, deponun (derleme) veya yapıtların (yayın) köküdür $(System.DefaultWorkingDirectory)
.
Görev denetim seçenekleri
Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.
Çıkış değişkenleri
Yok.
Açıklamalar
Önemli
NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarıyla kimlik doğrulaması yapmak için önerilen yeni yoldur. restore
Bu .NET Core CLI görevinin ve push
komutları artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir.
Derleme, yayımlama veya test adımı neden paketleri geri yükleyemediğinde?
, publish
ve dahil olmak üzere build
çoğu dotnet
komut örtük restore
bir adım test
içerir. Önceki adımda kullanılan kimlik bilgileri temizlendiğinden, daha önceki bir adımda başarılı dotnet restore
bir şekilde çalıştırmış olsanız bile bu, kimliği doğrulanmış akışlarda başarısız olur.
Bu sorunu çözmek için bayrağını --no-restore
metin kutusuna Arguments
ekleyin.
Ayrıca, test
komut veya vstsFeed
bağımsız değişkenlerini tanımaz feedRestore
ve örtük restore
adım çalıştırıldığında bu şekilde belirtilen akışlar oluşturulan NuGet.config
dosyaya dahil edilmeyecektir. Paketleri geri yüklemek için açık dotnet restore
bir adımın kullanılması önerilir. restore
komutu ve vstsFeed
bağımsız değişkenlerine feedRestore
saygı gösterir.
Makinemde derleme yaparken hiçbir uyarı olmamasına rağmen neden Paket Kaynağı Eşlemesi ile NU1507 uyarıları alıyorum?
NuGet geri yükleme veya NuGet akışına erişme işlemi gerçekleştiren çeşitli komutlar, Azure yapıtları NuGet akışları için NuGet kimlik doğrulaması ekleyen özel bir geçici NuGet.config
dosya oluşturur. Bu işlem, Paket Kaynağı Eşlemesi'nin paketleri kaynaklara eşlemek için kullandığı şemayla çakışıyor ve deponuzdaki dosyadaki NuGet.config
Paket Kaynağı Eşleme yapılandırmasını bozuyor.
Bu çakışmayı geçici olarak çözmek için NuGet Kimlik Doğrulaması görevini kullanarak kimlik doğrulaması yapabilir ve daha sonra özel komutu kullanarak değişiklik yapmadan NuGet.config
istenen dotnet komutunu çağırabilirsiniz.
# 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'
Bir NuGet.config neden iade etmeliyim?
NuGet.config
Kaynak denetiminin denetlenmesi, projenizi oluşturmak için gereken önemli bir bilgi parçasının (paketlerinin konumu) kodunuzu kullanıma alan her geliştiricinin kullanımına sunulmasını sağlar.
Ancak, bir geliştirici ekibinin çok çeşitli projelerde çalıştığı durumlarda, her geliştiricinin makinesinde genele NuGet.config
bir Azure Artifacts akışı eklemek de mümkündür. Böyle durumlarda, NuGet görevindeki seçeneğinin kullanılması Feeds I select here
bu yapılandırmayı çoğaltır.
Sorun giderme
Entity Framework kullanan proje Barındırılan Aracılar üzerinde çalışmayı durdurdu
.NET Core'da Entity Framework (EF) yerleşik yoktur. Yürütmeye başlamadan önce EF'yi yüklemeniz veya gerekli .NET Core SDK sürümüyle projeye eklemeniz global.json
gerekir. Bu, EF projesi oluşturmak için doğru SDK'nın kullanılmasını sağlar. Makinede gerekli sürüm yoksa, gerekli sürümü yüklemek için görevi işlem hattınıza ekleyin UseDotNetV2
. Daha fazla bilgi için bkz. Entity Framework Core çalışma zamanını alma.
Örnekler
- Derleme örnekleri
- Gönderme örnekleri
- Gönderme örnekleri
- Paket örnekleri
- Yayımlama örnekleri
- Geri yükleme örnekleri
- Test örnekleri
Derleme örnekleri
Proje oluşturma
# Build project
- task: DotNetCoreCLI@2
inputs:
command: 'build'
Birden Çok Proje Oluşturma
# 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.
Gönderme örnekleri
NuGet paketlerini iç akışa gönderme
# 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 paketlerini dış akışa gönderme
# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
inputs:
command: 'push'
nugetFeedType: 'external'
externalEndPoint: 'MyNuGetServiceConnection'
Paket örnekleri
NuGetPackage'ı belirli bir çıkış dizinine paketleme
# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
inputs:
command: 'pack'
outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'
Sembol Paketi Paketleme
# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
inputs:
command: 'pack'
includesymbols: true
Yayımlama örnekleri
Projeleri belirtilen klasöre yayımlama
# Publish projects to specified folder.
- task: DotNetCoreCLI@2
displayName: 'dotnet publish'
inputs:
command: 'publish'
publishWebProjects: false
projects: '**/*.csproj'
arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
zipAfterPublish: true
modifyOutputPath: true
Geri yükleme örnekleri
#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
Test örnekleri
Deponuzda testleri çalıştırma
# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
inputs:
command: 'test'
Gereksinimler
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme, Klasik sürüm |
Üzerinde çalışır | Aracı |
Talep | Hiçbiri |
Özellikler | Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi biri |
Ayarlanabilir değişkenler | Herhangi biri |
Aracı sürümü | 2.144.0 veya üzeri |
Görev kategorisi | Yapı |
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme, Klasik sürüm |
Üzerinde çalışır | Aracı |
Talep | Hiçbiri |
Özellikler | Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi biri |
Ayarlanabilir değişkenler | Herhangi biri |
Aracı sürümü | 2.115.0 veya üzeri |
Görev kategorisi | Oluşturma |
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme, Klasik sürüm |
Üzerinde çalışır | Aracı |
Talep | Hiçbiri |
Özellikler | Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi biri |
Ayarlanabilir değişkenler | Herhangi biri |
Aracı sürümü | 2.0.0 veya üzeri |
Görev kategorisi | Yapı |