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.configproject.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.configadatcsatorná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.configNuGet.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.confighelyen 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.confighelyen 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ót X.Y.Z-ci-datetimea 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 , $envvagy %nélkül$.


majorVersion - Nagy
Bemeneti alias: requestedMajorVersion. string. Akkor szükséges, ha versioningScheme = byPrereleaseNumber && command = pack. Alapértelmezett érték: 1.

Az XX.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 YX.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 ZX.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 lista , 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.4buildszá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: restorehasználtaNuGetInstaller@0, konfigurálja a következő bemeneteket a használata NuGetCommand@2során.

NuGetCommand@2 tevékenység bemenete Érték
command restore
restoreSolution A .sln fájl elérési útja

Ha a-t restoreMode: installhasználtaNuGetInstaller@0, konfigurálja a következő bemeneteket a használata NuGetCommand@2sorá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@0nuGetRestoreArgs 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@2során.

NuGetCommand@2 tevékenység bemenete Érték
command restore
restoreSolution A .sln fájl elérési útja

A vagy arestoreNuGetInstaller@0beállításhoz NuGetCommand@2NuGetRestore@1 hasonlóan a bemenetekkel beállíthatja a hírcsatornát, eldöntheti select a vagy configa 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