DotNetCoreCLI@2 - .NET úkol Core v2

Sestavte, otestujte, zabalte nebo publikujte .NET aplikaci, nebo spusťte vlastní příkaz .NET CLI.

Syntaxe

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

Vstupy

azureSubscription - Azure Resource Manager spojení
Vstupní alias: ConnectedServiceName. string.

Specifikujte Azure Resource Manager připojení ke službě nakonfigurované s federací identity zátěže pro použití AzurePipelinesCredential v integračních testech. Další informace najdete v tématu Použití AzurePipelinesCredential v integračních testech.

Poznámka

Tento vstup podporuje pouze připojení služby ARM nakonfigurovaná tak, aby používala federaci identit úloh.


command - Příkaz
string. Požadovaný. Povolené hodnoty: build, push (nuget push), pack, publish, restore, run, test, custom. Výchozí hodnota: build.

Příkaz dotnet, který se má spustit. Zadejte custom pro přidání argumentů nebo použití příkazu, který tu není uvedený.

Důležitý

Úkol NuGet Authenticate je novým doporučeným způsobem autentizace pomocí Azure Artifacts a dalších NuGet repozitářů. Příkazy restore a push této .NET Core CLI úlohy již nepřijímají nové funkce a řeší se pouze kritické chyby. Podrobnosti najdete v poznámkách.


publishWebProjects - Publikování webových projektů
boolean. Volitelný. Používá se při command = publish. Výchozí hodnota: true.

Pokud je tento vstup nastavený na true, hodnota vlastnosti projects se přeskočí a úloha se pokusí najít webové projekty v úložišti a spustit na nich příkaz publikovat. Webové projekty jsou identifikovány přítomností souboru web.config nebo složky wwwroot v adresáři. V nepřítomnosti souboru web.config nebo složky wwwroot jsou vybírány projekty, které používají webové SDK, například Microsoft.NET.Sdk.Web.


projects - cesta k projektům nebo řešením
string. Volitelný. Používá se při command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

Cesta k .csproj nebo .sln souborů, které se mají použít. Můžete použít zástupné cardy (například **/*.csproj pro všechny soubory .csproj ve všech podsložkách). Další informace naleznete v vzory porovnávání souborů odkaz.

Tato cesta je relativní ke kořenovému adresáři úložiště bez ohledu na nastavení workingDirectory.


projects - cesty k projektům
string. Volitelný. Používá se při command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

Cesta k .csproj souborům, které se mají použít. Můžete použít zástupné cardy (například **/*.csproj pro všechny soubory .csproj ve všech podsložkách). Další informace naleznete v vzory porovnávání souborů odkaz.

Tato cesta je relativní ke kořenovému adresáři úložiště bez ohledu na nastavení workingDirectory.


vlastního příkazu
string. Požadováno při command = custom.

Příkaz, který se má předat dotnet.exe ke spuštění. Úplný seznam dostupných příkazů najdete v dokumentaci k rozhraní příkazového řádku dotnet.


argumentů
string. Volitelný. Používá se při command = build || command = publish || command = run || command = test || command = custom.

Určuje argumenty pro vybraný příkaz. Například konfigurace sestavení, výstupní složka a modul runtime. Argumenty závisí na vybraném příkazu.

Tento vstup aktuálně přijímá pouze argumenty pro build, publish, run, testa custom. Pokud chcete přidat argumenty pro příkaz, který není uvedený, použijte custom.


argumentů
string. Volitelný. Používá se při command = restore.

Zapíše další argumenty, které se mají předat restore příkazu.


publishTestResults - publikování výsledků testů a pokrytí kódu
boolean. Volitelný. Používá se při command = test. Výchozí hodnota: true.

Povolením této možnosti se vygeneruje test results soubor TRX v $(Agent.TempDirectory)a výsledky se publikují na server.

Pro VSTest se tato možnost přidává --logger trx --results-directory $(Agent.TempDirectory) k argumentům příkazového řádku. Pro Microsoft.Testing.Platform, když je tato možnost detekována jako testovací runner v global.json, se tato možnost přidává --report-trx --results-directory $(Agent.TempDirectory) k argumentům příkazového řádku.

Pokrytí kódu lze získat přidáním volby --collect "Code coverage" (pro VSTest) nebo --coverage (pro Microsoft.Testing.Platform) do argumentů příkazové řádky.


testRunTitle - název testovacího spuštění
string. Volitelný. Používá se při command = test.

Poskytuje název testovacího spuštění.


zipAfterPublish - publikovaných projektů zip
boolean. Volitelný. Používá se při command = publish. Výchozí hodnota: true.

Pokud je tento vstup nastavený na true, složky vytvořené příkazem publikování se zazipují a odstraní.


modifyOutputPath - přidání názvu složky projektu pro publikování cesty
boolean. Volitelný. Používá se při command = publish. Výchozí hodnota: true.

Pokud je tento vstup nastavený na true, složky vytvořené příkazem publish budou mít název souboru projektu s předponou jejich názvů složek, pokud je výstupní cesta zadána explicitně v argumentech. To je užitečné, pokud chcete publikovat více projektů do stejné složky.


feedsToUse - informační kanály pro použití
Vstupní alias: selectOrConfig. string. Požadováno při command = restore. Povolené hodnoty: select (informační kanály, které zde vyberu), config (informační kanály v mém NuGet.config). Výchozí hodnota: select.

Můžete si zde vybrat kanál z Azure Artifacts a/nebo NuGet.org, nebo můžete uložit soubor nuget.config do svého repozitáře zdrojového kódu a nastavit jeho cestu pomocí vstupu nugetConfigPath.


vstsFeed - Použijte balíčky z tohoto Azure Artifacts kanálu. Vyberte z rozbalovacího menu nebo zadejte [název projektu/]název kanálu.
Vstupní alias: feedRestore. string. Volitelný. Používá se při feedsToUse = select && command = restore.

Zahrne vybraný informační kanál do vygenerovaného NuGet.config. Abyste mohli vybrat informační kanál, musíte mít nainstalovanou a licencovanou správu balíčků. projectName / feedName se používají pro informační kanály v rozsahu projektu. Pro informační kanály v oboru organizace se používají jenom FeedName. Poznámka: Tento příkaz není podporován pro příkaz test.


vstsFeed - Použijte balíčky z tohoto Azure Artifacts feedu
Vstupní alias: feedRestore. string. Volitelný. Používá se při feedsToUse = select && command = restore.

Zahrne vybraný informační kanál do vygenerovaného NuGet.config. Abyste mohli vybrat informační kanál, musíte mít nainstalovanou a licencovanou správu balíčků. projectName / feedName se používají pro informační kanály v rozsahu projektu. Pro informační kanály v oboru organizace se používají jenom FeedName. Poznámka: Tento příkaz není podporován pro testovací příkaz.


includeNuGetOrg - Používat balíčky z NuGet.org
boolean. Volitelný. Používá se při feedsToUse = select && command = restore. Výchozí hodnota: true.

Zahrne NuGet.org do vygenerovaného NuGet.config.


nugetConfigPath - cesta k NuGet.config
string. Volitelný. Používá se při feedsToUse = config && command = restore.

NuGet.config ve vašem úložišti, které určuje informační kanály, ze kterých se mají balíčky obnovit.


externalFeedCredentials - přihlašovací údaje pro informační kanály mimo tuto organizaci nebo kolekci
Vstupní alias: externalEndpoints. string. Volitelný. Používá se při feedsToUse = config && command = restore.

Název připojení služby, které se má použít pro externí registry uvedené ve vybraném NuGet.configseznamu . U informačních kanálů ve stejné organizaci nebo kolekci ponechte tento vstup prázdný; přihlašovací údaje sestavení se používají automaticky.


noCache - Zakázat místní mezipaměti
boolean. Volitelný. Používá se při command = restore. Výchozí hodnota: false.

Zabrání NuGetu používat balíčky z mezipamětí místního počítače.


restoreDirectory - Cílový adresář
Vstupní alias: packagesDirectory. string. Volitelný. Používá se při command = restore.

Určuje složku, ve které jsou balíčky nainstalovány. Pokud není zadána žádná složka, balíčky se obnoví do výchozí mezipaměti balíčků NuGet.


verbosityRestore - Mnohomluvnost
string. Volitelný. Používá se při command = restore. Povolené hodnoty: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Výchozí hodnota: Normal.

Určuje množství podrobností zobrazených ve výstupu příkazu restore.


verbosityRestore - Mnohomluvnost
string. Volitelný. Používá se při command = restore. Povolené hodnoty: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Výchozí hodnota: Detailed.

Určuje množství podrobností zobrazených ve výstupu příkazu restore.


packagesToPush - cesta k balíčkům NuGet k publikování
Vstupní alias: searchPatternPush. string. Požadováno při command = push. Výchozí hodnota: $(Build.ArtifactStagingDirectory)/*.nupkg.

Vzor, který se má shodovat, nebo cestu k nupkg souborům, které se mají nahrát. Více vzorů může být odděleno středníkem a můžete vytvořit vzor negativní předponou !. Příklad: **/*.nupkg;!**/*.Tests.nupkg.


nuGetFeedType - umístění cílového informačního kanálu
string. Požadováno při command = push. Povolené hodnoty: internal (tato organizace/kolekce), external (externí server NuGet (včetně jiných organizací/kolekcí)). Výchozí hodnota: internal.

Určuje, jestli je cílový informační kanál interní nebo externí.


publishVstsFeed - Cílový zdroj
Vstupní alias: feedPublish. string. Požadováno při command = push && nuGetFeedType = internal.

Určuje informační kanál hostovaný v této organizaci. Abyste mohli vybrat informační kanál, musíte mít nainstalovanou a licencovanou správu balíčků.


publishPackageMetadata - publikování metadat kanálu
boolean. Volitelný. Používá se při command = push && nuGetFeedType = internal. Výchozí hodnota: true.

Přidruží metadata kanálu buildu nebo verze (spustit #, informace o zdrojovém kódu) k balíčku.


publishFeedCredentials - Server NuGet
Vstupní alias: externalEndpoint. string. Požadováno při command = push && nuGetFeedType = external.

Připojení služby NuGet obsahující přihlašovací údaje externího serveru NuGet.


packagesToPack - Cesta k souborům csproj nebo nuspec pro zabalení
Vstupní alias: searchPatternPack. string. Požadováno při command = pack. Výchozí hodnota: **/*.csproj.

Vzor pro vyhledání .csproj nebo .nuspec souborů, které se mají zabalit.

Více vzorů můžete oddělit středníkem a můžete vytvořit negativní vzor tak, že ho předponou !. Příklad: **/*.csproj;!**/*.Tests.csproj.


konfigurace configuration - balíčku
Vstupní alias: configurationToPack. string. Volitelný. Používá se při command = pack. Výchozí hodnota: $(BuildConfiguration).

Při použití souboru .csproj určuje tento vstup konfiguraci, která se má zabalit.


packDirectory - složky balíčku
Vstupní alias: outputDir. string. Volitelný. Používá se při command = pack. Výchozí hodnota: $(Build.ArtifactStagingDirectory).

Složka, ve které se vytvoří balíčky. Pokud je tato složka prázdná, společně se souborem csproj se vytvoří balíčky.


nobuild - Nevystavovat
boolean. Volitelný. Používá se při command = pack. Výchozí hodnota: false.

Určuje, že úkol před zabalením projekt nevytvoře. Tato úloha odpovídá --no-build parametru příkazu build.


includesymbols - zahrnout symboly
boolean. Volitelný. Používá se při command = pack. Výchozí hodnota: false.

Vytvoří balíčky NuGet symbolu. Tato úloha odpovídá parametru příkazového řádku --include-symbols.


includesource - zahrnout zdrojové
boolean. Volitelný. Používá se při command = pack. Výchozí hodnota: false.

Zahrnuje zdrojový kód v balíčku. Tato úloha odpovídá parametru příkazového řádku --include-source.


versioningScheme - automatické správy verzí balíčků
string. Požadováno při command = pack. Povolené hodnoty: off, byPrereleaseNumber (Použijte datum a čas), byEnvVar (Použijte proměnnou prostředí), byBuildNumber (Použijte číslo sestavení), bySemVerBuildNumber (Použijte plné číslo sestavení SemVer). Výchozí hodnota: off.

Tento úkol nelze použít se zahrnutými odkazovanými projekty. Pokud zvolíte Use the date and time, vygeneruje se SemVerkompatibilní verze formátovaná jako X.Y.Z-ci-datetime, kde zvolíte X, Ya Z.

Pokud zvolíte Use an environment variable, musíte vybrat proměnnou prostředí a ujistit se, že obsahuje číslo verze, kterou chcete použít.

Pokud zvolíte Use the build number, použije se k verzi balíčku číslo buildu. Poznámka: V části Optionsnastavte formát čísla buildu na $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


versioningScheme - automatické správy verzí balíčků
string. Požadováno při command = pack. Povolené hodnoty: off, byPrereleaseNumber (použít datum a čas), byEnvVar (použít proměnnou prostředí), byBuildNumber (použijte číslo buildu). Výchozí hodnota: off.

Tento úkol nelze použít se zahrnutými odkazovanými projekty. Pokud zvolíte Use the date and time, vygeneruje se SemVerkompatibilní verze formátovaná jako X.Y.Z-ci-datetime, kde zvolíte X, Ya Z.

Pokud zvolíte Use an environment variable, musíte vybrat proměnnou prostředí a ujistit se, že obsahuje číslo verze, kterou chcete použít.

Pokud zvolíte Use the build number, použije se k verzi balíčku číslo buildu. Poznámka: V části Optionsnastavte formát čísla buildu na $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


versionEnvVar - Proměnná prostředí
string. Požadováno při versioningScheme = byEnvVar && command = pack.

Určuje název proměnné bez $, $envnebo %.


majorVersion - hlavní
Vstupní alias: requestedMajorVersion. string. Požadováno při versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 1.

Ve X verzi X.Y.Z.


minorVersion - Moll
Vstupní alias: requestedMinorVersion. string. Požadováno při versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.

Ve Y verzi X.Y.Z.


patchVersion - Záplata
Vstupní alias: requestedPatchVersion. string. Požadováno při versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.

Ve Z verzi X.Y.Z.


buildProperties - další vlastnosti sestavení
string. Volitelný. Používá se při command = pack.

Určuje seznam dvojic token = value oddělený středníky, kde každý výskyt $token$ v souboru .nuspec bude nahrazen danou hodnotou. Hodnoty můžou být řetězce v uvozovkách.


verbosityPack - Mnohomluvnost
string. Volitelný. Používá se při command = pack. Povolené hodnoty: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Výchozí hodnota: Normal.

Určuje množství podrobností zobrazených ve výstupu příkazu pack.


verbosityPack - Mnohomluvnost
string. Volitelný. Používá se při command = pack. Povolené hodnoty: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Výchozí hodnota: Detailed.

Určuje množství podrobností zobrazených ve výstupu příkazu pack.


pracovního adresáře workingDirectory -
string. Volitelný. Používá se při command != restore && command != push && command != pack.

Aktuální pracovní adresář, ve kterém je skript spuštěn. Empty je kořenem úložiště (sestavení) nebo artefaktů (verze), což je $(System.DefaultWorkingDirectory).


requestTimeout - Nastavit časový limit pro žádost o stažení balíčku
string. Výchozí hodnota: 300000.

Uveďte časovou hranici pro HTTP požadavky, které úkol provádí pro získání balíčku .NET. Hodnota je v milisekundách. Výchozí hodnota je 3 00000 milisekund (5 minut). Nesmí být delší než 6 00000 milisekund (10 minut).


Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádný.

Poznámky

Důležitý

Úkol NuGet Authenticate je novým doporučeným způsobem autentizace pomocí Azure Artifacts a dalších NuGet repozitářů. Příkazy restore a push této .NET Core CLI úlohy již nepřijímají nové funkce a řeší se pouze kritické chyby.

Použití AzurePipelinesCredential v integračních testech

Knihovny Azure Identity pro .NET, C++, Go, Java, JavaScript a Python podporují federaci identit zátěže, takže kód vykonávaný z úloh AzureCLI@2 a AzurePowerShell@5 může být autentizován pomocí Microsoft Entra ID (například pro přístup Azure) s použitím třídy AzurePipelinesCredential.

Mnoho zákazníků používá klientské knihovny Azure SDK v integračních testech vyvolávaných z jiných úloh. Úlohy DotNetCoreCLI@2, Maven@4 a VSTest@3 mají přístup k Azure zdrojům pomocí třídy AzurePipelinesCredential.

Můžete nastavit vlastnost connectedServiceName na Azure připojení ke službě nakonfigurované s federací identity zátěže. AzurePipelinesCredential vyžaduje nastavení SYSTEM_ACCESSTOKEN.

