Share via


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, runrestore, , 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, runtestés customargumentumokat buildfogadja 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 truevan á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 truevan á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 truevan á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.configfá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.configfá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.confighelyen 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 , Ya és Za 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 , $envvagy %nélkül$.


majorVersion - Nagy
Bemeneti alias: requestedMajorVersion. string. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack. Alapértelmezett érték: 1.

Az XX.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 YX.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 ZX.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 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