NuGetCommand@2 - NuGet v2 görevi

  • Makale

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 uygulamalarıyla çalışır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.

Sözdizimi

# 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.

Giriş

command - Komut
string. Gerekli. İzin verilen değerler: restore, pack, push, custom. Varsayılan değer: restore.

Çalıştırılacak NuGet komutunu belirtir. Bağımsız değişken eklemek veya farklı bir komut kullanmak için custom değerini kullanın.


Çözüm yolu, packages.configveya project.json
Giriş diğer adı: solution. string. command = restoregerekir. Varsayılan değer: **/*.sln.

Geri yüklenecek paketlere başvuran çözüm, packages.configveya project.json dosyasının yolunu belirtir.


kullanmak için Akışları
Giriş diğer adı: selectOrConfig. string. command = restoregerekir. İzin verilen değerler: select (Burada seçtiğim akışlar), config (NuGet.configakışlarım). Varsayılan değer: select.

Görevin select değeriyle kullanılması için Azure Artifacts'ten ve/veya NuGet.org bir akışı belirtir. Alternatif olarak, kaynak kod deponuza bir NuGet.config dosyası işleyebilir ve config değerini kullanarak yolunu değer olarak ayarlayabilirsiniz.


vstsFeed - Bu Azure Artifacts/TFS akışındaki paketleri kullanın. Açılan listeden seçin veya [proje adı/]akış adı girin.
Giriş diğer adı: feedRestore. string. Opsiyonel. selectOrConfig = select && command = restoreolduğunda kullanın.

Oluşturulan NuGet.configseçili akışı belirtir. Burada bir akış belirtmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.


vstsFeed - Bu Azure Artifacts/TFS akışındaki paketleri kullan
Giriş diğer adı: feedRestore. string. Opsiyonel. selectOrConfig = select && command = restoreolduğunda kullanın.

Oluşturulan NuGet.configseç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. Opsiyonel. selectOrConfig = select && command = restoreolduğunda kullanın. Varsayılan değer: true.

Oluşturulan NuGet.configNuGet.org içerir.


NuGet.config yolunu
string. Opsiyonel. selectOrConfig = config && command = restoreolduğunda kullanın.

Deponuzda paketlerin geri yükleneceği akışları belirleyen NuGet.config yolunu belirtir.


Bu kuruluş/koleksiyon dışındaki akışlar için kimlik bilgilerini
Giriş diğer adı: externalEndpoints. string. Opsiyonel. selectOrConfig = config && command = restoreolduğunda kullanın.

Seçili NuGet.configbulunan 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.


Bu hesap/koleksiyon dışındaki akışlar için kimlik bilgilerini
Giriş diğer adı: externalEndpoints. string. Opsiyonel. selectOrConfig = config && command = restoreolduğunda kullanın.

Seçili NuGet.configbulunan 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 önbellek devre dışı bırak
boolean. Opsiyonel. command = restoreolduğunda kullanın. Varsayılan değer: false.

trueolarak ayarlandığında NuGet'in yerel makine önbelleklerinden gelen paketleri kullanmasını engeller.


disableParallelProcessing - Paralel işlemeyi devre dışı bırakma
boolean. Opsiyonel. command = restoreolduğunda kullanın. Varsayılan değer: false.

trueolarak ayarlandığında NuGet'in paralel işlemlerde birden çok paket yüklemesini engeller.


hedef dizin
Giriş diğer adı: packagesDirectory. string. Opsiyonel. command = restoreolduğunda kullanın.

Paketlerin yüklendiği klasörü belirtir. Hiçbir klasör belirtilmezse paketler seçili çözümle birlikte packages/ klasörüne geri yüklenir, packages.configveya project.json.


verbosityRestore - Ayrıntı
string. Opsiyonel. command = restoreolduğunda 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.


yayımlamak için NuGet paketlerinin yolunu
Giriş diğer adı: searchPatternPush. string. command = pushgerekir. Varsayılan değer: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Eşleştirilecek deseni veya karşıya yüklenecek nupkg dosyalarının yolunu belirtir. Birden çok desen noktalı virgülle ayrılabilir.


nuGetFeedType - Hedef akış konumu
string. command = pushgerekir. İ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. command = pushgerekir. İ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.


hedef akışı
Giriş diğer adı: feedPublish. string. command = push && nuGetFeedType = internalgerekir.

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. Opsiyonel. command = push && nuGetFeedType = internal && command = pusholduğunda kullanın. Varsayılan değer: true.

Sürekli yayımlanan paketler kümesi içinde değiştirilen paketlerin alt kümesinin sürüm numarasını değiştirir.


allowPackageConflicts - Yinelemelerin atlanmasına izin ver
boolean. Opsiyonel. command = push && nuGetFeedType = internalolduğunda kullanın. Varsayılan değer: false.

Bazı paketleriniz 409 Çakışma hataları ile 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. NuGet.exe çakışmayla karşılaşırsa 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.


NuGet sunucusu
Giriş diğer adı: externalEndpoint. string. command = push && nuGetFeedType = externalgerekir.

Dış NuGet sunucusunun kimlik bilgilerini içeren NuGet hizmet bağlantısını belirtir.


verbosityPush - Ayrıntı
string. Opsiyonel. command = pusholduğunda 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.


paketlemek için csproj veya nuspec dosyalarının yolunu
Giriş diğer adı: searchPatternPack. string. command = packgerekir. Varsayılan değer: **/*.csproj.

Görevin paketlenmesi gereken csproj dizinlerini aramak için kullandığı deseni belirtir.

Birden çok deseni noktalı virgülle ayırabilir ve !önekini ekleyerek negatif bir desen oluşturabilirsiniz. Örnek: **\*.csproj;!**\*.Tests.csproj.


paketlemek için yapılandırmayı
Giriş diğer adı: configurationToPack. string. Opsiyonel. command = packolduğunda kullanın. Varsayılan değer: $(BuildConfiguration).

Csproj dosyası kullanılırken paketlenecek yapılandırmayı belirtir.


Paket klasörü
Giriş diğer adı: outputDir. string. Opsiyonel. command = packolduğunda 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. command = packgerekir. İ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 includeReferencedProjectsile kullanılamaz. İzin verilen değerler şunlardır:

  • byPrereleaseNumber - Tarih ve saatkullanın: Görev, X, Y ve Z değerlerini belirttiğiniz X.Y.Z-ci-datetimeolarak biçimlendirilmiş SemVeruyumlu bir sürüm oluşturur.
  • 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, paketi sürüme eklemek için derleme numarasını kullanır.

Not

Genel'in altında derleme biçimini $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)olarak ayarlayın.


includeReferencedProjects - Başvuruda bulunılan projeleri dahil
boolean. Opsiyonel. versioningScheme = off && command = packolduğunda 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 projenin, projeyle aynı ada sahip karşılık gelen bir nuspec dosyası varsa, bu 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 kullanarak hakkında daha fazla bilgi edinin.


versionEnvVar - Ortam değişkeni
string. versioningScheme = byEnvVar && command = packgerekir.

$, $envveya %olmadan değişken adını belirtir.


majorVersion - Ana
Giriş diğer adı: requestedMajorVersion. string. versioningScheme = byPrereleaseNumber && command = packgerekir. Varsayılan değer: 1.

X.Y.Zsürümündeki .


minorVersion - İkincil
Giriş diğer adı: requestedMinorVersion. string. versioningScheme = byPrereleaseNumber && command = packgerekir. Varsayılan değer: 0.

X.Y.Zsürümündeki .


patchVersion - Düzeltme Eki
Giriş diğer adı: requestedPatchVersion. string. versioningScheme = byPrereleaseNumber && command = packgerekir. Varsayılan değer: 0.

X.Y.Zsürümündeki .


packTimezone - Saat dilimi
string. Opsiyonel. versioningScheme = byPrereleaseNumber && command = packolduğunda 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. Barındırılan derleme aracıları kullanıyorsanız tarih ve saat farklı olabileceği için utc seçmeniz önerilir.


includeSymbols - Simge oluşturma paketi
boolean. Opsiyonel. command = packolduğunda kullanın. Varsayılan değer: false.

Paketin kaynaklar ve simgeler içerdiğini belirtir. bir .nuspec dosyasıyla kullanıldığında, bu normal bir NuGet paket dosyası ve karşılık gelen semboller paketini oluşturur.


toolPackage - Araç Paketi
boolean. Opsiyonel. command = packolduğunda 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. Opsiyonel. command = packolduğunda kullanın.

.nuspec dosyasındaki her $token$ oluşumunun verilen değerle değiştirileceği noktalı virgülle ayrılmış token=value çiftlerinin listesini belirtir. Değerler, tırnak işaretleri içindeki dizeler olabilir.


basePath - Temel yol
string. Opsiyonel. command = packolduğunda kullanın.

nuspec dosyasında tanımlanan dosyaların temel yolunu belirtir.


verbosityPack - Ayrıntı
string. Opsiyonel. command = packolduğunda 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 - Komutu ve bağımsız değişkenleri
string. command = customgerekir.

