NuGetCommand@2 – úloha NuGet v2
Pomocí této úlohy můžete obnovit, zabalit nebo nasdílet balíčky NuGet nebo spustit příkaz NuGet. Tato úloha podporuje NuGet.org a ověřené informační kanály, jako jsou Azure Artifacts a MyGet. Tato úloha také používá NuGet.exe a pracuje s aplikacemi rozhraní .NET Framework. Pro aplikace .NET Core a .NET Standard použijte úlohu .NET Core.
Syntax
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
inputs:
command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
#packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.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.
#allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
#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).
#packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
#arguments: # string. Required when command = custom. Command and arguments.
# 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. Select from the dropdown or enter [project name/]feed name.
#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.
#disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
#restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory.
#verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
# Advanced
#publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
#verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
# Pack options
#versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
#includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
#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.
#packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
#includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
#toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
# Advanced
#buildProperties: # string. Optional. Use when command = pack. Additional build properties.
#basePath: # string. Optional. Use when command = pack. Base path.
#verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
inputs:
command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
#packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.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.
#allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
#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).
#packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
#arguments: # string. Required when command = custom. Command and arguments.
# 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.
#disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
#restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory.
#verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
# Advanced
#publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
#verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
# Pack options
#versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
#includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
#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.
#packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
#includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
#toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
# Advanced
#buildProperties: # string. Optional. Use when command = pack. Additional build properties.
#basePath: # string. Optional. Use when command = pack. Base path.
#verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Package Management and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
inputs:
command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
#packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.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.
#allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
#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).
#packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
#arguments: # string. Required when command = custom. Command and arguments.
# 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 account/collection.
# Advanced
#noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
#disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
#restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory.
#verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
# Advanced
#verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
# Pack options
#versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
#includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
#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.
#packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
#includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
#toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
# Advanced
#buildProperties: # string. Optional. Use when command = pack. Additional build properties.
#basePath: # string. Optional. Use when command = pack. Base path.
#verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
Vstupy
command
-
command
string
. Požadovaný. Povolené hodnoty: restore
, pack
, push
, custom
. Výchozí hodnota: restore
.
Určuje příkaz NuGet, který se má spustit. K přidání argumentů nebo použití jiného příkazu použijte hodnotu custom
.
restoreSolution
-
cesta k řešení, packages.confignebo project.json
Vstupní alias: solution
.
string
. Požadováno při command = restore
. Výchozí hodnota: **/*.sln
.
Určuje cestu k řešení, packages.config
nebo project.json
souboru, který odkazuje na balíčky, které se mají obnovit.
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
.
Určuje informační kanál z Azure Artifacts nebo NuGet.org pro úlohu, která se má použít s hodnotou select
. Případně můžete potvrdit NuGet.config
soubor do úložiště zdrojového kódu a nastavit jeho cestu jako hodnotu pomocí hodnoty config
.
vstsFeed
-
Použít balíčky z tohoto informačního kanálu Azure Artifacts/TFS. Vyberte z rozevíracího seznamu nebo zadejte [název_projektu/]název informačního kanálu.
Vstupní alias: feedRestore
.
string
. Volitelný. Používá se při selectOrConfig = select && command = restore
.
Určuje vybraný informační kanál ve vygenerovaném NuGet.config
. Abyste mohli zadat informační kanál, musíte mít nainstalovanou a licencovanou správu balíčků.
vstsFeed
-
Použití balíčků z tohoto informačního kanálu Azure Artifacts/TFS
Vstupní alias: feedRestore
.
string
. Volitelný. Používá se při selectOrConfig = select && command = restore
.
Určuje vybraný informační kanál ve vygenerovaném NuGet.config
. Abyste mohli zadat informační kanál, musíte mít nainstalovanou a licencovanou správu balíčků.
includeNuGetOrg
-
Používat balíčky z NuGet.org
boolean
. Volitelný. Používá se při selectOrConfig = 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 selectOrConfig = config && command = restore
.
Určuje cestu k 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 selectOrConfig = config && command = restore
.
Určuje přihlašovací údaje, které se mají použít pro externí registry umístěné ve vybraném NuGet.config
. Toto je název připojení služby NuGet. U informačních kanálů v této organizaci nebo kolekci ponechte toto prázdné; přihlašovací údaje sestavení se používají automaticky.
externalFeedCredentials
-
přihlašovací údaje pro informační kanály mimo tento účet nebo kolekci
Vstupní alias: externalEndpoints
.
string
. Volitelný. Používá se při selectOrConfig = config && command = restore
.
Určuje přihlašovací údaje, které se mají použít pro externí registry umístěné ve vybraném NuGet.config
. Toto je název připojení služby NuGet. U informačních kanálů v tomto účtu nebo kolekci ponechte toto 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, pokud je nastavena na true
.
disableParallelProcessing
-
Zakázat paralelní zpracování
boolean
. Volitelný. Používá se při command = restore
. Výchozí hodnota: false
.
Zabraňuje NuGetu v instalaci více balíčků paralelně procesů, pokud je nastavena na true
.
cílového adresáře restoreDirectory
-
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 složky packages/
společně s vybraným řešením, packages.config
nebo project.json
.
verbosityRestore
-
podrobností
string
. Volitelný. Používá se při command = restore
. Povolené hodnoty: Quiet
, Normal
, Detailed
. Výchozí hodnota: Detailed
.
Určuje množství podrobností zobrazených ve výstupu.
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;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg
.
Určuje vzor, který se má shodovat, nebo cestu k nupkg
souborů, které se mají nahrát. Více vzorů může být odděleno středníkem.
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 účtů/kolekcí)). Výchozí hodnota: internal
.
Určuje, jestli je cílový kanál interním informačním kanálem nebo kolekcí nebo externím serverem NuGet.
nuGetFeedType
-
umístění cílového informačního kanálu
string
. Požadováno při command = push
. Povolené hodnoty: internal
(tento účet/kolekce), external
(externí server NuGet (včetně jiných účtů/kolekcí)). Výchozí hodnota: internal
.
Určuje, jestli je cílový kanál interním informačním kanálem nebo kolekcí nebo externím serverem NuGet.
cílového informačního kanálu publishVstsFeed
-
Vstupní alias: feedPublish
.
string
. Požadováno při command = push && nuGetFeedType = internal
.
Určuje informační kanál hostovaný v tomto účtu. Abyste mohli vybrat informační kanál, musíte mít nainstalovaný a licencovaný Azure Artifacts.
publishPackageMetadata
-
publikování metadat kanálu
boolean
. Volitelný. Používá se při command = push && nuGetFeedType = internal
. Výchozí hodnota: true
.
Změní číslo verze podmnožiny změněných balíčků v rámci sady neustále publikovaných balíčků.
allowPackageConflicts
-
Povolit přeskočení duplicit
boolean
. Volitelný. Používá se při command = push && nuGetFeedType = internal
. Výchozí hodnota: false
.
Hlásí úspěch úkolu i v případě, že některé balíčky jsou odmítnuty s chybami 409 Konflikt.
Tato možnost je aktuálně dostupná jenom u agentů Azure Pipelines a Windows. Pokud NuGet.exe
dojde ke konfliktu, úloha selže. Tato možnost nebude fungovat a publikování selže, pokud se nacházíte v prostředí proxy serveru.
serveru NuGet publishFeedCredentials
-
Vstupní alias: externalEndpoint
.
string
. Požadováno při command = push && nuGetFeedType = external
.
Určuje připojení služby NuGet, které obsahuje přihlašovací údaje externího serveru NuGet.
verbosityPush
-
podrobností
string
. Volitelný. Používá se při command = push
. Povolené hodnoty: Quiet
, Normal
, Detailed
. Výchozí hodnota: Detailed
.
Určuje množství podrobností zobrazených ve výstupu.
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
.
Určuje vzor, který úloha používá k vyhledání adresářů csproj, 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
- pro zabalení
Vstupní alias: configurationToPack
.
string
. Volitelný. Používá se při command = pack
. Výchozí hodnota: $(BuildConfiguration)
.
Určuje konfiguraci balíčku při použití souboru csproj.
složky balíčku packDestination
-
Vstupní alias: outputDir
.
string
. Volitelný. Používá se při command = pack
. Výchozí hodnota: $(Build.ArtifactStagingDirectory)
.
Určuje složku, ve které úloha vytváří balíčky. Pokud je hodnota prázdná, úloha vytvoří balíčky ve zdrojovém kořenovém adresáři.
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
.
Použije automatickou správu verzí balíčků v závislosti na zadané hodnotě. Tento řetězec nelze použít s includeReferencedProjects
. Povolené hodnoty jsou:
-
byPrereleaseNumber
- Použítdata a času: Úkol vygeneruje SemVerkompatibilní verzi formátovanou jakoX.Y.Z-ci-datetime
, kde zadáte hodnoty X, Y a Z. -
byEnvVar
- Použít proměnnou prostředí: Úloha použije zadaná proměnná prostředí a obsahuje číslo verze, kterou chcete použít. -
byBuildNumber
- Použít číslo sestavení: Úloha použije číslo sestavení k verzi balíčku.
Poznámka
V části Obecné nastavte formát sestavení tak, aby byl $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
.
includeReferencedProjects
-
zahrnout odkazované projekty
boolean
. Volitelný. Používá se při versioningScheme = off && command = pack
. Výchozí hodnota: false
.
Zahrnuje odkazované projekty buď jako závislosti, nebo jako součást balíčku. Nelze použít s automatickou správou verzí balíčků. Pokud má odkazovaný projekt odpovídající nuspec
soubor se stejným názvem jako projekt, přidá se tento odkazovaný projekt jako závislost. V opačném případě se odkazovaný projekt přidá jako součást balíčku. Přečtěte si další informace o pomocí příkazu pack pro rozhraní příkazového řádku NuGet k vytvoření balíčků NuGet.
proměnné prostředí versionEnvVar
-
string
. Požadováno při versioningScheme = byEnvVar && command = pack
.
Určuje název proměnné bez $
, $env
nebo %
.
majorVersion
-
hlavní
Vstupní alias: requestedMajorVersion
.
string
. Požadováno při versioningScheme = byPrereleaseNumber && command = pack
. Výchozí hodnota: 1
.
X
ve verzi X.Y.Z.
minorVersion
-
menší
Vstupní alias: requestedMinorVersion
.
string
. Požadováno při versioningScheme = byPrereleaseNumber && command = pack
. Výchozí hodnota: 0
.
Y
ve verzi X.Y.Z.
patchVersion
-
Patch
Vstupní alias: requestedPatchVersion
.
string
. Požadováno při versioningScheme = byPrereleaseNumber && command = pack
. Výchozí hodnota: 0
.
Z
ve verzi X.Y.Z.
časového pásma packTimezone
-
string
. Volitelný. Používá se při versioningScheme = byPrereleaseNumber && command = pack
. Povolené hodnoty: utc
, local
(místní čas agenta). Výchozí hodnota: utc
.
Určuje požadované časové pásmo použité k vytvoření verze balíčku. Výběr utc
se doporučuje, pokud používáte hostované agenty sestavení, protože se jejich datum a čas můžou lišit.
includeSymbols
-
vytvoření balíčku symbolů
boolean
. Volitelný. Používá se při command = pack
. Výchozí hodnota: false
.
Určuje, že balíček obsahuje zdroje a symboly. Při použití se souborem .nuspec
se vytvoří běžný soubor balíčku NuGet a odpovídající balíček symbolů.
balíčku nástrojů toolPackage
-
boolean
. Volitelný. Používá se při command = pack
. Výchozí hodnota: false
.
Určuje, jestli mají být výstupní soubory projektu ve složce nástrojů.
buildProperties
-
další vlastnosti sestavení
string
. Volitelný. Používá se při command = pack
.
Určuje seznam dvojic token=hodnota 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.
basePath
-
základní cesta
string
. Volitelný. Používá se při command = pack
.
Určuje základní cestu k souborům definovaným v souboru nuspec
.
verbosityPack
-
podrobností
string
. Volitelný. Používá se při command = pack
. Povolené hodnoty: Quiet
, Normal
, Detailed
. Výchozí hodnota: Detailed
.
Určuje množství podrobností zobrazených ve výstupu.
arguments
-
příkazy a argumenty
string
. Požadováno při command = custom
.
Určuje příkaz a argumenty, které budou předány NuGet.exe
ke spuštění. Pokud se používá NuGet 3.5 nebo novější, ověřované příkazy, jako jsou list
, restore
a publish
vůči jakémukoli informačnímu kanálu v této organizaci nebo kolekci, ke kterým má služba sestavení kolekce projektů přístup, se automaticky ověří.
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ý
Úloha ověření NuGet je novým doporučeným způsobem ověřování pomocí Azure Artifacts a dalších úložišť NuGet. Tato úloha už nepřijímá nové funkce a řeší se jenom kritické chyby.
Tato úloha slouží k instalaci a aktualizaci závislostí balíčků NuGet nebo balíčků a publikování balíčků NuGet. Používá NuGet.exe a pracuje s aplikacemi rozhraní .NET Framework. Pro aplikace .NET Core a .NET Standard použijte úlohu .NET Core.
Pokud váš kód závisí na balíčcích NuGet, nezapomeňte tento krok přidat před úlohu sestavení sady Visual Studio. Nezapomeňte také zrušit zastaralou Obnovit balíčky NuGet zaškrtávací políčko v této úloze.
Pokud pracujete s .NET Core nebo .NET Standard, použijte úlohu .NET Core, která má plnou podporu pro všechny scénáře balíčků a aktuálně ji podporuje dotnet.
Spropitné
Tato verze úlohy NuGet ve výchozím nastavení používá NuGet 4.1.0. Pokud chcete vybrat jinou verzi NuGetu, použijte instalační program nástroje .
Schémata správy verzí
Pro byPrereleaseNumberbude verze nastavena na hodnoty, které zvolíte pro hlavní verzi, podverzi a opravu a datum a čas ve formátu yyyymmdd-hhmmss
.
Pro byEnvVarbude verze nastavena na hodnotu proměnné prostředí, která má název určený parametrem versionEnvVar, například MyVersion
(bez $, pouze název proměnné prostředí). Ujistěte se, že je proměnná prostředí nastavená na správný semVer, například 1.2.3
nebo 1.2.3-beta1
.
Pro byBuildNumberbude verze nastavena pomocí čísla sestavení spuštění kanálu. Toto je hodnota zadaná pro vlastnost name
kanálu, která se uloží do proměnné prostředí BUILD_BUILDNUMBER
). Ujistěte se, že použité číslo buildu obsahuje správný semVer, například 1.0.$(Rev:r)
. Při použití byBuildNumberúloha extrahuje tečkovanou verzi, 1.2.3.4
, z číselného řetězce sestavení a použije pouze tuto část. Zbytek řetězce se zahodí. Pokud chcete použít číslo buildu tak, jak je, můžete použít byEnvVar, jak je popsáno výše, a nastavit versionEnvVar na BUILD_BUILDNUMBER
.
Migrace z NuGetInstaller@0 nebo NuGetRestore@1
NuGetInstaller@0
a NuGetRestore@1
jsou zastaralé a měli byste je v kanálu nahradit NuGetCommand@2
.
Pokud jste používali NuGetInstaller@0
s restoreMode: restore
, při použití NuGetCommand@2
nakonfigurujte následující vstupy .
NuGetCommand@2 zadání úkolu | Hodnota |
---|---|
command |
restore |
restoreSolution |
Cesta k souboru .sln |
Pokud jste používali NuGetInstaller@0
s restoreMode: install
, při použití NuGetCommand@2
nakonfigurujte následující vstupy .
NuGetCommand@2 zadání úkolu | Hodnota |
---|---|
command |
custom |
arguments |
Jak by příkaz úplné instalace vypadal v rozhraní příkazového řádku NuGet. Pokud například chcete spustit ekvivalent nuget install ninject -OutputDirectory c:\proj v kanálu, bude parametr arguments install ninject -OutputDirectory c:\proj . Pokud jste používali parametr NuGetInstaller@0 nuGetRestoreArgs , tyto parametry se teď také zobrazují v arguments . |
Pokud jste používali NuGetRestore@1
, při použití NuGetCommand@2
nakonfigurujte následující vstupy .
NuGetCommand@2 zadání úkolu | Hodnota |
---|---|
command |
restore |
restoreSolution |
Cesta k souboru .sln |
Podobně jako při použití NuGetRestore@1
nebo možnosti NuGetInstaller@0
restore
má NuGetCommand@2
vstupy pro nastavení informačního kanálu, rozhodněte se mezi select
nebo config
, zadejte cestu k souboru NuGet.config
a použijte balíčky z nuget.org.
Další informace naleznete v následujících příklady.
Příklady
Obnovit
Obnovte všechna řešení pomocí balíčků z vybraného informačního kanálu.
# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: 'select'
vstsFeed: 'my-project/my-project-scoped-feed'
includeNuGetOrg: false
restoreSolution: '**/*.sln'
# Restore from an organization scoped feed in the same organization
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: 'select'
vstsFeed: 'my-organization-scoped-feed'
restoreSolution: '**/*.sln'
# Restore from a feed in a different organization
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: config
nugetConfigPath: ./nuget.config
restoreSolution: '**/*.sln'
externalFeedCredentials: 'MyServiceConnectionName'
noCache: true
continueOnError: true
# Restore from feed(s) set in nuget.config
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: 'config'
nugetConfigPath: 'nuget.config'
Balíček
Vytvořte balíček NuGet v cílové složce.
# Package a project
- task: NuGetCommand@2
inputs:
command: 'pack'
packagesToPack: '**/*.csproj'
packDestination: '$(Build.ArtifactStagingDirectory)'
Tlačit
Poznámka
Artefakty kanálu se stáhnou do Pipeline.Workspace
adresáře a do adresáře System.ArtifactsDirectory
pro klasické kanály verze.
packagesToPush
hodnotu lze nastavit na $(Pipeline.Workspace)/**/*.nupkg
nebo $(System.ArtifactsDirectory)/**/*.nupkg
.
Nasdílení nebo publikování balíčku do informačního kanálu definovaného v NuGet.config.
# Push a project - task: NuGetCommand@2 inputs: command: 'push' packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg' feedsToUse: 'config' nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
Odeslání nebo publikování balíčku do informačního kanálu s vymezeným oborem organizace
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-organization-scoped-feed'
Nasdílení nebo publikování balíčku do informačního kanálu s vymezeným projektem
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-project/my-project-scoped-feed'
Nasdílení a publikování balíčku do NuGet.org
# Push a project - task: NuGetCommand@2 inputs: command: 'push' feedsToUse: 'config' includeNugetOrg: 'true'
Zvyk
Kromě výchozích příkazů NuGet spusťte jakýkoli jiný příkaz NuGet: pack, push a restore.
# list local NuGet resources.
- task: NuGetCommand@2
displayName: 'list locals'
inputs:
command: custom
arguments: 'locals all -list'
Požadavky
Požadavek | Popis |
---|---|
Typy kanálů | YAML, klasické sestavení, klasická verze |
Běží na | Agent, DeploymentGroup |
požadavky | Žádný |
možnosti | 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 | Balíček |
Požadavek | Popis |
---|---|
Typy kanálů | YAML, klasické sestavení, klasická verze |
Běží na | Agent, DeploymentGroup |
požadavky | Žádný |
možnosti | 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 | Balíček |