Následující příklad ukazuje vstup connectedServiceName úlohy DotNetCoreCLI@2. VSTest@3 a Maven@4 využití je podobné.

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

Pro více informací o AzurePipelinesCredential viz Improve security posture in Azure service connections with AzurePipelinesCredential.

Proč se mému sestavení, publikování nebo testovacímu kroku nedaří obnovit balíčky?

Většina příkazů dotnet, včetně build, publisha test, zahrnuje implicitní restore krok. To selže s ověřenými informačními kanály, i když jste v předchozím kroku spustili úspěšnou dotnet restore, protože předchozí krok vyčistí použité přihlašovací údaje.

Pokud chcete tento problém vyřešit, přidejte do textového pole --no-restore příznak Arguments.

Příkaz test navíc nerozpozná feedRestore ani vstsFeed argumenty a kanály zadané tímto způsobem nebudou zahrnuty do vygenerovaného NuGet.config souboru při spuštění implicitního kroku restore. K obnovení balíčků se doporučuje explicitní dotnet restore krok. Příkaz restore respektuje feedRestore a vstsFeed argumenty.

Proč se mi při vytváření na počítači zobrazuje upozornění NU1507 s mapováním zdrojů balíčků i když při sestavování na mém počítači nemá žádná upozornění?

Různé příkazy, které provádějí obnovu NuGetu nebo přístup k NuGet kanálu, vytvářejí speciální dočasný NuGet.config soubor, který přidává autentizaci NuGet pro Azure artefakty NuGet kanály. Postup je v konfliktu se schématem, které mapování zdrojů balíčků používá k mapování balíčků na zdroje a přeruší konfiguraci mappin zdroje balíčku v souboru NuGet.config ve vašem úložišti. Chcete-li tento konflikt obejít, můžete použít úlohu Ověření NuGet k ověření a následnému vytvoření vlastního příkazu vyvolat požadovaný příkaz dotnet bez NuGet.config úpravy.

# 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'

Proč mám vrátit se změnami NuGet.config?

Kontrola NuGet.config do správy zdrojového kódu zajišťuje, že je pro každého vývojáře, který váš kód kontroluje, k dispozici klíčové informace potřebné k sestavení projektu – umístění jeho balíčků.

Nicméně v situacích, kdy tým vývojářů pracuje na širokém spektru projektů, je také možné přidat Azure Artifacts feed do globálního NuGet.config na každém počítači vývojáře. V těchto situacích se tato konfigurace replikuje pomocí možnosti Feeds I select here v úloze NuGet.

Řešení problémů

Projekt využívající Entity Framework přestal fungovat na hostovaných agentech

.NET Core nemá vestavěný Entity Framework (EF). Buď budete muset EF nainstalovat před začátkem spouštění, nebo přidat global.json do projektu s požadovanou verzí .NET Core SDK. Tím zajistíte, že se k sestavení projektu EF použije správná sada SDK. Pokud na počítači není požadovaná verze, přidejte do kanálu úlohu UseDotNetV2 a nainstalujte požadovanou verzi. Pro více informací viz Get the Entity Framework Core runtime.

Příklady

příklady sestavení

Sestavení projektu

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

Sestavení více projektů

# 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říklady nabízených oznámení

Nabízení balíčků NuGet do interního informačního kanálu

# 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'

Nabízení balíčků NuGet do externího informačního kanálu

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

Příklady sady Pack

Zabalení balíčku NuGetPackage do konkrétního výstupního adresáře

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

Zabalení balíčku symbolů

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

Příklady publikování

Publikování projektů do zadané složky

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

Příklady obnovení

#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říklady testů

Spouštění testů v úložišti

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

Požadavky

Požadavek Popis
Typy kanálů YAML, klasické sestavení, klasická verze
Běží na Agenta
Demands Žádný
Capabilities Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů Jakýkoliv
nastavitelné proměnné Jakýkoliv
Verze agenta 2.144.0 nebo vyšší
Kategorie úkolu Vybudovat
Požadavek Popis
Typy kanálů YAML, klasické sestavení, klasická verze
Běží na Agenta
Demands Žádný
Capabilities Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů Jakýkoliv
nastavitelné proměnné Jakýkoliv
Verze agenta 2.115.0 nebo vyšší
Kategorie úkolu Vybudovat