NuGetCommand@2 – NuGet v2 feladat
Ezzel a feladatsal visszaállíthatja, csomagolhatja vagy leküldheti a NuGet-csomagokat, vagy futtathat Egy NuGet-parancsot. Ez a feladat támogatja NuGet.org és hitelesített hírcsatornákat, például az Azure Artifactst és a MyGetet. Ez a feladat NuGet.exe is használ, és a .NET-keretrendszer alkalmazásaival is működik. A .NET Core- és a .NET Standard-alkalmazásokhoz használja a .NET Core-feladatot.
Szintaxis
# 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 && command = push. 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 && command = push. 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.
Bemenetek
command
-
parancs
string
. Szükséges. Engedélyezett értékek: restore
, pack
, push
, custom
. Alapértelmezett érték: restore
.
A futtatandó NuGet-parancsot adja meg. A custom
érték használatával argumentumokat adhat hozzá, vagy másik parancsot használhat.
restoreSolution
-
Megoldás elérési útja, packages.configvagy project.json
Bemeneti alias: solution
.
string
.
command = restore
esetén kötelező. Alapértelmezett érték: **/*.sln
.
Megadja a visszaállítandó csomagokra hivatkozó megoldás, packages.config
vagy project.json
fájl elérési útját.
feedsToUse
-
használni kívánt hírcsatornák
Bemeneti alias: selectOrConfig
.
string
.
command = restore
esetén kötelező. Engedélyezett értékek: select
(Itt kiválasztom a hírcsatornát), config
(A NuGet.confighírcsatornái). Alapértelmezett érték: select
.
Megadja az Azure Artifacts és/vagy a NuGet.org hírcsatornáit a tevékenységhez, amelyet a select
értékkel szeretne használni. Másik lehetőségként véglegesítheti a NuGet.config
fájlt a forráskódtárban, és beállíthatja az elérési útját értékként a config
érték használatával.
vstsFeed
-
Az Azure Artifacts/TFS-hírcsatornából származó csomagok használata. Válasszon a legördülő listából, vagy írja be a [projekt neve/]hírcsatorna nevét.
Bemeneti alias: feedRestore
.
string
. Szabadon választható. Használja a selectOrConfig = select && command = restore
.
A létrehozott NuGet.config
kijelölt hírcsatornát adja meg. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt adjon meg egy hírcsatornát.
vstsFeed
-
Az Azure Artifacts/TFS-hírcsatornából származó csomagok használata
Bemeneti alias: feedRestore
.
string
. Szabadon választható. Használja a selectOrConfig = select && command = restore
.
A létrehozott NuGet.config
kijelölt hírcsatornát adja meg. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt adjon meg egy hírcsatornát.
includeNuGetOrg
-
Csomagok használata NuGet.org
boolean
. Szabadon választható. Használja a selectOrConfig = select && command = restore
. Alapértelmezett érték: true
.
Tartalmazza a létrehozott NuGet.config
NuGet.org.
nugetConfigPath
-
elérési út a NuGet.config
string
. Szabadon választható. Használja a selectOrConfig = config && command = restore
.
Megadja a NuGet.config
elérési útját az adattárban, amely meghatározza azokat a hírcsatornákat, amelyekből a csomagokat vissza szeretné állítani.
externalFeedCredentials
-
szervezeten/gyűjteményen kívüli hírcsatornák hitelesítő adatainak
Bemeneti alias: externalEndpoints
.
string
. Szabadon választható. Használja a selectOrConfig = config && command = restore
.
A kijelölt NuGet.config
található külső regisztrációs adatbázisokhoz használandó hitelesítő adatokat adja meg. Ez a NuGet-szolgáltatáskapcsolat neve. A szervezetben vagy gyűjteményben lévő hírcsatornák esetében hagyja üresen; a rendszer automatikusan használja a build hitelesítő adatait.
externalFeedCredentials
-
a fiókon/gyűjteményen kívüli hírcsatornák hitelesítő adatainak
Bemeneti alias: externalEndpoints
.
string
. Szabadon választható. Használja a selectOrConfig = config && command = restore
.
A kijelölt NuGet.config
található külső regisztrációs adatbázisokhoz használandó hitelesítő adatokat adja meg. Ez a NuGet-szolgáltatáskapcsolat neve. Az ebben a fiókban vagy gyűjteményben lévő hírcsatornák esetében hagyja üresen; a rendszer automatikusan használja a build hitelesítő adatait.
noCache
-
Helyi gyorsítótár- letiltása
boolean
. Szabadon választható. Használja a command = restore
. Alapértelmezett érték: false
.
Megakadályozza, hogy a NuGet a helyi gép gyorsítótáraiból származó csomagokat használjon true
beállításakor.
disableParallelProcessing
-
Párhuzamos feldolgozás letiltása
boolean
. Szabadon választható. Használja a command = restore
. Alapértelmezett érték: false
.
Megakadályozza, hogy a NuGet több csomagot telepítsen párhuzamos folyamatokba true
beállításakor.
restoreDirectory
-
Célkönyvtár
Bemeneti alias: packagesDirectory
.
string
. Szabadon választható. Használja a command = restore
.
Azt a mappát adja meg, amelyben a csomagok telepítve vannak. Ha nincs megadva mappa, a csomagok a kiválasztott megoldás, packages.config
vagy project.json
mellett egy packages/
mappába kerülnek.
verbosityRestore
-
részletességi
string
. Szabadon választható. Használja a command = restore
. Engedélyezett értékek: Quiet
, Normal
, Detailed
. Alapértelmezett érték: Detailed
.
Megadja a kimenetben megjelenített részletek mennyiségét.
packagesToPush
-
NuGet-csomag(ok) elérési útja a közzétételéhez
Bemeneti alias: searchPatternPush
.
string
.
command = push
esetén kötelező. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg
.
Megadja a feltöltendő fájlok nupkg
egyező mintáját vagy elérési útját. Több minta is elválasztható pontosvesszővel.
nuGetFeedType
-
Célcsatorna helye
string
.
command = push
esetén kötelező. Engedélyezett értékek: internal
(Ez a szervezet/gyűjtemény), external
(külső NuGet-kiszolgáló (beleértve más fiókokat/gyűjteményeket is)). Alapértelmezett érték: internal
.
Megadja, hogy a célcsatorna belső hírcsatorna/gyűjtemény vagy külső NuGet-kiszolgáló-e.
nuGetFeedType
-
Célcsatorna helye
string
.
command = push
esetén kötelező. Engedélyezett értékek: internal
(Ez a fiók/gyűjtemény), external
(külső NuGet-kiszolgáló (beleértve más fiókokat/gyűjteményeket is)). Alapértelmezett érték: internal
.
Megadja, hogy a célcsatorna belső hírcsatorna/gyűjtemény vagy külső NuGet-kiszolgáló-e.
publishVstsFeed
-
Célcsatorna
Bemeneti alias: feedPublish
.
string
.
command = push && nuGetFeedType = internal
esetén kötelező.
Megadja a fiókban üzemeltetett hírcsatornát. A hírcsatorna kiválasztásához telepítve és licencelve kell lennie az Azure Artifactsnek.
publishPackageMetadata
-
Folyamat metaadatainak közzététele
boolean
. Szabadon választható. Használja a command = push && nuGetFeedType = internal && command = push
. Alapértelmezett érték: true
.
Módosítja a módosított csomagok részhalmazának verziószámát a folyamatosan közzétett csomagok halmazán belül.
allowPackageConflicts
-
Ismétlődések kihagyása
boolean
. Szabadon választható. Használja a command = push && nuGetFeedType = internal
. Alapértelmezett érték: false
.
A feladat sikerességét akkor is jelenti, ha egyes csomagok elutasítása 409 ütközési hibával történik.
Ez a lehetőség jelenleg csak az Azure Pipelinesban és a Windows-ügynökökben érhető el. Ha NuGet.exe
ütközik, a feladat meghiúsul. Ez a beállítás nem működik, és a közzététel sikertelen lesz, ha proxykörnyezetben van.
publishFeedCredentials
-
NuGet-kiszolgáló
Bemeneti alias: externalEndpoint
.
string
.
command = push && nuGetFeedType = external
esetén kötelező.
Megadja a Külső NuGet-kiszolgáló hitelesítő adatait tartalmazó NuGet-szolgáltatáskapcsolatot.
verbosityPush
-
részletességi
string
. Szabadon választható. Használja a command = push
. Engedélyezett értékek: Quiet
, Normal
, Detailed
. Alapértelmezett érték: Detailed
.
Megadja a kimenetben megjelenített részletek mennyiségét.
packagesToPack
-
csproj- vagy nuspec-fájl(ok) elérési útja a
Bemeneti alias: searchPatternPack
.
string
.
command = pack
esetén kötelező. Alapértelmezett érték: **/*.csproj
.
Azt a mintát adja meg, amelyet a feladat a csproj-könyvtárak csomagolásához használ.
Több mintát is elválaszthat pontosvesszővel, és negatívvá teheti a mintákat úgy, hogy előtagot ad !
. Példa: **\*.csproj;!**\*.Tests.csproj
.
configuration
-
konfiguráció a csomagolásához
Bemeneti alias: configurationToPack
.
string
. Szabadon választható. Használja a command = pack
. Alapértelmezett érték: $(BuildConfiguration)
.
Megadja a csproj-fájl használatakor csomagolni kívánt konfigurációt.
packDestination
-
Csomag mappa
Bemeneti alias: outputDir
.
string
. Szabadon választható. Használja a command = pack
. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)
.
Megadja azt a mappát, ahol a feladat csomagokat hoz létre. Ha az érték üres, a tevékenység csomagokat hoz létre a forrásgyökernél.
versioningScheme
-
Csomag automatikus verziószámozási
string
.
command = pack
esetén kötelező. Engedélyezett értékek: off
, byPrereleaseNumber
(Dátum és idő használata), byEnvVar
(Környezeti változó használata), byBuildNumber
(A buildszám használata). Alapértelmezett érték: off
.
A megadott értéktől függően automatikus csomagverziót alkalmaz. Ez a sztring nem használható includeReferencedProjects
. Az engedélyezett értékek a következők:
-
byPrereleaseNumber
- A dátum és az időhasználata: A feladat létrehoz egy SemVer-kompatibilis verziótX.Y.Z-ci-datetime
formátumban, ahol megadhatja az X, Y és Z értékeket. -
byEnvVar
- Környezeti változó használata: A tevékenység egy ön által megadott környezeti változót használ, amely tartalmazza a használni kívánt verziószámot. -
byBuildNumber
- A buildszám használata: A feladat a buildszámot használja a csomag verziószámához.
Jegyzet
Az Általános csoportban állítsa be a build formátumát $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
.
includeReferencedProjects
-
Hivatkozott projektek belefoglalása
boolean
. Szabadon választható. Használja a versioningScheme = off && command = pack
. Alapértelmezett érték: false
.
A hivatkozott projekteket függőségként vagy a csomag részeként tartalmazza. A csomag automatikus verziószámozása nem használható. Ha egy hivatkozott projekt rendelkezik a projekt nevével megegyező nevű nuspec
fájllal, akkor a hivatkozott projekt függőségként lesz hozzáadva. Ellenkező esetben a hivatkozott projekt a csomag részeként lesz hozzáadva. További információ arról, a NuGet CLI csomagparancsával hozhat létre NuGet-csomagokat.
versionEnvVar
-
környezeti változó
string
.
versioningScheme = byEnvVar && command = pack
esetén kötelező.
Megadja a változó nevét $
, $env
vagy %
nélkül.
majorVersion
-
fő
Bemeneti alias: requestedMajorVersion
.
string
.
versioningScheme = byPrereleaseNumber && command = pack
esetén kötelező. Alapértelmezett érték: 1
.
minorVersion
-
kisebb
Bemeneti alias: requestedMinorVersion
.
string
.
versioningScheme = byPrereleaseNumber && command = pack
esetén kötelező. Alapértelmezett érték: 0
.
patchVersion
-
patch
Bemeneti alias: requestedPatchVersion
.
string
.
versioningScheme = byPrereleaseNumber && command = pack
esetén kötelező. Alapértelmezett érték: 0
.
packTimezone
-
időzóna
string
. Szabadon választható. Használja a versioningScheme = byPrereleaseNumber && command = pack
. Engedélyezett értékek: utc
, local
(ügynök helyi idő szerint). Alapértelmezett érték: utc
.
Megadja a csomag verziójának előállításához használt kívánt időzónát. A utc
kiválasztása ajánlott, ha üzemeltetett buildügynököket használ, mivel a dátum és az idő eltérhet.
includeSymbols
-
Szimbólumok létrehozása csomag
boolean
. Szabadon választható. Használja a command = pack
. Alapértelmezett érték: false
.
Megadja, hogy a csomag forrásokat és szimbólumokat tartalmaz-e. Ha .nuspec
fájllal használja, ez létrehoz egy normál NuGet-csomagfájlt és a megfelelő szimbólumcsomagot.
toolPackage
-
eszközcsomag
boolean
. Szabadon választható. Használja a command = pack
. Alapértelmezett érték: false
.
Meghatározza, hogy a projekt kimeneti fájljainak az eszközmappában kell-e lenniük.
buildProperties
-
További buildtulajdonságok
string
. Szabadon választható. Használja a command = pack
.
Pontosvesszővel elválasztott token=érték párok listáját adja meg, ahol a .nuspec
fájlban lévő $token$
minden előfordulása a megadott értékre lesz lecserélve. Az értékek idézőjelekben sztringek lehetnek.
basePath
-
Alapútvonal
string
. Szabadon választható. Használja a command = pack
.
A nuspec
fájlban definiált fájlok alap elérési útját adja meg.
verbosityPack
-
részletességi
string
. Szabadon választható. Használja a command = pack
. Engedélyezett értékek: Quiet
, Normal
, Detailed
. Alapértelmezett érték: Detailed
.
Megadja a kimenetben megjelenített részletek mennyiségét.
arguments
-
parancsok és argumentumok
string
.
command = custom
esetén kötelező.
Megadja a végrehajtáshoz NuGet.exe
átadott parancsokat és argumentumokat. Ha NuGet 3.5-ös vagy újabb verziót használ, a rendszer automatikusan hitelesíti az olyan hitelesített parancsokat, mint a list
, a restore
és a publish
a szervezet vagy gyűjtemény bármely olyan hírcsatornáján, amelyhez a Project Collection Build Service rendelkezik hozzáféréssel.
Tevékenységvezérlési beállítások
Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.
Kimeneti változók
Egyik sem.
Megjegyzések
Fontos
A NuGet-hitelesítés feladat az Azure Artifacts és más NuGet-tárházakkal való hitelesítés új ajánlott módja. Ez a feladat már nem vesz igénybe új funkciókat, és csak a kritikus hibákat kezeli.
Ezzel a feladatgal telepítheti és frissítheti a NuGet-csomag függőségeit, vagy csomagolhatja és teheti közzé a NuGet-csomagokat. NuGet.exe használ, és a .NET-keretrendszeralkalmazásokkal dolgozik. A .NET Core- és a .NET Standard-alkalmazásokhoz használja a .NET Core-feladatot.
Ha a kód a NuGet-csomagoktól függ, mindenképpen adja hozzá ezt a lépést a Visual Studio buildelési feladat. Ügyeljen arra is, hogy törölje az elavult NuGet-csomagok visszaállítása jelölőnégyzet jelölését.
Ha a .NET Core vagy a .NET Standard használatával dolgozik, használja a .NET Core feladatot, amely teljes mértékben támogatja az összes csomagforgatókönyvet, és jelenleg a dotnet támogatja.
Borravaló
A NuGet-feladat ezen verziója alapértelmezés szerint a NuGet 4.1.0-s verzióját használja. A NuGet másik verziójának kiválasztásához használja a Tool Installer.
Verziószámozási sémák
A byPrereleaseNumberesetén a verzió a főverzióhoz, az alverzióhoz és a javításhoz választott értékekre, valamint a dátumra és időre lesz beállítva yyyymmdd-hhmmss
formátumban.
A byEnvVaresetében a verzió a versionEnvVar paraméter által megadott nevű környezeti változó értékére lesz állítva, például MyVersion
(nincs $, csak a környezeti változó neve). Győződjön meg arról, hogy a környezeti változó megfelelő SemVer értékre van állítva, például 1.2.3
vagy 1.2.3-beta1
.
A byBuildNumberesetében a verzió a folyamatfuttatás buildszámával lesz beállítva. Ez a folyamat name
tulajdonságához megadott érték, amelyet a rendszer a BUILD_BUILDNUMBER
környezeti változóba ment. Győződjön meg arról, hogy a használt buildszám megfelelő SemVer-et tartalmaz, például 1.0.$(Rev:r)
. A byBuildNumberhasználatakor a feladat kinyeri a pontozott verziót 1.2.3.4
a buildszám sztringből, és csak ezt a részt használja. A sztring többi része el lesz ejtve. Ha a buildszámot a fentieknek megfelelően szeretné használni, használhatja a byEnvVar a fent leírtak szerint, és versionEnvVarBUILD_BUILDNUMBER
értékre állíthatja.
Migrálás NuGetInstaller@0 vagy NuGetRestore@1
NuGetInstaller@0
és NuGetRestore@1
elavultak, és ezeket a folyamat során NuGetCommand@2
kell lecserélnie.
Ha NuGetInstaller@0
használt restoreMode: restore
, konfigurálja a következő bemeneteket a NuGetCommand@2
használatakor.
NuGetCommand@2 tevékenységbemenet | Érték |
---|---|
command |
restore |
restoreSolution |
A .sln fájl elérési útja |
Ha NuGetInstaller@0
használt restoreMode: install
, konfigurálja a következő bemeneteket a NuGetCommand@2
használatakor.
NuGetCommand@2 tevékenységbemenet | Érték |
---|---|
command |
custom |
arguments |
A Teljes telepítési parancs megjelenése a NuGet PARANCSSORI-ban. Ha például az nuget install ninject -OutputDirectory c:\proj megfelelőt szeretné futtatni a folyamatban, akkor a arguments paraméter install ninject -OutputDirectory c:\proj lesz. Ha a NuGetInstaller@0 nuGetRestoreArgs paramétert használta, ezek is arguments . |
Ha NuGetRestore@1
használ, konfigurálja a következő bemeneteket a NuGetCommand@2
használatakor.
NuGetCommand@2 tevékenységbemenet | Érték |
---|---|
command |
restore |
restoreSolution |
A .sln fájl elérési útja |
A NuGetRestore@1
vagy a NuGetInstaller@0
restore
beállításhoz hasonlóan NuGetCommand@2
bemenetekkel is rendelkezik a hírcsatorna beállításához, a select
vagy config
közötti döntéshez, a NuGet.config
fájl elérési útjának megadásához, valamint a nuget.org csomagjainak használatához.
További információ: példák.
Példák
Visszaad
Állítsa vissza az összes megoldást egy kijelölt hírcsatornából származó csomagokkal.
# 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'
Csomag
Hozzon létre egy NuGet-csomagot a célmappában.
# Package a project
- task: NuGetCommand@2
inputs:
command: 'pack'
packagesToPack: '**/*.csproj'
packDestination: '$(Build.ArtifactStagingDirectory)'
Tol
Jegyzet
A folyamatösszetevők a Pipeline.Workspace
könyvtárba, a klasszikus kiadási folyamatok System.ArtifactsDirectory
könyvtárába lesznek letöltve.
packagesToPush
érték beállítható $(Pipeline.Workspace)/**/*.nupkg
vagy $(System.ArtifactsDirectory)/**/*.nupkg
értékre.
Csomag leküldése/közzététele a NuGet.configmeghatározott csatornán.
# Push a project - task: NuGetCommand@2 inputs: command: 'push' packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg' feedsToUse: 'config' nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
Csomag leküldése/közzététele szervezeti hatókörű hírcsatornán
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-organization-scoped-feed'
Csomag leküldése/közzététele projekt hatókörű hírcsatornában
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-project/my-project-scoped-feed'
Csomag leküldése/közzététele NuGet.org
# Push a project - task: NuGetCommand@2 inputs: command: 'push' feedsToUse: 'config' includeNugetOrg: 'true'
Szokás
Futtasson más NuGet-parancsokat az alapértelmezetteken kívül: csomag, leküldés és visszaállítás.
# list local NuGet resources.
- task: NuGetCommand@2
displayName: 'list locals'
inputs:
command: custom
arguments: 'locals all -list'
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás bekapcsolva | Ügynök, DeploymentGroup |
Követelmények | Egyik sem |
képességek | Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
parancskorlátozások | Bármely |
Változók beállítása | Bármely |
Ügynök verziója | 2.144.0 vagy újabb |
Tevékenységkategória | Csomag |
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás bekapcsolva | Ügynök, DeploymentGroup |
Követelmények | Egyik sem |
képességek | Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
parancskorlátozások | Bármely |
Változók beállítása | Bármely |
Ügynök verziója | 2.115.0 vagy újabb |
Tevékenységkategória | Csomag |