Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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.
Tip
Před touto úlohou použijte NuGetAuthenticate@1 v kanálu. Další informace najdete v tématu Proč můj kanál buildu selhává a zobrazuje výzvu k ověření jednotného Sign-On (SSO)?.
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.
Inputs
command
-
Příkaz
string. Required. 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
Alias vstupu: solution.
string. Požadováno při command = restore. Výchozí hodnota: **/*.sln.
Určuje cestu k řešení, packages.confignebo project.json souboru, který odkazuje na balíčky, které se mají obnovit.
feedsToUse
-
informační kanály pro použití
Alias vstupu: 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.
Alias vstupu: feedRestore.
string. Optional. 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
Alias vstupu: feedRestore.
string. Optional. 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. Optional. 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. Optional. 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
Alias vstupu: externalEndpoints.
string. Optional. 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.
noCache
-
Zakázat místní mezipaměti
boolean. Optional. 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. Optional. 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.
restoreDirectory
-
Cílový adresář
Alias vstupu: packagesDirectory.
string. Optional. 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.confignebo project.json.
verbosityRestore
-
Mnohomluvnost
string. Optional. 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í
Alias vstupu: 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.
publishVstsFeed
-
Cílový zdroj
Alias vstupu: 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. Optional. 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. Optional. 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.
publishFeedCredentials
-
Server NuGet
Alias vstupu: 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
-
Mnohomluvnost
string. Optional. 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í
Alias vstupu: 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í
Alias vstupu: configurationToPack.
string. Optional. Používá se při command = pack. Výchozí hodnota: $(BuildConfiguration).
Určuje konfiguraci balíčku při použití souboru csproj.
packDestination
-
Složka balíčku
Alias vstupu: outputDir.
string. Optional. 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.
Note
V části Obecné nastavte formát sestavení tak, aby byl $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).
includeReferencedProjects
-
zahrnout odkazované projekty
boolean. Optional. 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.
versionEnvVar
-
Proměnná prostředí
string. Požadováno při versioningScheme = byEnvVar && command = pack.
Určuje název proměnné bez $, $envnebo %.
majorVersion
-
Major
Alias vstupu: requestedMajorVersion.
string. Požadováno při versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 1.
Ve X verzi X.Y.Z.
minorVersion
-
Moll
Alias vstupu: requestedMinorVersion.
string. Požadováno při versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.
Ve Y verzi X.Y.Z.
patchVersion
-
Záplata
Alias vstupu: requestedPatchVersion.
string. Požadováno při versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.
Ve Z verzi X.Y.Z.
packTimezone
-
Časová zóna
string. Optional. 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. Optional. 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ů.
toolPackage
-
Balíček nářadí
boolean. Optional. 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. Optional. 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. Optional. Používá se při command = pack.
Určuje základní cestu k souborům definovaným v souboru nuspec.
verbosityPack
-
Mnohomluvnost
string. Optional. 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, restorea 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é
None.
Remarks
Important
Pokud se chcete ověřit pomocí Azure Artifacts nebo jiných úložišť NuGet, musíte místo NuGetCommand@2 úlohy použít úlohu NuGet Authenticate. Úloha NuGetCommand@2 již není aktualizována o nové funkce, jsou řešeny pouze kritické chyby.
Tato úloha slouží k obnovení, zabalení nebo odeslání balíčků NuGet nebo ke spuštění příkazů NuGet. Tato úloha používá NuGet.exe a funguje s aplikacemi .NET Framework. 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 je v současné době podporována dotnet.
Pokud váš kód závisí na balíčcích NuGet a potřebujete tyto závislosti obnovit před sestavením projektu pomocí úlohy Visual Studio Build Task , můžete k obnovení balíčků použít nugetAuthenticate úlohy a úlohy příkazového řádku . Umístěte obě úlohy před krok sestavení, abyste zajistili, že všechny závislosti budou k dispozici před zahájením sestavení. Další podrobnosti najdete v tématu Obnovení balíčků NuGet .
Při použití úlohy sestavení sady Visual Studio nezapomeňte ponechat argument restoreNugetPackages prázdný, protože možnost Obnovit balíčky NuGet je v úloze VSBuild@1 zastaralá.
Tip
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 byPrereleaseNumber bude verze nastavena na hodnoty, které zvolíte pro hlavní verzi, podverzi a opravu, plus datum a čas ve formátu yyyymmdd-hhmmss.
Pro byEnvVar bude verze nastavena na hodnotu proměnné prostředí, která má název určený parametrem versionEnvVar, např. (ne$, MyVersion 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.
V případě byBuildNumber bude 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í atributu byBuildNumber úloha extrahuje tečkovanou verzi 1.2.3.4, z řetězce čísel sestavení a použije pouze tuto část. Zbytek řetězce se zahodí. Pokud chcete použít číslo sestavení 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@2nakonfigurujte následující vstupy .
| NuGetCommand@2 zadání úkolu | Value |
|---|---|
command |
restore |
restoreSolution |
Cesta k souboru .sln |
Pokud jste používali NuGetInstaller@0 s restoreMode: install, při použití NuGetCommand@2nakonfigurujte následující vstupy .
| NuGetCommand@2 zadání úkolu | Value |
|---|---|
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 argumentsinstall ninject -OutputDirectory c:\proj. Pokud jste používali parametr NuGetInstaller@0nuGetRestoreArgs, tyto parametry se teď také zobrazují v arguments. |
Pokud jste používali NuGetRestore@1, při použití NuGetCommand@2nakonfigurujte následující vstupy .
| NuGetCommand@2 zadání úkolu | Value |
|---|---|
command |
restore |
restoreSolution |
Cesta k souboru .sln |
Podobně jako při použití NuGetRestore@1 nebo možnosti NuGetInstaller@0restore 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říkladech.
Podpora novějších hostovaných imagí Ubuntu
Od Ubuntu 24.04 se agenti hostovaní microsftem nedoručí s mono, který je nutný ke spuštění základního klienta NuGet, který využívá NuGetCommand@2. Uživatelé této úlohy v Ubuntu by měli migrovat na dlouhodobou podporovanou úlohu napříč platformami NuGetAuthenticate@1 s rozhraním .NET CLI.
Migrace na .NET CLI v Ubuntu
Úloha NuGet Authenticate se postará o vložení přihlašovacích údajů do potřebných míst, aby se klientské nástroje ověřily jako vaše identita kanálu. Další informace o používání NuGet Authenticate s dotnet najdete v částech Příklady a poznámky.
Pokud příkazy rozhraní příkazového řádku dotnet váš scénář nepodporují, ohlásit tento problém týmu .NET CLI jako problém. Image agenta můžete dál připnout na Ubuntu 22.04 nebo starší. Podpora Ubuntu 22.04 bude pokračovat, dokud nebude ubuntu 26.04 obecně k dispozici, ne starší než 2026.
Proč můj kanál buildu selhává a zobrazuje výzvu k ověření jednotného Sign-On (SSO)?
Sestavení mohou selhat, pokud vypršela platnost přihlašovacích údajů. Abyste se těmto selháním vyhnuli, doporučujeme použít úlohu NuGet Authenticate k přeinstalaci poskytovatele přihlašovacích údajů a automatické aktualizaci přihlašovacích údajů. Tím je zajištěn nepřerušovaný přístup během provádění kanálu.
steps:
# Authenticate with NuGet to ensure credentials are refreshed
- task: NuGetAuthenticate@1
# Restore NuGet packages
- task: NuGetCommand@2
inputs:
command: 'restore'
restoreSolution: '**/*.sln'
feedsToUse: 'select'
Examples
Restore
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'
Package
Vytvořte balíček NuGet v cílové složce.
# Package a project
- task: NuGetCommand@2
inputs:
command: 'pack'
packagesToPack: '**/*.csproj'
packDestination: '$(Build.ArtifactStagingDirectory)'
Posunout
Note
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'
Custom
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'
Requirements
| Requirement | Description |
|---|---|
| Typy potrubí | YAML, klasické sestavení, klasická verze |
| Běží na | Agent, skupina nasazení |
| Demands | None |
| Capabilities | Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze. |
| Omezení příkazů | Any |
| Nastavitelné proměnné | Any |
| Verze agenta | 2.144.0 nebo vyšší |
| Kategorie úkolu | Package |
| Requirement | Description |
|---|---|
| Typy potrubí | YAML, klasické sestavení, klasická verze |
| Běží na | Agent, skupina nasazení |
| Demands | None |
| Capabilities | Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze. |
| Omezení příkazů | Any |
| Nastavitelné proměnné | Any |
| Verze agenta | 2.115.0 nebo vyšší |
| Kategorie úkolu | Package |