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 true
hodnotu , 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 true
hodnotu , 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
, run
publish
, , test
a 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 true
hodnotu , 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 true
hodnotu , 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 true
hodnotu , 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.config
objektu . 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.config
objektu . 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.config
souboru .
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.config
objektu . 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
, Minimal
Normal
, , 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-build
build
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-datetime
X
, Y
a 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 Options
nastavte 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 $
, $env
nebo %
.
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
, , Normal
Minimal
, , 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ě build
příkazů , publish
a 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í
- Příklady nasdílení změn
- Příklady nasdílení změn
- Příklady balíčků
- Příklady publikování
- Příklady obnovení
- Testovací 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í |