Yürütme için NuGet.exe geçirilecek komutu ve bağımsız değişkenleri belirtir. NuGet 3.5 veya üzeri kullanılırsa, list, restoreve Bu kuruluştaki veya koleksiyondaki Proje Koleksiyonu Derleme Hizmeti'nin erişimi olan herhangi bir akışa karşı publish gibi kimliği doğrulanmış komutların kimliği otomatik olarak doğrulanır.


Görev denetimi seçenekleri

Tüm görevlerin, 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

Hiç kimse.

Açıklamalar

Önemli

NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarıyla 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ükleyip güncelleştirmek veya 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, Visual Studio Derleme göreviönce bu adımı eklediğinizden emin olun. Ayrıca, bu görevdeki NuGet Paketlerini Geri Yükle kullanım dışı bırakılan onay kutusunu temizlediğinden 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.

Bahşiş

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ükleyicisikullanın.

Sürüm oluşturma düzenleri

PrereleaseNumbertarafından 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çiminde tarih ve saat olarak ayarlanır.

Tarafından EnvVarsürümü, versionEnvVar parametresi tarafından belirtilen ada sahip ortam değişkeninin değerine ayarlanır; örneğin, MyVersion ($yok, yalnızca ortam değişkeni adı). Ortam değişkeninin 1.2.3 veya 1.2.3-beta1gibi uygun bir SemVer olarak ayarlandığından emin olun.

byBuildNumberiçin, sürüm işlem hattı çalıştırmasının derleme numarası kullanılarak ayarlanır. Bu, işlem hattının BUILD_BUILDNUMBER ortam değişkenine kaydedilen name özelliği için belirtilen değerdir). Kullanılan derleme numarasının 1.0.$(Rev:r)gibi düzgün bir SemVer içerdiğinden emin olun. byBuildNumberkullanırken, görev derleme numarası dizesinden 1.2.3.4noktalı sürümü 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 EnvVar kullanabilir ve versionEnvVarBUILD_BUILDNUMBERolarak 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 NuGetCommand@2ile değiştirmeniz gerekir.

restoreMode: restoreile NuGetInstaller@0 kullanıyorsanız, NuGetCommand@2kullanırken aşağıdaki girişleri yapılandırın.

Görev girişini NuGetCommand@2 Değer
command restore
restoreSolution .sln dosyasının yolunu belirleme

restoreMode: installile NuGetInstaller@0 kullanıyorsanız, NuGetCommand@2kullanırken aşağıdaki girişleri yapılandırın.

Görev girişini NuGetCommand@2 Değer
command custom
arguments NuGet CLI'da tam yükleme komutunun nasıl görüneceği. Örneğin, işlem hattınızda nuget install ninject -OutputDirectory c:\proj eşdeğerini çalıştırmak istiyorsanız, arguments parametresi install ninject -OutputDirectory c:\projolacaktır. NuGetInstaller@0 nuGetRestoreArgs parametresini kullandıysanız, bu parametreler artık argumentsbölümüne de gider.

NuGetRestore@1kullanıyorsanız, NuGetCommand@2kullanırken aşağıdaki girişleri yapılandırın.

Görev girişini NuGetCommand@2 Değer
command restore
restoreSolution .sln dosyasının yolunu belirleme

NuGetRestore@1 veya NuGetInstaller@0restore seçeneğini kullanmaya benzer şekilde, NuGetCommand@2 akışı ayarlamak, select veya configarasında karar vermek, NuGet.config dosyasının yolunu belirtmek ve nuget.org paketlerini kullanmak için girişleri vardır.

Daha fazla bilgi içinaşağıdaki örneklerine bakın.

Örnekler

Geri yüklemek

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)'

İtmek

Not

İşlem hattı yapıtları Pipeline.Workspace dizinine ve klasik yayın işlem hatları için System.ArtifactsDirectory dizinine indirilir. packagesToPush değer sırasıyla $(Pipeline.Workspace)/**/*.nupkg veya $(System.ArtifactsDirectory)/**/*.nupkg olarak ayarlanabilir.

  • NuGet.config'nizde tanımlanan bir akışa paket gönderme/yayımlama.

    # Push a project
- task: NuGetCommand@2
  inputs:
    command: 'push'
    packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
    feedsToUse: 'config'
    nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'

  • Bir paketi kuruluş kapsamlı akışına gönderme/yayımlama

    # Push a project
- task: NuGetCommand@2
  inputs:
    command: 'push'
    nuGetFeedType: 'internal'
    publishVstsFeed: 'my-organization-scoped-feed'

  • Proje kapsamlı bir 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'

Töre

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'

Gereksinim -leri

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talepleri Hiç kimse
Özellikleri Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Herhangi
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
Talepleri Hiç kimse
Özellikleri Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Herhangi
Aracı sürümü 2.115.0 veya üzeri
Görev kategorisi Paket