NuGetCommand@2 – NuGet v2-feladat
Ezzel a feladatgal 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 együttműködik .NET-keretrendszer alkalmazásokkal. .NET Core- és .NET Standard-alkalmazások esetén használja a .NET Core-feladatot.
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.
#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.
Bevitelek
command
- Parancs
string
. Kötelező. Engedélyezett értékek: restore
, pack
, push
, custom
. Alapértelmezett érték: restore
.
A futtatandó NuGet-parancsot adja meg. custom
Az érték használatával argumentumokat adhat hozzá, vagy másik parancsot használhat.
restoreSolution
- Megoldás elérési útja, packages.config vagy project.json
Bemeneti alias: solution
. string
. Akkor szükséges, ha command = restore
. Alapértelmezett érték: **/*.sln
.
Megadja a visszaállítandó csomagokra hivatkozó megoldás vagy packages.config
project.json
fájl elérési útját.
feedsToUse
- Használandó hírcsatornák
Bemeneti alias: selectOrConfig
. string
. Akkor szükséges, ha command = restore
. Engedélyezett értékek: select
(Itt kiválasztom a hírcsatorná(ka)t) config
(A NuGet.config hírcsatornái). Alapértelmezett érték: select
.
Az Azure Artifactsből származó hírcsatornát és/vagy NuGet.org adja meg, hogy a tevékenység az értékkel együtt select
legyen használva. Másik lehetőségként véglegesítheti a NuGet.config
fájlt a forráskódtárban, és beállíthatja annak elérési útját értékként az config
érték használatával.
vstsFeed
- Csomagok használata ebből az Azure Artifacts/TFS-hírcsatornából
Bemeneti alias: feedRestore
. string
. Választható. Használja a következőt: selectOrConfig = select && command = restore
.
A létrehozott NuGet.config
adatcsatornában kiválasztott hírcsatornát adja meg. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt megadjon egy hírcsatornát.
includeNuGetOrg
- Csomagok használata NuGet.org
boolean
. Választható. Használja a következőt: selectOrConfig = select && command = restore
. Alapértelmezett érték: true
.
Tartalmazza a létrehozott NuGet.config
NuGet.org.
nugetConfigPath
- A NuGet.configelérési útja
string
. Választható. Használja a következőt: selectOrConfig = config && command = restore
.
Megadja az adattárban lévő elérési utat NuGet.config
, amely meghatározza azokat a hírcsatornákat, amelyekből a csomagokat vissza szeretné állítani.
externalFeedCredentials
- Hitelesítő adatok a szervezeten/gyűjteményen kívüli hírcsatornákhoz
Bemeneti alias: externalEndpoints
. string
. Választható. Használja a következőt: selectOrConfig = config && command = restore
.
Megadja a kiválasztott NuGet.config
helyen található külső regisztrációs adatbázisokhoz használandó hitelesítő adatokat. Ez a NuGet-szolgáltatáskapcsolat neve. A szervezet vagy gyűjtemény hírcsatornáinál hagyja üresen a elemet; a rendszer automatikusan felhasználja a build hitelesítő adatait.
externalFeedCredentials
- Hitelesítő adatok a fiókon/gyűjteményen kívüli hírcsatornákhoz
Bemeneti alias: externalEndpoints
. string
. Választható. Használja a következőt: selectOrConfig = config && command = restore
.
Megadja a kiválasztott NuGet.config
helyen található külső regisztrációs adatbázisokhoz használandó hitelesítő adatokat. 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 felhasználja a build hitelesítő adatait.
noCache
- Helyi gyorsítótár letiltása
boolean
. Választható. Használja a következőt: 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, ha a értékre van true
állítva.
disableParallelProcessing
- Párhuzamos feldolgozás letiltása
boolean
. Választható. Használja a következőt: command = restore
. Alapértelmezett érték: false
.
Megakadályozza, hogy a NuGet több csomagot telepítsen párhuzamos folyamatokban, ha a értékre van true
állítva.
restoreDirectory
- Célkönyvtár
Bemeneti alias: packagesDirectory
. string
. Választható. Használja a következőt: command = restore
.
Meghatározza azt a mappát, amelyben a csomagok telepítve vannak. Ha nincs megadva mappa, a csomagok a kiválasztott megoldással packages.config
(vagy project.json
) együtt visszaállnak egy packages/
mappába.
verbosityRestore
- Bőbeszédűség
string
. Választható. Használja a következőt: command = restore
. Engedélyezett értékek: Quiet
, Normal
, Detailed
. Alapértelmezett érték: Detailed
.
A kimenetben megjelenített részletek mennyiségét adja meg.
packagesToPush
- A közzéteendő NuGet-csomag(ok) elérési útja
Bemeneti alias: searchPatternPush
. string
. Akkor szükséges, ha command = push
. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg
.
Megadja a feltöltendő fájlokhoz illeszkedő nupkg
mintát vagy elérési utat. Több minta pontosvesszővel is elválasztható.
nuGetFeedType
- Célcsatorna helye
string
. Akkor szükséges, ha command = push
. Engedélyezett értékek: internal
(Ez a szervezet/gyűjtemény) external
(külső NuGet-kiszolgáló (más fiókokat/gyűjteményeket is beleértve)). Alapértelmezett érték: internal
.
Meghatározza, hogy a célcsatorna belső hírcsatorna/gyűjtemény vagy külső NuGet-kiszolgáló-e.
nuGetFeedType
- Célcsatorna helye
string
. Akkor szükséges, ha command = push
. Engedélyezett értékek: internal
(Ez a fiók/gyűjtemény) external
(külső NuGet-kiszolgáló (más fiókokat/gyűjteményeket is beleértve)). Alapértelmezett érték: internal
.
Meghatározza, hogy a célcsatorna belső hírcsatorna/gyűjtemény vagy külső NuGet-kiszolgáló-e.
publishVstsFeed
- Célcsatorna
Bemeneti alias: feedPublish
. string
. Akkor szükséges, ha command = push && nuGetFeedType = internal
.
Az ebben a fiókban üzemeltetett hírcsatornát adja meg. Ahhoz, hogy itt kiválaszthassa a hírcsatornát, telepítenie és licencelnie kell az Azure Artifactst.
publishPackageMetadata
- Folyamat metaadatainak közzététele
boolean
. Választható. Használja a következőt: command = push && nuGetFeedType = internal && command = push
. Alapértelmezett érték: true
.
A módosított csomagok részhalmazának verziószámát módosítja egy folyamatosan közzétett csomagkészleten belül.
allowPackageConflicts
- Ismétlődések kihagyása
boolean
. Választható. Használja a következőt: command = push && nuGetFeedType = internal
. Alapértelmezett érték: false
.
A feladat sikerességét jelzi, még akkor is, 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özést tapasztal, a feladat sikertelen lesz. 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
. Akkor szükséges, ha command = push && nuGetFeedType = external
.
Megadja azt a NuGet-szolgáltatáskapcsolatot, amely a külső NuGet-kiszolgáló hitelesítő adatait tartalmazza.
verbosityPush
- Bőbeszédűség
string
. Választható. Használja a következőt: command = push
. Engedélyezett értékek: Quiet
, Normal
, Detailed
. Alapértelmezett érték: Detailed
.
A kimenetben megjelenített részletek mennyiségét adja meg.
packagesToPack
- A csomagolandó csproj- vagy nuspec-fájl(ok) elérési útja
Bemeneti alias: searchPatternPack
. string
. Akkor szükséges, ha command = pack
. Alapértelmezett érték: **/*.csproj
.
Azt a mintát adja meg, amelyet a feladat a csproj-könyvtárak csomagolásához használ.
Pontosvesszővel több mintát is elválaszthat egymástól, és negatívvá teheti a mintákat a előtaggal !
. Példa: **\*.csproj;!**\*.Tests.csproj
.
configuration
- Konfiguráció a csomaghoz
Bemeneti alias: configurationToPack
. string
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: $(BuildConfiguration)
.
Megadja a csproj-fájl használatakor csomagolandó konfigurációt.
packDestination
- Csomagmappa
Bemeneti alias: outputDir
. string
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)
.
Meghatározza azt a mappát, ahol a feladat csomagokat hoz létre. Ha az érték üres, a feladat csomagokat hoz létre a forrásgyökernél.
versioningScheme
- Csomag automatikus verziószámozása
string
. Akkor szükséges, ha command = pack
. Engedélyezett értékek: off
, byPrereleaseNumber
(Használja a dátumot és az időt), byEnvVar
(Környezeti változó használata) byBuildNumber
(Használja a buildszámot). Alapértelmezett érték: off
.
Automatikus csomagverzió-beállítást alkalmaz a megadott értéktől függően. Ez a sztring nem használható a következővel: includeReferencedProjects
. Az engedélyezett értékek a következők:
byPrereleaseNumber
- Használja a dátumot és az időt: A feladat létrehoz egy SemVer-kompatibilis verziótX.Y.Z-ci-datetime
a következő formátumban: , ahol megadhatja az X, Y és Z értékeket.byEnvVar
- Környezeti változó használata: A feladat egy ön által megadott környezeti változót fog használni, amely tartalmazza a használni kívánt verziószámot.byBuildNumber
- A buildszám használata: A feladat a buildszámmal fogja verziószámba adni a csomagot.
Megjegyzés
Az Általános területen állítsa be a buildformátumot a következőre $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
: .
includeReferencedProjects
- Hivatkozott projektek belefoglalása
boolean
. Választható. Használja a következőt: 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ásával nem használható. Ha egy hivatkozott projektnek van egy megfelelő nuspec
fájlja, amelynek neve megegyezik a projekt nevével, 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ó a NuGet CLI pack parancsának Használatáról NuGet-csomagok létrehozásához.
versionEnvVar
- Környezeti változó
string
. Akkor szükséges, ha versioningScheme = byEnvVar && command = pack
.
A változó nevét adja meg , $env
vagy %
nélkül$
.
majorVersion
- Nagy
Bemeneti alias: requestedMajorVersion
. string
. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack
. Alapértelmezett érték: 1
.
Az X
X.Y.Z verzióban.
minorVersion
- Kisebb
Bemeneti alias: requestedMinorVersion
. string
. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack
. Alapértelmezett érték: 0
.
Az Y
X.Y.Z verzióban.
patchVersion
- Javítás
Bemeneti alias: requestedPatchVersion
. string
. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack
. Alapértelmezett érték: 0
.
Az Z
X.Y.Z verzióban.
packTimezone
- Időzóna
string
. Választható. Használja a következőt: versioningScheme = byPrereleaseNumber && command = pack
. Engedélyezett értékek: utc
, local
(Ügynök helyi ideje). Alapértelmezett érték: utc
.
Megadja a csomag verziójának előállításához használni kívánt időzónát. A kiválasztás utc
ajánlott, ha üzemeltetett buildügynököket használ, mivel a dátum és az idő eltérhet.
includeSymbols
- Szimbólumcsomag létrehozása
boolean
. Választható. Használja a következőt: command = pack
. Alapértelmezett érték: false
.
Megadja, hogy a csomag forrásokat és szimbólumokat tartalmaz-e. Ha egy .nuspec
fájllal használja, ez létrehoz egy normál NuGet-csomagfájlt és a megfelelő szimbólumcsomagot.
toolPackage
- Eszközcsomag
boolean
. Választható. Használja a következőt: 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
. Választható. Használja a következőt: command = pack
.
Megadja a token=érték párok pontosvesszővel elválasztott listáját, ahol a .nuspec
fájl minden előfordulását $token$
lecseréli a megadott értékre. Az értékek idézőjelek között sztringek lehetnek.
basePath
- Alapútvonal
string
. Választható. Használja a következőt: command = pack
.
A fájlban nuspec
definiált fájlok alapelérési útját adja meg.
verbosityPack
- Bőbeszédűség
string
. Választható. Használja a következőt: command = pack
. Engedélyezett értékek: Quiet
, Normal
, Detailed
. Alapértelmezett érték: Detailed
.
A kimenetben megjelenített részletek mennyiségét adja meg.
arguments
- Parancsok és argumentumok
string
. Akkor szükséges, ha command = custom
.
Megadja azokat a parancsokat és argumentumokat, amelyeket a rendszer átad NuGet.exe
a végrehajtáshoz. Ha NuGet 3.5-ös vagy újabb verziót használ, a rendszer automatikusan hitelesíti az olyan hitelesített parancsokat, mint list
a , restore
és publish
a szervezet vagy gyűjtemény bármely olyan hírcsatornája, amelyhez a Projektgyűjtemény buildszolgáltatása rendelkezik hozzáféréssel.
Feladatvezérlési lehetőségek
Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.
Kimeneti változók
Nincsenek.
Megjegyzések
Fontos
A NuGet-hitelesítés feladat az új ajánlott módszer az Azure Artifacts és más NuGet-adattárak használatával történő hitelesítésre. Ez a feladat már nem vesz igénybe új funkciókat, és csak a kritikus hibákat kezeli a rendszer.
Ezzel a feladatgal telepítheti és frissítheti a NuGet-csomag függőségeit, vagy nuGet-csomagokat csomagolhat és tehet közzé. A NuGet.exe fájlt használja, és a .NET-keretrendszer alkalmazásaival működik. .NET Core- és .NET Standard-alkalmazások esetén 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 feladata előtt. Ügyeljen arra is, hogy törölje a feladat elavult NuGet-csomagok visszaállítása jelölőnégyzetét.
Ha .NET Core-t vagy .NET Standardot használ, használja a .NET Core-feladatot , amely teljes körűen támogatja az összes csomagforgatókönyvet, és jelenleg a dotnet támogatja.
Tipp
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 az Eszköztelepítőt.
Verziószámozási sémák
ByPrereleaseNumber eseté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őpontra lesz beállítva a formátumbanyyyymmdd-hhmmss
.
ByEnvVar esetén a verzió annak a környezeti változónak az értékére lesz beállítva, amely a versionEnvVar paraméter által megadott névvel rendelkezik, például MyVersion
(nem $, 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
.
ByBuildNumber esetén a verzió a folyamatfuttatás buildszámával lesz beállítva. Ez a folyamat tulajdonságához name
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 byBuildNumber használata esetén a feladat kinyeri a pontozott verziót a 1.2.3.4
buildszám sztringből, és csak ezt a részt használja. A sztring többi része el lesz dobva. Ha a buildszámot a jelenleginek megfelelően szeretné használni, használhatja a byEnvVar függvényt a fent leírt módon, és állítsa a versionEnvVar értéket értékre BUILD_BUILDNUMBER
.
Migrálás NuGetInstaller@0 vagy NuGetRestore@1
NuGetInstaller@0
és NuGetRestore@1
elavultak, és cserélje le őket a folyamatban a következőre NuGetCommand@2
: .
Ha a-t restoreMode: restore
használtaNuGetInstaller@0
, konfigurálja a következő bemeneteket a használata NuGetCommand@2
során.
NuGetCommand@2 tevékenység bemenete | Érték |
---|---|
command |
restore |
restoreSolution |
A .sln fájl elérési útja |
Ha a-t restoreMode: install
használtaNuGetInstaller@0
, konfigurálja a következő bemeneteket a használata NuGetCommand@2
során.
NuGetCommand@2 tevékenység bemenete | Érték |
---|---|
command |
custom |
arguments |
Így nézne ki a teljes telepítési parancs a NuGet CLI-ben. Ha például a megfelelőt nuget install ninject -OutputDirectory c:\proj szeretné futtatni a folyamatban, akkor a paraméter a arguments következő lesz install ninject -OutputDirectory c:\proj : . Ha a paramétert NuGetInstaller@0 nuGetRestoreArgs használta, akkor a következőt is használhatja: arguments . |
Ha a parancsot használta NuGetRestore@1
, konfigurálja a következő bemeneteket a használata NuGetCommand@2
során.
NuGetCommand@2 tevékenység bemenete | Érték |
---|---|
command |
restore |
restoreSolution |
A .sln fájl elérési útja |
A vagy arestore
NuGetInstaller@0
beállításhoz NuGetCommand@2
NuGetRestore@1
hasonlóan a bemenetekkel beállíthatja a hírcsatornát, eldöntheti select
a vagy config
a között, megadhatja a NuGet.config
fájl elérési útját, és nuget.org csomagokat használhat.
További információkért tekintse meg az alábbi példákat.
Példák
Visszaállítás
A kiválasztott hírcsatornából származó csomagokkal visszaállíthatja az összes megoldást.
# 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)'
Leküldés
Megjegyzés
A rendszer letölti a folyamatösszetevőket a Pipeline.Workspace
könyvtárba, és a System.ArtifactsDirectory
klasszikus kiadási folyamatok könyvtárába. packagesToPush
értékre vagy értékre állítható $(Pipeline.Workspace)/**/*.nupkg
$(System.ArtifactsDirectory)/**/*.nupkg
.
Csomag leküldése/közzététele a NuGet.config meghatá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 projektható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'
Egyéni
Futtasson minden más NuGet-parancsot az alapértelmezetten 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: | Ügynök, DeploymentGroup |
Igények | None |
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ármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.144.0 vagy újabb |
Feladatkategória | Csomag |
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás: | Ügynök, DeploymentGroup |
Igények | None |
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ármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.115.0 vagy újabb |
Feladatkategória | Csomag |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: