DotNetCoreCLI@2 – .NET Core v2-feladat
Dotnet-alkalmazás létrehozása, tesztelése, csomagolása vagy közzététele, illetve egyéni dotnet-parancs futtatása.
Dotnet-alkalmazás létrehozása, tesztelése, csomagolása vagy közzététele, illetve egyéni dotnet-parancs futtatása. A csomagparancsok esetében támogatja NuGet.org és hitelesített hírcsatornákat, például a Csomagkezelést és a MyGetet.
Fontos
A NuGet-hitelesítés feladat az Új ajánlott módszer az Azure Artifacts és más NuGet-adattárak használatával történő hitelesítésre. A restore
.NET Core CLI-feladat és push
parancsai már nem használnak új funkciókat, és csak a kritikus hibákat hárítják el. A részletekért tekintse meg a megjegyzéseket.
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.
Bevitelek
command
- Parancs
string
. Kötelező. Engedélyezett értékek: build
, push
(nuget push), pack
, , publish
, run
restore
, , test
. custom
Alapértelmezett érték: build
.
A futtatandó dotnet parancs. Adjon meg custom
argumentumokat, vagy használjon olyan parancsot, amely nem szerepel itt.
Fontos
A NuGet-hitelesítés feladat az Új ajánlott módszer az Azure Artifacts és más NuGet-adattárak használatával történő hitelesítésre. A restore
.NET Core CLI-feladat és push
parancsai már nem használnak új funkciókat, és csak a kritikus hibákat hárítják el. A részletekért tekintse meg a megjegyzéseket.
publishWebProjects
- Webes projektek közzététele
boolean
. Választható. Használja a következőt: command = publish
. Alapértelmezett érték: true
.
Ha ezt a bemenetet a értékre true
állítja, a rendszer kihagyja a projects
tulajdonságértéket, és a feladat megpróbálja megkeresni a webes projekteket az adattárban, és futtatja rajtuk a közzétételi parancsot. A webes projekteket egy web.config
fájl vagy mappa wwwroot
jelenléte azonosítja a könyvtárban. Fájl vagy wwwroot
mappa hiányában web.config
a webes SDK-t (példáulMicrosoft.NET.Sdk.Web
) használó projektek vannak kiválasztva.
publishWebProjects
- Webes projektek közzététele
boolean
. Választható. Használja a következőt: command = publish
. Alapértelmezett érték: true
.
Ha ezt a bemenetet a értékre true
állítja, a rendszer kihagyja a projects
tulajdonságértéket, és a feladat megpróbálja megkeresni a webes projekteket az adattárban, és futtatja rajtuk a közzétételi parancsot. A webes projekteket egy web.config
fájl vagy mappa wwwroot
jelenléte azonosítja a könyvtárban. Fájl vagy wwwroot
mappa hiányában web.config
a webes SDK-t (példáulMicrosoft.NET.Sdk.Web
) használó projektek vannak kiválasztva.
projects
- Projekt(ek) vagy megoldás(ok) elérési útja
string
. Választható. Használja a következőt: command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false
.
A használni kívánt .csproj
fájl .sln
(ok) elérési útja. Használhat helyettesítő karaktereket (például **/*.csproj
az összes almappában lévő összes .csproj
fájlhoz). További információt a fájlegyeztetési minták referenciájában talál.
Ez az elérési út az adattár gyökeréhez képest van, a beállítástól függetlenül workingDirectory
.
projects
- Projekt(ek) elérési útja
string
. Választható. Használja a következőt: command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false
.
A használni kívánt fájl(ok) elérési útja .csproj
. Használhat helyettesítő karaktereket (például **/*.csproj
az összes almappában lévő összes .csproj
fájlhoz). További információt a fájlegyeztetési minták referenciájában talál.
Ez az elérési út az adattár gyökeréhez képest van, a beállítástól függetlenül workingDirectory
.
custom
- Egyéni parancs
string
. Akkor szükséges, ha command = custom
.
A parancs, amelybe dotnet.exe
végrehajtás céljából át szeretne adni. Az elérhető parancsok teljes listáját a dotnet CLI dokumentációjában találja.
arguments
- Érvek
string
. Választható. Használja a következőt: command = build || command = publish || command = run || command = test || command = custom
.
A kijelölt parancs argumentumait adja meg. Például buildkonfiguráció, kimeneti mappa és futtatókörnyezet. Az argumentumok a kijelölt parancstól függnek.
Ez a bemenet jelenleg csak a , , publish
, run
test
és custom
argumentumokat build
fogadja el. Ha olyan parancs argumentumait szeretné hozzáadni, amely nem szerepel a listán, használja a következőt custom
: .
restoreArguments
- Érvek
string
. Választható. Használja a következőt: command = restore
.
Megírja a parancsnak továbbadandó restore
további argumentumokat.
publishTestResults
- Teszteredmények és kódlefedettség közzététele
boolean
. Választható. Használja a következőt: command = test
. Alapértelmezett érték: true
.
Ha engedélyezi ezt a beállítást, létrehoz egy test results
TRX-fájlt a fájlban $(Agent.TempDirectory)
, és az eredményeket közzéteszi a kiszolgálón.
Ez a beállítás hozzáfűzi --logger trx --results-directory $(Agent.TempDirectory)
a parancssori argumentumokat.
A kódlefedettség a parancssori argumentumokhoz való hozzáadásával --collect "Code coverage"
gyűjthető össze.
testRunTitle
- Futtatási cím tesztelése
string
. Választható. Használja a következőt: command = test
.
A tesztfuttatás nevét adja meg.
zipAfterPublish
- Közzétett projektek zip-címe
boolean
. Választható. Használja a következőt: command = publish
. Alapértelmezett érték: true
.
Ha ez a bemenet a következőre true
van állítva, a közzétételi parancs által létrehozott mappák tömörítve lesznek, és törlődnek.
zipAfterPublish
- Közzétett zip-projektek
boolean
. Választható. Használja a következőt: command = publish
. Alapértelmezett érték: true
.
Ha ezt a bemenetet a értékre true
állítja, a közzétételi parancs által létrehozott mappa tömörítve lesz, és törlődik.
modifyOutputPath
- Projekt mappanevének hozzáadása a közzétételi útvonalhoz
boolean
. Választható. Használja a következőt: command = publish
. Alapértelmezett érték: true
.
Ha ez a bemenet a értékre true
van állítva, a közzétételi parancs által létrehozott mappákban a projektfájl neve előtaggal lesz ellátva a mappanevekhez, amikor a kimeneti elérési út explicit módon meg van adva az argumentumokban. Ez akkor hasznos, ha több projektet szeretne közzétenni ugyanabban a mappában.
modifyOutputPath
- Projektnév hozzáadása a közzétételi útvonalhoz
boolean
. Választható. Használja a következőt: command = publish
. Alapértelmezett érték: true
.
Ha ez a bemenet a értékre true
van állítva, a közzétételi parancs által létrehozott mappákban a projektfájl neve előtaggal lesz ellátva a mappanevekhez, amikor a kimeneti elérési út explicit módon meg van adva az argumentumokban. Ez akkor hasznos, ha több projektet szeretne közzétenni ugyanabban a mappában.
feedsToUse
- Használandó hírcsatornák
Bemeneti alias: selectOrConfig
. string
. Akkor szükséges, ha command = restore
. Engedélyezett értékek: select
(Itt kiválasztom a hírcsatorná(ka)t) config
(A NuGet.config hírcsatornái). Alapértelmezett érték: select
.
Kiválaszthat egy hírcsatornát az Azure Artifactsből és/vagy NuGet.org
itt, vagy véglegesítheti nuget.config
a fájlt a forráskód-adattárban, és beállíthatja annak elérési útját a nugetConfigPath
bemenet használatával.
vstsFeed
- Az Azure Artifacts-hírcsatornából származó csomagok használata
Bemeneti alias: feedRestore
. string
. Választható. Használja a következőt: selectOrConfig = select && command = restore
.
Tartalmazza a kiválasztott hírcsatornát a létrehozott NuGet.config
fájlban. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt kiválaszthassa a hírcsatornát. projectName
/feedName
projekthatókörű hírcsatornákhoz használhatók. Csak FeedName
szervezeti hatókörű hírcsatornákhoz használható. Megjegyzés: Ez a tesztparancs esetében nem támogatott.
vstsFeed
- Az Azure Artifacts/TFS-hírcsatornából származó csomagok használata
Bemeneti alias: feedRestore
. string
. Választható. Használja a következőt: selectOrConfig = select && command = restore
.
Tartalmazza a kiválasztott hírcsatornát a létrehozott NuGet.config
fájlban. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt kiválaszthassa a hírcsatornát. projectName
/feedName
projekthatókörű hírcsatornákhoz használhatók. Csak FeedName
szervezeti hatókörű hírcsatornákhoz használható. Megjegyzés: Ez a tesztparancs esetében nem támogatott.
includeNuGetOrg
- Csomagok használata NuGet.org
boolean
. Választható. Használja a következőt: selectOrConfig = select && command = restore
. Alapértelmezett érték: true
.
Tartalmazza NuGet.org
a generált NuGet.config
.
nugetConfigPath
- A NuGet.configelérési útja
string
. Választható. Használja a következőt: selectOrConfig = config && command = restore
.
Az NuGet.config
adattárban található, amely meghatározza azokat a hírcsatornákat, amelyekből a csomagokat vissza szeretné állítani.
externalFeedCredentials
- Hitelesítő adatok a szervezeten/gyűjteményen kívüli hírcsatornákhoz
Bemeneti alias: externalEndpoints
. string
. Választható. Használja a következőt: selectOrConfig = config && command = restore
.
A kiválasztott NuGet.config
helyen található külső regisztrációs adatbázisokhoz használandó hitelesítő adatok. A szervezet/gyűjtemény hírcsatornáinál hagyja üresen ezt a bemenetet; a rendszer automatikusan használja a build hitelesítő adatait.
noCache
- Helyi gyorsítótár letiltása
boolean
. Választható. Használja a következőt: command = restore
. Alapértelmezett érték: false
.
Megakadályozza, hogy a NuGet a helyi gép gyorsítótáraiból származó csomagokat használ.
restoreDirectory
- Célkönyvtár
Bemeneti alias: packagesDirectory
. string
. Választható. Használja a következőt: command = restore
.
Meghatározza azt a mappát, amelyben a csomagok telepítve vannak. Ha nincs megadva mappa, a rendszer visszaállítja a csomagokat az alapértelmezett NuGet-csomaggyorsítótárba.
verbosityRestore
- Bőbeszédűség
string
. Választható. Használja a következőt: command = restore
. Engedélyezett értékek: -
, Quiet
, Minimal
, Normal
, Detailed
, . Diagnostic
Alapértelmezett érték: Detailed
.
Megadja a parancs kimenetében restore
megjelenő részletek mennyiségét.
packagesToPush
- Közzétételi NuGet-csomag(ok) elérési útja
Bemeneti alias: searchPatternPush
. string
. Akkor szükséges, ha command = push
. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)/*.nupkg
.
A feltöltendő fájlokhoz illő minta vagy elérési nupkg
út. Több mintát pontosvesszővel is elválaszthat, és negatív mintázatot is létrehozhat, ha előtaggal elemet ad !
meg. Példa: **/*.nupkg;!**/*.Tests.nupkg
.
nuGetFeedType
- Célcsatorna helye
string
. Akkor szükséges, ha command = push
. Engedélyezett értékek: internal
(Ez a szervezet/gyűjtemény) external
(külső NuGet-kiszolgáló (más szervezeteket/gyűjteményeket is beleértve)). Alapértelmezett érték: internal
.
Meghatározza, hogy a célcsatorna belső vagy külső-e.
publishVstsFeed
- Célcsatorna
Bemeneti alias: feedPublish
. string
. Akkor szükséges, ha command = push && nuGetFeedType = internal
.
A szervezeten belül üzemeltetett hírcsatornát adja meg. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt kiválaszthassa a hírcsatornát.
publishPackageMetadata
- Folyamat metaadatainak közzététele
boolean
. Választható. Használja a következőt: command = push && nuGetFeedType = internal && command = push
. Alapértelmezett érték: true
.
Társítja a buildelési/kiadási folyamat metaadatait (futtatás #, forráskódadatok) a csomaghoz.
publishFeedCredentials
- NuGet-kiszolgáló
Bemeneti alias: externalEndpoint
. string
. Akkor szükséges, ha command = push && nuGetFeedType = external
.
A külső NuGet-kiszolgáló hitelesítő adatait tartalmazó NuGet-szolgáltatáskapcsolat .
packagesToPack
- A csproj- vagy nuspec-fájl(ok) elérési útja a csomagoláshoz
Bemeneti alias: searchPatternPack
. string
. Akkor szükséges, ha command = pack
. Alapértelmezett érték: **/*.csproj
.
A keresendő .csproj
minta vagy .nuspec
a csomagolandó fájlok.
Több mintát is elválaszthat pontosvesszővel, és negatív mintát is létrehozhat, ha előtaggal elemet ad !
hozzá. Példa: **/*.csproj;!**/*.Tests.csproj
.
configuration
- Konfiguráció csomagra
Bemeneti alias: configurationToPack
. string
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: $(BuildConfiguration)
.
Fájl használatakor .csproj
ez a bemenet határozza meg a csomagolandó konfigurációt.
packDirectory
- Csomagmappa
Bemeneti alias: outputDir
. string
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)
.
Az a mappa, ahol a csomagok létrejönnek. Ha ez a mappa üres, a fájl mellett csproj
csomagok is létrejönnek.
nobuild
- Ne buildelje
boolean
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: false
.
Azt adja meg, hogy a tevékenység csomagolás előtt ne hozza létre a projektet. Ez a feladat megfelel a --no-build
parancs paraméterének build
.
includesymbols
- Szimbólumok belefoglalása
boolean
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: false
.
Szimbólum NuGet-csomagokat hoz létre. Ez a feladat megfelel a --include-symbols
parancssori paraméternek.
includesource
- Forrás belefoglalása
boolean
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: false
.
Tartalmazza a csomag forráskódját. Ez a feladat megfelel a --include-source
parancssori paraméternek.
versioningScheme
- Csomag automatikus verziószámozása
string
. Akkor szükséges, ha command = pack
. Engedélyezett értékek: off
, byPrereleaseNumber
(Használja a dátumot és az időt), byEnvVar
(Környezeti változó használata) byBuildNumber
(Használja a buildszámot). Alapértelmezett érték: off
.
Ez a feladat nem használható belefoglalt hivatkozott projektekhez. Ha a lehetőséget választjaUse the date and time
, ez létrehoz egy SemVer-kompatibilis verziótX.Y.Z-ci-datetime
, amely a , Y
a és Z
a elemet választjaX
.
Ha a lehetőséget választja Use an environment variable
, ki kell választania egy környezeti változót, és meg kell győződnie arról, hogy tartalmazza a használni kívánt verziószámot.
Ha a lehetőséget választja Use the build number
, akkor a buildszámmal fogja verziószámba adni a csomagot. Megjegyzés: A alatt Options
állítsa a buildszám formátumát értékre $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
.
versionEnvVar
- Környezeti változó
string
. Akkor szükséges, ha versioningScheme = byEnvVar && command = pack
.
A változó nevét adja meg , $env
vagy %
nélkül$
.
majorVersion
- Nagy
Bemeneti alias: requestedMajorVersion
. string
. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack
. Alapértelmezett érték: 1
.
Az X
X.Y.Z verzióban.
minorVersion
- Kisebb
Bemeneti alias: requestedMinorVersion
. string
. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack
. Alapértelmezett érték: 0
.
Az Y
X.Y.Z verzióban.
patchVersion
- Javítás
Bemeneti alias: requestedPatchVersion
. string
. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack
. Alapértelmezett érték: 0
.
Az Z
X.Y.Z verzióban.
buildProperties
- További buildtulajdonságok
string
. Választható. Használja a következőt: command = pack
.
Pontosvesszővel elválasztott párok listáját token = value
adja meg, ahol a .nuspec
fájl minden előfordulása $token$
lecserélődik a megadott értékre. Az értékek idézőjelek között sztringek lehetnek.
verbosityPack
- Bőbeszédűség
string
. Választható. Használja a következőt: command = pack
. Engedélyezett értékek: -
, Quiet
, Minimal
, Normal
, Detailed
. Diagnostic
Alapértelmezett érték: Detailed
.
A parancs kimenetében pack
megjelenített részletek mennyiségét adja meg.
workingDirectory
- Munkakönyvtár
string
. Választható. Használja a következőt: command != restore && command != push && command != pack && command != pack && command != push && command != restore
.
Az aktuális munkakönyvtár, ahol a szkript fut. Empty
az adattár (build) vagy összetevők (kiadás) gyökere, amely a következő $(System.DefaultWorkingDirectory)
: .
workingDirectory
- Munkakönyvtár
string
. Választható. Használja a következőt: command != pack && command != push && command != restore
.
Az aktuális munkakönyvtár, ahol a szkript fut. Empty
az adattár (build) vagy összetevők (kiadás) gyökere, amely a következő $(System.DefaultWorkingDirectory)
: .
Feladatvezérlési lehetőségek
Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.
Kimeneti változók
Nincsenek.
Megjegyzések
Fontos
A NuGet-hitelesítés feladat az új ajánlott módszer az Azure Artifacts és más NuGet-adattárak használatával történő hitelesítésre. A restore
.NET Core CLI-feladat és push
parancsai már nem vesznek igénybe új funkciókat, és csak a kritikus hibákat kezelik.
Miért nem sikerül visszaállítani a csomagokat a buildelési, közzétételi vagy tesztelési lépésem?
A legtöbb dotnet
parancs, beleértve a build
, publish
és test
tartalmaz egy implicit restore
lépést. Ez akkor is sikertelen lesz a hitelesített hírcsatornákon, ha sikeres dotnet restore
volt egy korábbi lépésben, mert a korábbi lépés megtisztította a használt hitelesítő adatokat.
A probléma megoldásához adja hozzá a --no-restore
jelzőt a Arguments
szövegmezőhöz.
Emellett a test
parancs nem ismeri fel a vagy vstsFeed
az feedRestore
argumentumokat, és az így megadott hírcsatornák nem lesznek belefoglalva a létrehozott NuGet.config
fájlba az implicit restore
lépés futtatásakor. Javasoljuk, hogy egy explicit dotnet restore
lépéssel állítsa vissza a csomagokat. A restore
parancs tiszteletben tartja az és vstsFeed
az feedRestore
argumentumot.
Miért kapok NU1507-figyelmeztetéseket a csomagforrás-leképezéssel , bár a gépemen való építéskor nincsenek figyelmeztetések?
A Különböző parancsok, amelyek a NuGet-csatornák visszaállítását vagy elérését hajtják végre, létrehoznak egy speciális ideiglenes NuGet.config
fájlt, amely Hozzáadja a NuGet-hitelesítést az Azure Artifacts NuGet-hírcsatornáihoz. Ennek módja ütközik azzal a sémával, amelyet a Csomagforrás-leképezés a csomagok forráshoz való leképezéséhez használ, és megszakítja a Csomagforrás-leképezés konfigurációját az NuGet.config
adattárban lévő fájlban.
Az ütközés megkerüléséhez használhatja a NuGet-hitelesítés feladatot a hitelesítéshez, majd az egyéni parancsot a kívánt dotnet-parancs módosítás nélküli NuGet.config
meghívásához.
# 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'
Miért kell beadnom egy NuGet.config?
NuGet.config
A verziókövetés ellenőrzése biztosítja, hogy a projekt létrehozásához szükséges legfontosabb információ – a csomagok helye – minden olyan fejlesztő számára elérhető legyen, aki kiveni a kódot.
Azokban a helyzetekben azonban, amikor egy fejlesztői csapat számos projekten dolgozik, azure artifacts-hírcsatornát is hozzáadhat a globálishoz NuGet.config
az egyes fejlesztők gépén. Ezekben az esetekben a Feeds I select here
NuGet-feladatban a beállítás használatával replikálja ezt a konfigurációt.
Hibaelhárítás
Az Entity Frameworkt használó projekt leállt az üzemeltetett ügynökökön
A .NET Core nem rendelkezik beépített Entity Framework(EF) szolgáltatással. A végrehajtás megkezdése előtt telepítenie kell az EF-t, vagy hozzá kell adnia global.json
a projekthez a szükséges .NET Core SDK-verzióval. Ez biztosítja, hogy a megfelelő SDK-t használja az EF-projekt létrehozásához. Ha a szükséges verzió nem található meg a gépen, adja hozzá a feladatot a UseDotNetV2
folyamathoz a szükséges verzió telepítéséhez. További információ: Az Entity Framework Core-futtatókörnyezet lekérése.
Példák
- Példák összeállítása
- Példák leküldése
- Példák leküldése
- Példák csomagolása
- Példák közzététele
- Példák visszaállítása
- Példák tesztelése
Példák készítése
Projekt létrehozása
# Build project
- task: DotNetCoreCLI@2
inputs:
command: 'build'
Több projekt létrehozása
# 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.
Példák leküldése
NuGet-csomagok leküldése belső hírcsatornába
# 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-csomagok leküldése külső hírcsatornába
# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
inputs:
command: 'push'
nugetFeedType: 'external'
externalEndPoint: 'MyNuGetServiceConnection'
Példák csomagolása
NuGetPackage csomagolása egy adott kimeneti könyvtárba
# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
inputs:
command: 'pack'
outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'
Szimbólumcsomag csomagolása
# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
inputs:
command: 'pack'
includesymbols: true
Példák közzététele
Projektek közzététele a megadott mappában
# 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
Példák visszaállítása
#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
Példák tesztelése
Tesztek futtatása az adattárban
# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
inputs:
command: 'test'
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás | Ügynök |
Igények | None |
Képességek | Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.144.0 vagy újabb |
Feladatkategória | Build |
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás | Ügynök |
Igények | None |
Képességek | Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.115.0 vagy újabb |
Feladatkategória | Build |
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás | Ügynök |
Igények | None |
Képességek | Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.0.0 vagy újabb |
Feladatkategória | Build |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: