DotNetCoreCLI@2 – úloha .NET Core v2

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

Sestavte, otestujte, zabalte nebo publikujte aplikaci dotnet nebo spusťte vlastní příkaz dotnet. Pro příkazy balíčku podporuje NuGet.org a ověřené informační kanály, jako je Správa balíčků a MyGet.

Důležité

Úloha Ověření NuGet je nový doporučený způsob ověřování pomocí Azure Artifacts a dalších úložišť NuGet. Příkazy restore a push této úlohy rozhraní příkazového řádku .NET Core už nepřibírají nové funkce a řeší se pouze kritické chyby. Podrobnosti najdete v poznámkách.

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.

Vstupy

command - Příkaz
string. Povinná hodnota. 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žijte příkaz, který tu není uvedený.

Důležité

Úloha Ověření NuGet je nový doporučený způsob ověřování pomocí Azure Artifacts a dalších úložišť NuGet. Příkazy restore a push této úlohy rozhraní příkazového řádku .NET Core už nepřibírají nové funkce a řeší se pouze kritické chyby. Podrobnosti najdete v poznámkách.


publishWebProjects - Publikování webových projektů
boolean. Nepovinný parametr. Použijte, když command = publish. Výchozí hodnota: true.

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


publishWebProjects - Publikování webových projektů
boolean. Nepovinný parametr. Použijte, když command = publish. Výchozí hodnota: true.

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


projects - Cesta k projektu nebo řešení
string. Nepovinný parametr. Použijte, když command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

Cesta k souborům .csproj nebo .sln , které se mají použít. Můžete použít zástupné cardy (např. **/*.csproj pro všechny .csproj soubory ve všech podsložkách). Další informace najdete v referenčních informacích o vzorech porovnávání souborů.

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


projects - Cesta k projektům
string. Nepovinný parametr. Použijte, když command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

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

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


custom - Vlastní příkaz
string. Vyžaduje se, když command = custom.

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


arguments - Argumenty
string. Nepovinný parametr. Použijte, když 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, runpublish, , testa custom. Pokud chcete přidat argumenty pro příkaz, který není uvedený, použijte custom.


restoreArguments - Argumenty
string. Nepovinný parametr. Použijte, když 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. Nepovinný parametr. Použijte, když command = test. Výchozí hodnota: true.

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

Tato možnost připojí k argumentům --logger trx --results-directory $(Agent.TempDirectory) příkazového řádku.

Pokrytí kódu je možné shromáždit přidáním --collect "Code coverage" možnosti do argumentů příkazového řádku.


testRunTitle - Název testovacího běhu
string. Nepovinný parametr. Použijte, když command = test.

Poskytuje název testovacího běhu.


zipAfterPublish - Zip publikovaných projektů
boolean. Nepovinný parametr. Použijte, když command = publish. Výchozí hodnota: true.

Pokud je tento vstup nastavený na truehodnotu , složky vytvořené příkazem publish se zazipují a odstraní.


zipAfterPublish - Publikované projekty zipu
boolean. Nepovinný parametr. Použijte, když command = publish. Výchozí hodnota: true.

Pokud je tento vstup nastavený na true, složka vytvořená příkazem publish se zazipuje a odstraní.


modifyOutputPath - Přidání názvu složky projektu pro cestu k publikování
boolean. Nepovinný parametr. Použijte, když command = publish. Výchozí hodnota: true.

Pokud je tento vstup nastaven na truehodnotu , budou mít složky vytvořené příkazem publish předponu názvu souboru projektu před názvy 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.


modifyOutputPath - Přidání názvu projektu k publikování cesty
boolean. Nepovinný parametr. Použijte, když command = publish. Výchozí hodnota: true.

Pokud je tento vstup nastaven na truehodnotu , budou mít složky vytvořené příkazem publish předponu názvu souboru projektu před názvy 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, které se mají použít
Vstupní alias: selectOrConfig. string. Vyžaduje se, když command = restore. Povolené hodnoty: select (Informační kanály, které tady vyberu) config (Informační kanály v NuGet.config). Výchozí hodnota: select.

Můžete vybrat informační kanál z Azure Artifacts nebo NuGet.org tady, nebo můžete soubor potvrdit nuget.config do úložiště zdrojového nugetConfigPath kódu a nastavit jeho cestu pomocí vstupu.


vstsFeed - Použití balíčků z tohoto informačního kanálu Azure Artifacts
Vstupní alias: feedRestore. string. Nepovinný parametr. Použijte, když selectOrConfig = select && command = restore.

Zahrne vybraný informační kanál do vygenerovaného NuGet.configobjektu . 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 s oborem projektu. Používá se jenom FeedName pro informační kanály s rozsahem organizace. Poznámka: Testovací příkaz to nepodporuje.


vstsFeed - Použití balíčků z tohoto kanálu Azure Artifacts/TFS
Vstupní alias: feedRestore. string. Nepovinný parametr. Použijte, když selectOrConfig = select && command = restore.

Zahrne vybraný informační kanál do vygenerovaného NuGet.configobjektu . 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 s oborem projektu. Používá se jenom FeedName pro informační kanály s rozsahem organizace. Poznámka: Testovací příkaz to nepodporuje.


includeNuGetOrg - Použití balíčků z NuGet.org
boolean. Nepovinný parametr. Použijte, když selectOrConfig = select && command = restore. Výchozí hodnota: true.

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


nugetConfigPath - Cesta k NuGet.config
string. Nepovinný parametr. Použijte, když selectOrConfig = config && command = restore.

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


externalFeedCredentials - Přihlašovací údaje pro informační kanály mimo tuto organizaci nebo kolekci
Vstupní alias: externalEndpoints. string. Nepovinný parametr. Použijte, když selectOrConfig = config && command = restore.

Přihlašovací údaje, které se mají použít pro externí registry umístěné ve vybraném NuGet.configobjektu . U informačních kanálů v této organizaci nebo kolekci nechte tento vstup prázdný. přihlašovací údaje sestavení se použijí automaticky.


noCache - Zakázání místní mezipaměti
boolean. Nepovinný parametr. Použijte, když command = restore. Výchozí hodnota: false.

Zabraňuje NuGetu používat balíčky z mezipamětí místního počítače.


restoreDirectory - Cílový adresář
Vstupní alias: packagesDirectory. string. Nepovinný parametr. Použijte, když 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 - Podrobnost
string. Nepovinný parametr. Použijte, když command = restore. Povolené hodnoty: -, Quiet, MinimalNormal, , Detailed, . Diagnostic Výchozí hodnota: Detailed.

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


packagesToPush - Cesta k balíčkům NuGet k publikování
Vstupní alias: searchPatternPush. string. Vyžaduje se, když command = push. Výchozí hodnota: $(Build.ArtifactStagingDirectory)/*.nupkg.

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


nuGetFeedType - Umístění cílového informačního kanálu
string. Vyžaduje se, když command = push. Povolené hodnoty: internal (tato organizace nebo 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ý informační kanál
Vstupní alias: feedPublish. string. Vyžaduje se, když 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. Nepovinný parametr. Použijte, když command = push && nuGetFeedType = internal && command = push. Výchozí hodnota: true.

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


publishFeedCredentials - Server NuGet
Vstupní alias: externalEndpoint. string. Vyžaduje se, když command = push && nuGetFeedType = external.

Připojení služby NuGet, které obsahuje přihlašovací údaje externího serveru NuGet.


packagesToPack - Cesta k souborům csproj nebo nuspec k zabalení
Vstupní alias: searchPatternPack. string. Vyžaduje se, když command = pack. Výchozí hodnota: **/*.csproj.

Vzor, který chcete vyhledat, nebo .nuspec soubory, které chcete zabalit.csproj.

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


configuration - Konfigurace do balíčku
Vstupní alias: configurationToPack. string. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: $(BuildConfiguration).

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


packDirectory - Složka balíčku
Vstupní alias: outputDir. string. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: $(Build.ArtifactStagingDirectory).

Složka, ve které se budou vytvářet balíčky. Pokud je tato složka prázdná, vytvoří se spolu se souborem balíčky csproj .


nobuild - Nevystavovat
boolean. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: false.

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


includesymbols - Zahrnout symboly
boolean. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: false.

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


includesource - Zahrnout zdroj
boolean. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: false.

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


versioningScheme - Automatická správa verzí balíčků
string. Vyžaduje se, když command = pack. Povolené hodnoty: off, byPrereleaseNumber (Použijte datum a čas), byEnvVar (Použijte proměnnou prostředí), byBuildNumber (Použijte číslo buildu). Výchozí hodnota: off.

Tento úkol nelze použít u zahrnutých odkazovaných projektů. Pokud zvolíte Use the date and time, vygeneruje se verze kompatibilní se SemVerem ve formátu X.Y.Z-ci-datetimeX, Ya Z.

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

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


versionEnvVar - Proměnná prostředí
string. Vyžaduje se, když versioningScheme = byEnvVar && command = pack.

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


majorVersion - Hlavní
Alias vstupu: requestedMajorVersion. string. Vyžaduje se, když versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 1.

Ve X verzi X.Y.Z.


minorVersion - Menší
Alias vstupu: requestedMinorVersion. string. Vyžaduje se, když versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.

Ve Y verzi X.Y.Z.


patchVersion - Oprava
Alias vstupu: requestedPatchVersion. string. Vyžaduje se, když versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.

Ve Z verzi X.Y.Z.


buildProperties - Další vlastnosti sestavení
string. Nepovinný parametr. Použijte, když command = pack.

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


verbosityPack - Podrobnost
string. Nepovinný parametr. Použijte, když command = pack. Povolené hodnoty: -, Quiet, , NormalMinimal, , Detailed, . Diagnostic Výchozí hodnota: Detailed.

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


workingDirectory - Pracovní adresář
string. Nepovinný parametr. Použijte, když command != restore && command != push && command != pack && command != pack && command != push && command != restore.

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


workingDirectory - Pracovní adresář
string. Nepovinný parametr. Použijte, když command != pack && command != push && command != restore.

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


Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Důležité

Úloha Ověření NuGet představuje nový doporučený způsob ověřování pomocí Azure Artifacts a dalších úložišť NuGet. Příkazy restore a push této úlohy .NET Core CLI už nepřibírají nové funkce a řeší se jenom kritické chyby.

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

Většina dotnet příkazů včetně buildpříkazů , publisha test obsahuje implicitní restore krok. To se nezdaří u ověřených informačních kanálů, i když jste v předchozím kroku spustili úspěšný dotnet restore krok, protože předchozí krok vyčistí přihlašovací údaje, které použil.

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

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

Proč se při mapování zdroje balíčku zobrazuje upozornění NU1507, i když při sestavování na počítači se žádná upozornění nezobrazují?

Různé příkazy, které dělají obnovení NuGetu nebo přistupují k informačnímu kanálu NuGet, vytvoří speciální dočasný NuGet.config soubor, který přidá ověřování NuGet pro informační kanály NuGet artefaktů Azure. Způsob, jakým se to provádí, 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 NuGet.config souboru ve vašem úložišti. Pokud chcete tento konflikt obejít, můžete použít úlohu Ověření NuGet k ověření a následně vlastní příkaz k vyvolání požadovaného příkazu dotnet beze NuGet.config změny.

# 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č bych se měl(a) vrátit NuGet.config?

Vrácením NuGet.config kódu do správy zdrojového kódu zajistíte, že klíčová informace potřebná k sestavení projektu – umístění jeho balíčků – bude k dispozici každému vývojáři, který si váš kód rezervuje.

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

Poradce při potížích

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

.NET Core nemá předdefinované Entity Framework (EF). Před spuštěním budete muset buď nainstalovat EF, nebo ho přidat global.json do projektu s požadovanou verzí sady .NET Core SDK. Tím zajistíte, že se k sestavení projektu EF použije správná sada SDK. Pokud se požadovaná verze na počítači nenachází, přidejte UseDotNetV2 do kanálu úlohu a nainstalujte požadovanou verzi. Další informace najdete v tématu Získání modulu runtime Entity Framework Core.

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 nasdílení změn

Nabízení balíčků NuGet do interní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 kanálu

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

Příklady balíčků

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
    projects: '**/*.csproj'
    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

Testovací příklady

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ý build, klasická verze
Běží na Agent
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.144.0 nebo vyšší
Kategorie úloh Sestavení
Požadavek Popis
Typy kanálů YAML, klasický build, klasická verze
Běží na Agent
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.115.0 nebo vyšší
Kategorie úloh Sestavení
Požadavek Popis
Typy kanálů YAML, klasický build, klasická verze
Běží na Agent
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.0.0 nebo vyšší
Kategorie úloh Sestavení