NuGetCommand@2 - NuGet v2 görevi
NuGet paketlerini geri yüklemek, paketlemek veya göndermek ya da bir NuGet komutu çalıştırmak için bu görevi kullanın. Bu görev Azure Artifacts ve MyGet gibi NuGet.org ve kimliği doğrulanmış akışları destekler. Bu görev ayrıca NuGet.exe kullanır ve .NET Framework uygulamalarla çalışır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.
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.
Girişler
command
- Komut
string
. Gereklidir. İzin verilen değerler: restore
, pack
, push
, custom
. Varsayılan değer: restore
.
Çalıştırılacak NuGet komutunu belirtir. custom
Bağımsız değişken eklemek veya farklı bir komut kullanmak için değerini kullanın.
restoreSolution
- Çözüm, packages.config veya project.json yolu
Giriş diğer adı: solution
. string
. olduğunda command = restore
gereklidir. Varsayılan değer: **/*.sln
.
Geri yüklenecek paketlere başvuran çözüm, packages.config
veya project.json
dosyanın yolunu belirtir.
feedsToUse
- Kullanılacak akışlar
Giriş diğer adı: selectOrConfig
. string
. olduğunda command = restore
gereklidir. İzin verilen değerler: select
(Burada seçtiğim akışlar), config
(NuGet.config akışlar). Varsayılan değer: select
.
Görev için Azure Artifacts'ten ve/veya NuGet.org değeriyle select
kullanılacak akışı belirtir. Alternatif olarak, kaynak kod deponuza bir NuGet.config
dosya işleyebilir ve değerini kullanarak config
yolunu değer olarak ayarlayabilirsiniz.
vstsFeed
- Bu Azure Artifacts/TFS akışındaki paketleri kullan
Giriş diğer adı: feedRestore
. string
. İsteğe bağlı. olduğunda selectOrConfig = select && command = restore
kullanın.
Oluşturulan NuGet.config
içinde seçili akışı belirtir. Burada bir akış belirtmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.
includeNuGetOrg
- NuGet.org paketlerini kullanma
boolean
. İsteğe bağlı. olduğunda selectOrConfig = select && command = restore
kullanın. Varsayılan değer: true
.
Oluşturulan NuGet.config
öğesine NuGet.org ekler.
nugetConfigPath
- NuGet.configyolu
string
. İsteğe bağlı. olduğunda selectOrConfig = config && command = restore
kullanın.
Deponuzda paketlerin geri yükleneceği akışları belirleyen yolunu NuGet.config
belirtir.
externalFeedCredentials
- Bu kuruluş/koleksiyon dışındaki akışlar için kimlik bilgileri
Giriş diğer adı: externalEndpoints
. string
. İsteğe bağlı. olduğunda selectOrConfig = config && command = restore
kullanın.
Seçili NuGet.config
içinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgilerini belirtir. Bu, NuGet hizmet bağlantınızın adıdır. Bu kuruluş veya koleksiyondaki akışlar için bunu boş bırakın; derlemenin kimlik bilgileri otomatik olarak kullanılır.
externalFeedCredentials
- Bu hesap/koleksiyon dışındaki akışlar için kimlik bilgileri
Giriş diğer adı: externalEndpoints
. string
. İsteğe bağlı. olduğunda selectOrConfig = config && command = restore
kullanın.
Seçili NuGet.config
içinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgilerini belirtir. Bu, NuGet hizmet bağlantınızın adıdır. Bu hesap veya koleksiyondaki akışlar için bunu boş bırakın; derlemenin kimlik bilgileri otomatik olarak kullanılır.
noCache
- Yerel önbelleği devre dışı bırakma
boolean
. İsteğe bağlı. olduğunda command = restore
kullanın. Varsayılan değer: false
.
Olarak ayarlandığında true
NuGet'in yerel makine önbelleklerinden gelen paketleri kullanmasını engeller.
disableParallelProcessing
- Paralel işlemeyi devre dışı bırakma
boolean
. İsteğe bağlı. olduğunda command = restore
kullanın. Varsayılan değer: false
.
Olarak ayarlandığında NuGet'in paralel işlemlerde birden çok paket yüklemesini true
engeller.
restoreDirectory
- Hedef dizin
Giriş diğer adı: packagesDirectory
. string
. İsteğe bağlı. olduğunda command = restore
kullanın.
Paketlerin yüklendiği klasörü belirtir. Hiçbir klasör belirtilmezse, paketler seçilen çözüm packages.config
veya project.json
ile birlikte bir packages/
klasöre geri yüklenir.
verbosityRestore
- Ayrıntı
string
. İsteğe bağlı. olduğunda command = restore
kullanın. İzin verilen değerler: Quiet
, Normal
, Detailed
. Varsayılan değer: Detailed
.
Çıktıda görüntülenen ayrıntı miktarını belirtir.
packagesToPush
- Yayımlayacak NuGet paketlerinin yolu
Giriş diğer adı: searchPatternPush
. string
. olduğunda command = push
gereklidir. Varsayılan değer: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg
.
Eşleştirilecek deseni veya karşıya yüklenecek dosyaların yolunu nupkg
belirtir. Birden çok desen noktalı virgülle ayrılabilir.
nuGetFeedType
- Hedef akış konumu
string
. olduğunda command = push
gereklidir. İzin verilen değerler: internal
(Bu kuruluş/koleksiyon), external
(Dış NuGet sunucusu (diğer hesaplar/koleksiyonlar dahil)). Varsayılan değer: internal
.
Hedef akışın bir iç akış/koleksiyon mu yoksa bir dış NuGet sunucusu mu olduğunu belirtir.
nuGetFeedType
- Hedef akış konumu
string
. olduğunda command = push
gereklidir. İzin verilen değerler: internal
(Bu hesap/koleksiyon), external
(Dış NuGet sunucusu (diğer hesaplar/koleksiyonlar dahil)). Varsayılan değer: internal
.
Hedef akışın bir iç akış/koleksiyon mu yoksa bir dış NuGet sunucusu mu olduğunu belirtir.
publishVstsFeed
- Hedef akış
Giriş diğer adı: feedPublish
. string
. olduğunda command = push && nuGetFeedType = internal
gereklidir.
Bu hesapta barındırılan bir akışı belirtir. Burada bir akış seçmek için Azure Artifacts'in yüklü ve lisanslı olması gerekir.
publishPackageMetadata
- İşlem hattı meta verilerini yayımlama
boolean
. İsteğe bağlı. olduğunda command = push && nuGetFeedType = internal && command = push
kullanın. Varsayılan değer: true
.
Sürekli yayımlanan bir paket kümesi içindeki değiştirilen paketlerin alt kümesinin sürüm numarasını değiştirir.
allowPackageConflicts
- Yinelenenlerin atlanması için izin ver
boolean
. İsteğe bağlı. olduğunda command = push && nuGetFeedType = internal
kullanın. Varsayılan değer: false
.
Bazı paketleriniz 409 Çakışma hatalarıyla reddedilmiş olsa bile görevin başarılı olduğunu bildirir.
Bu seçenek şu anda yalnızca Azure Pipelines ve Windows aracılarında kullanılabilir. Çakışmayla karşılaşırsanız NuGet.exe
görev başarısız olur. Bu seçenek çalışmaz ve bir ara sunucu ortamındaysanız yayımlama başarısız olur.
publishFeedCredentials
- NuGet sunucusu
Giriş diğer adı: externalEndpoint
. string
. olduğunda command = push && nuGetFeedType = external
gereklidir.
Dış NuGet sunucusunun kimlik bilgilerini içeren NuGet hizmet bağlantısını belirtir.
verbosityPush
- Ayrıntı
string
. İsteğe bağlı. olduğunda command = push
kullanın. İzin verilen değerler: Quiet
, Normal
, Detailed
. Varsayılan değer: Detailed
.
Çıktıda görüntülenen ayrıntı miktarını belirtir.
packagesToPack
- Paketlenmesi gereken csproj veya nuspec dosyasının yolu
Giriş diğer adı: searchPatternPack
. string
. olduğunda command = pack
gereklidir. Varsayılan değer: **/*.csproj
.
Görevin paketlenmek üzere csproj dizinlerini aramak için kullandığı deseni belirtir.
Birden çok deseni noktalı virgülle ayırabilir ve ön ekiyle !
ekleyerek negatif bir desen oluşturabilirsiniz. Örnek: **\*.csproj;!**\*.Tests.csproj
.
configuration
- Pakete yapılandırma
Giriş diğer adı: configurationToPack
. string
. İsteğe bağlı. olduğunda command = pack
kullanın. Varsayılan değer: $(BuildConfiguration)
.
Csproj dosyası kullanılırken pakete eklenecek yapılandırmayı belirtir.
packDestination
- Paket klasörü
Giriş diğer adı: outputDir
. string
. İsteğe bağlı. olduğunda command = pack
kullanın. Varsayılan değer: $(Build.ArtifactStagingDirectory)
.
Görevin paketleri oluşturduğu klasörü belirtir. Değer boşsa, görev kaynak kökte paketler oluşturur.
versioningScheme
- Otomatik paket sürümü oluşturma
string
. olduğunda command = pack
gereklidir. İzin verilen değerler: off
, byPrereleaseNumber
(Tarih ve saati kullanın), byEnvVar
(Ortam değişkeni kullanın), byBuildNumber
(Derleme numarasını kullanın). Varsayılan değer: off
.
Belirtilen değere bağlı olarak otomatik paket sürümü oluşturma uygular. Bu dize ile includeReferencedProjects
kullanılamaz. İzin verilen değerler şunlardır:
byPrereleaseNumber
- Tarih ve saati kullanın: Görev olarakX.Y.Z-ci-datetime
biçimlendirilmiş SemVer uyumlu bir sürüm oluşturur ve burada X, Y ve Z değerlerini belirtirsiniz.byEnvVar
- Ortam değişkeni kullan: Görev, belirttiğiniz bir ortam değişkeni kullanır ve kullanmak istediğiniz sürüm numarasını içerir.byBuildNumber
- Derleme numarasını kullanın: Görev, paketin sürümünü oluşturmak için derleme numarasını kullanır.
Not
Genel'in altında derleme biçimini olarak $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
ayarlayın.
includeReferencedProjects
- Başvuruda bulunılan projeleri dahil et
boolean
. İsteğe bağlı. olduğunda versioningScheme = off && command = pack
kullanın. Varsayılan değer: false
.
Başvuruda bulunan projeleri bağımlılık olarak veya paketin bir parçası olarak içerir. Otomatik paket sürümü oluşturma ile kullanılamaz. Başvuruda bulunılan bir proje, projeyle aynı ada sahip karşılık gelen nuspec
bir dosyaya sahipse, başvuruda bulunılan proje bağımlılık olarak eklenir. Aksi takdirde, başvuruda bulunan proje paketin bir parçası olarak eklenir. NuGet paketleri oluşturmak için NuGet CLI için paket komutunu kullanma hakkında daha fazla bilgi edinin.
versionEnvVar
- Ortam değişkeni
string
. olduğunda versioningScheme = byEnvVar && command = pack
gereklidir.
değişken adını , $env
veya %
olmadan $
belirtir.
majorVersion
- Büyük
Giriş diğer adı: requestedMajorVersion
. string
. olduğunda versioningScheme = byPrereleaseNumber && command = pack
gereklidir. Varsayılan değer: 1
.
sürüm X
X.Y.Z.
minorVersion
- Küçük
Giriş diğer adı: requestedMinorVersion
. string
. olduğunda versioningScheme = byPrereleaseNumber && command = pack
gereklidir. Varsayılan değer: 0
.
sürüm Y
X.Y.Z.
patchVersion
- Yama
Giriş diğer adı: requestedPatchVersion
. string
. olduğunda versioningScheme = byPrereleaseNumber && command = pack
gereklidir. Varsayılan değer: 0
.
sürüm Z
X.Y.Z.
packTimezone
- Saat dilimi
string
. İsteğe bağlı. olduğunda versioningScheme = byPrereleaseNumber && command = pack
kullanın. İzin verilen değerler: utc
, local
(Aracı yerel saati). Varsayılan değer: utc
.
Paketin sürümünü oluşturmak için kullanılan istenen saat dilimini belirtir. utc
Tarih ve saat farklı olabileceği için barındırılan derleme aracıları kullanıyorsanız, bu aracıların seçilmesi önerilir.
includeSymbols
- Sembol paketi oluşturma
boolean
. İsteğe bağlı. olduğunda command = pack
kullanın. Varsayılan değer: false
.
Paketin kaynaklar ve simgeler içerdiğini belirtir. Dosyayla .nuspec
kullanıldığında, normal bir NuGet paket dosyası ve karşılık gelen semboller paketi oluşturulur.
toolPackage
- Araç Paketi
boolean
. İsteğe bağlı. olduğunda command = pack
kullanın. Varsayılan değer: false
.
Projenin çıkış dosyalarının araç klasöründe olup olmadığını belirler.
buildProperties
- Ek derleme özellikleri
string
. İsteğe bağlı. olduğunda command = pack
kullanın.
Dosyasındaki her oluşumun verilen değerle değiştirileceği noktalı virgülle ayrılmış token=value çiftlerinin $token$
.nuspec
listesini belirtir. Değerler, tırnak işaretleri içindeki dizeler olabilir.
basePath
- Temel yol
string
. İsteğe bağlı. olduğunda command = pack
kullanın.
Dosyada nuspec
tanımlanan dosyaların temel yolunu belirtir.
verbosityPack
- Ayrıntı
string
. İsteğe bağlı. olduğunda command = pack
kullanın. İzin verilen değerler: Quiet
, Normal
, Detailed
. Varsayılan değer: Detailed
.
Çıktıda görüntülenen ayrıntı miktarını belirtir.
arguments
- Komut ve bağımsız değişkenler
string
. olduğunda command = custom
gereklidir.
Yürütme için geçirilecek NuGet.exe
komutu ve bağımsız değişkenleri belirtir. NuGet 3.5 veya üzeri kullanılırsa, bu kuruluştaki veya koleksiyondaki Proje Koleksiyonu Derleme Hizmeti'nin erişimi olan herhangi bir akışa karşı , restore
ve publish
gibi list
kimliği doğrulanmış komutlar otomatik olarak doğrulanır.
Görev denetim seçenekleri
Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.
Çıkış değişkenleri
Yok.
Açıklamalar
Önemli
NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarında kimlik doğrulaması yapmak için önerilen yeni yoldur. Bu görev artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir.
NuGet paket bağımlılıklarını yüklemek ve güncelleştirmek ya da NuGet paketlerini paketleyip yayımlamak için bu görevi kullanın. NuGet.exe kullanır ve .NET Framework uygulamalarıyla çalışır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.
Kodunuz NuGet paketlerine bağlıysa bu adımı Visual Studio Derleme görevinizden önce eklediğinizden emin olun. Ayrıca, bu görevdeki kullanım dışı NuGet Paketlerini Geri Yükle onay kutusunun işaretini kaldırdığından emin olun.
.NET Core veya .NET Standard ile çalışıyorsanız, tüm paket senaryoları için tam desteğe sahip olan ve şu anda dotnet tarafından desteklenen .NET Core görevini kullanın.
İpucu
NuGet görevinin bu sürümü varsayılan olarak NuGet 4.1.0 kullanır. NuGet'in farklı bir sürümünü seçmek için Araç Yükleyicisi'ni kullanın.
Sürüm oluşturma düzenleri
byPrereleaseNumber için, sürüm ana sürüm, ikincil sürüm ve düzeltme eki için seçtiğiniz değerlere, ayrıca biçimindeki yyyymmdd-hhmmss
tarih ve saat değerine ayarlanır.
ByEnvVar için, sürüm versionEnvVar parametresi tarafından belirtilen ada sahip ortam değişkeninin değerine ayarlanır; örneğin MyVersion
(hayır$, yalnızca ortam değişkeni adı). Ortam değişkeninin veya 1.2.3-beta1
gibi uygun bir SemVer olarak 1.2.3
ayarlandığından emin olun.
byBuildNumber için sürüm, işlem hattı çalıştırmasının derleme numarası kullanılarak ayarlanır. Bu, işlem hattının name
ortam değişkenine kaydedilen BUILD_BUILDNUMBER
özelliği için belirtilen değerdir. Kullanılan derleme numarasının gibi 1.0.$(Rev:r)
uygun bir SemVer içerdiğinden emin olun. byBuildNumber kullanırken görev, 1.2.3.4
derleme numarası dizesinden noktalı sürümünü ayıklar ve yalnızca bu bölümü kullanır. Dizenin geri kalanı bırakılır. Derleme numarasını olduğu gibi kullanmak istiyorsanız, yukarıda açıklandığı gibi ByEnvVar'ı kullanabilir ve versionEnvVar'ı olarak BUILD_BUILDNUMBER
ayarlayabilirsiniz.
NuGetInstaller@0 veya NuGetRestore@1'dan geçiş
NuGetInstaller@0
ve NuGetRestore@1
kullanım dışıdır ve bunları işlem hattınızda ile NuGetCommand@2
değiştirmeniz gerekir.
ile restoreMode: restore
kullanıyorsanız NuGetInstaller@0
kullanırken aşağıdaki girişleri NuGetCommand@2
yapılandırın.
Görev girişini NuGetCommand@2 | Değer |
---|---|
command |
restore |
restoreSolution |
.sln dosyasının yolunu belirleme |
ile restoreMode: install
kullanıyorsanız NuGetInstaller@0
kullanırken aşağıdaki girişleri NuGetCommand@2
yapılandırın.
Görev girişini NuGetCommand@2 | Değer |
---|---|
command |
custom |
arguments |
Tam yükleme komutunun NuGet CLI'da nasıl görüneceği. Örneğin, işlem hattınızda eşdeğerini nuget install ninject -OutputDirectory c:\proj çalıştırmak istiyorsanız parametresi arguments olacaktır install ninject -OutputDirectory c:\proj . parametresini NuGetInstaller@0 nuGetRestoreArgs kullanıyorsanız, bu parametreler de içinde arguments yer alır. |
kullanıyorsanız NuGetRestore@1
kullanırken aşağıdaki girişleri NuGetCommand@2
yapılandırın.
Görev girişini NuGetCommand@2 | Değer |
---|---|
command |
restore |
restoreSolution |
.sln dosyasının yolunu belirleme |
veya NuGetRestore@1
NuGetInstaller@0
restore
seçeneğine benzer şekilde, akışı ayarlamak, NuGetCommand@2
veya config
arasında select
karar vermek, dosyanın yolunu belirtmek ve nuget.org paketlerini kullanmak için NuGet.config
girişleri vardır.
Daha fazla bilgi için aşağıdaki örneklere bakın.
Örnekler
Geri Yükleme
Seçili bir akıştan gelen paketlerle tüm çözümlerinizi geri yükleyin.
# 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'
Paket
Hedef klasörde bir NuGet paketi oluşturun.
# Package a project
- task: NuGetCommand@2
inputs:
command: 'pack'
packagesToPack: '**/*.csproj'
packDestination: '$(Build.ArtifactStagingDirectory)'
Gönder
Not
İşlem hattı yapıtları dizinine Pipeline.Workspace
ve klasik yayın işlem hatlarının dizinine System.ArtifactsDirectory
indirilir. packagesToPush
değeri sırasıyla veya $(System.ArtifactsDirectory)/**/*.nupkg
olarak ayarlanabilir$(Pipeline.Workspace)/**/*.nupkg
.
Paketi NuGet.config tanımlı bir akışa gönderme/yayımlama.
# Push a project - task: NuGetCommand@2 inputs: command: 'push' packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg' feedsToUse: 'config' nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
Paket gönderme/kuruluş kapsamlı akışına yayımlama
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-organization-scoped-feed'
Proje kapsamlı akışa paket gönderme/yayımlama
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-project/my-project-scoped-feed'
Paketi NuGet.org gönderme/yayımlama
# Push a project - task: NuGetCommand@2 inputs: command: 'push' feedsToUse: 'config' includeNugetOrg: 'true'
Özel
Varsayılan komutlardan başka herhangi bir NuGet komutunu çalıştırın: paketle, gönder ve geri yükle.
# list local NuGet resources.
- task: NuGetCommand@2
displayName: 'list locals'
inputs:
command: custom
arguments: 'locals all -list'
Gereksinimler
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme, Klasik sürüm |
Üzerinde çalıştırılır | Agent, DeploymentGroup |
Talep | Hiçbiri |
Özellikler | Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi biri |
Ayarlanabilir değişkenler | Herhangi biri |
Aracı sürümü | 2.144.0 veya üzeri |
Görev kategorisi | Paket |
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme, Klasik sürüm |
Üzerinde çalışır | Agent, DeploymentGroup |
Talep | Hiçbiri |
Özellikler | Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi biri |
Ayarlanabilir değişkenler | Herhangi biri |
Aracı sürümü | 2.115.0 veya üzeri |
Görev kategorisi | Paket |
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin