NuGet görev

Sürüm 2.

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

NuGet paket bağımlılıklarını yüklemek ve güncelleştirmek ya da NuGet paketlerini paketlemek ve yayımlamak için bu görevi kullanın. NuGet.exe kullanır ve .NET Framework uygulamalarla birlikte kullanılır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.

kodunuz NuGet paketlerine bağımlıysa, Visual Studio derleme adımınızaönce bu adımı eklediğinizden emin olun. ayrıca, bu adımdaki kullanım dışı geri yükleme NuGet paketleri onay kutusunu temizlediğinizden emin olun.

.NET Core veya .NET Standard ile çalışıyorsanız, tüm paket senaryoları için tam desteğe sahip .NET Core görevini kullanın ve şu anda DotNet tarafından desteklenmektedir.

# NuGet
# 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' # Options: restore, pack, push, custom
    #restoreSolution: '**/*.sln' # Required when command == Restore
    #feedsToUse: 'select' # Options: select, config
    #vstsFeed: # Required when feedsToUse == Select
    #includeNuGetOrg: true # Required when feedsToUse == Select
    #nugetConfigPath: # Required when feedsToUse == Config
    #externalFeedCredentials: # Optional
    #noCache: false 
    #disableParallelProcessing: false 
    restoreDirectory: 
    #verbosityRestore: 'Detailed' # Options: quiet, normal, detailed
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # Required when command == Push
    #nuGetFeedType: 'internal' # Required when command == Push# Options: internal, external
    #publishVstsFeed: # Required when command == Push && NuGetFeedType == Internal
    #publishPackageMetadata: true # Optional
    #allowPackageConflicts: # Optional
    #publishFeedCredentials: # Required when command == Push && NuGetFeedType == External
    #verbosityPush: 'Detailed' # Options: quiet, normal, detailed
    #packagesToPack: '**/*.csproj' # Required when command == Pack
    #configuration: '$(BuildConfiguration)' # Optional
    #packDestination: '$(Build.ArtifactStagingDirectory)' # Optional
    #versioningScheme: 'off' # Options: off, byPrereleaseNumber, byEnvVar, byBuildNumber
    #includeReferencedProjects: false # Optional
    #versionEnvVar: # Required when versioningScheme == ByEnvVar
    #majorVersion: '1' # Required when versioningScheme == ByPrereleaseNumber
    #minorVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #patchVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #packTimezone: 'utc' # Required when versioningScheme == ByPrereleaseNumber# Options: utc, local
    #includeSymbols: false # Optional
    #toolPackage: # Optional
    #buildProperties: # Optional
    #basePath: # Optional, specify path to nuspec files
    #verbosityPack: 'Detailed' # Options: quiet, normal, detailed
    #arguments: # Required when command == Custom

Bağımsız değişkenler

Örnekler

Geri Yükleme

Seçili akıştan paketlerle tüm çözümlerinizi geri yükleme.

# 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 NuGet bir paket oluşturun.

# Package a project
- task: NuGetCommand@2
  inputs:
    command: 'pack'
    packagesToPack: '**/*.csproj'
    packDestination: '$(Build.ArtifactStagingDirectory)'

Gönder

• Paketi uygulama uygulamanız içinde tanımlanan bir akışa NuGet.config.

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

• Kapsamlı bir projeye paket itme/yayımlama

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      feedsToUse: 'select'
      vstsFeed: 'my-project/my-project-scoped-feed'
      publishVstsFeed: 'myTestFeed'
  

• NuGet.org'a paket gönderin/yayımlayın

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      feedsToUse: 'config'
      includeNugetOrg: 'true'
  

Özel

Varsayılan komutlardan NuGet diğer tüm komutlarını çalıştırın: pack, push ve restore.

# list local NuGet resources.
- task: NuGetCommand@2
  displayName: 'list locals'
  inputs:
    command: custom
    arguments: 'locals all -list'

Açık kaynak

üzerinde Azure Pipelines Team Foundation Server görevlere göz GitHub. Geri bildirim ve katkılar açıktır.

SSS

Neden bir NuGet.Config?

Bir NuGet.Config denetimine denetim, projenizi ve paketlerinin konumunu oluşturmak için gereken önemli bir bilgi parçasının kodunuzu kontrol eden her geliştirici tarafından kullanılabilir olması sağlar.

Ancak, bir geliştirici ekibinin çok çeşitli projelerde çalıştığını durumlarda, her geliştiricinin makinesine genel Azure Artifacts akışına NuGet.Config akışı eklemek de mümkündür. Bu gibi durumlarda, görevdeki "Burada seçerim akışlar" seçeneğini NuGet bu yapılandırmayı çoğaltır.

Bu konuda nereden Azure Artifacts?

Azure Artifacts Belgeleri

Bu konuda nereden daha fazla bilgi NuGet?

NuGet Belgelerine Genel Bakış

NuGet Oluşturma ve yayımlama

NuGet bağımlılıkları almak için çözüm ayarlamayı kullanın

Başka ne tür uygulamalar derlerim?

Uygulama örneklerinizi derleme ve dağıtma

Başka ne tür derleme görevleri kullanılabilir?

Derleme ve sürüm görevleri kataloğu

Kod tabanımızı derleme sonlarından nasıl koruyabiliriz?

• Git: Bir dala birleştirimeden önce kodun derlemelerini gerektirme seçeneğiyle dal ilkeleriyle kod kalitesini geliştirin. Daha GitHub için, dallar altında GitHub depo ayarlarında benzer ilkeler kullanılabilir.

• TFVC: Geçitli iade etme kullanın.

Nasıl yaparım? işlem hattımda diğer bölümleri mi değiştirtsin?

• Testleri, betikleri ve çok çeşitli diğer işlemleri çalıştırmak için görevleri derleme ve serbest bırakma.

• Tamamlanan derlemelerin nasıl adlandırılmış olduğunu belirtme, birden çok yapılandırma oluşturma ve hata durumunda iş öğeleri oluşturma gibi derleme seçeneklerini belirtin.

• Derlemenin kaynağını seçmek ve aracı çalışma alanının nasıl temizlenmeleri gibi seçenekleri değiştirmek için desteklenen kaynak depolar.

• CI derlemelerinizi çalıştırma ve zamanlanmış derlemeleri belirtme için derleme tetikleyicilerini ayarlayın.

• Eski derlemeleri otomatik olarak silmek için derleme saklama ilkelerini belirtin.

Paralel çoklu yapılandırmayı seçtim ama aynı anda yalnızca bir derleme çalışıyor.

Daha fazla paralel Azure Pipelines ihtiyacınız olabilir. Bkz. içinde paralel Azure Pipelines.

Nasıl yaparım? işlem hattımda neler değişti?

Derleme işlem hattınızı değiştirme geçmişini görüntüleme

Bir aracıya ihtiyacım var mı?

Derlemenizi veya yayınını çalıştırmak için en az bir aracı gerekir.

Sorunlarımız var. Bunları nasıl gidererim?

Bkz. Derleme ve Sürüm Sorunlarını Giderme.

Varsayılan aracı havuzunu seçe değilim ve derlememi veya sürümümi kuyruğa ala bilmiyorum. Nasıl yaparım? düzeltebilir misiniz?

Bkz. Aracı havuzları.

My NuGet görev şu hatayla başarısız oluyor: "Hata: yerel sertifikayı verdiremiyor". Bunu nasıl düzeltebilirim?

Bu, güvenilen bir kök sertifika ekerek düzeltilmiştir. Ortam değişkenini derleme NODE_EXTRA_CA_CERTS=file aracınıza ekleyebilir veya görev değişkenini işlem NODE.EXTRA.CA.CERTS=file hattınıza ebilirsiniz. Bu Node.js hakkında daha fazla bilgi için bkz.Node.js belgeleri. İşlem hattınıza değişken ayarlama hakkında yönergeler için bkz. İşlem hattında değişken ayarlama.

İşlem Hattım'ın farklı bir projede yer alan akışa erişmesi gerekiyor

İşlem hattı akışı barındıran projeden farklı bir projede çalışıyorsa, derleme hizmetine okuma/yazma erişimi vermek için diğer projeyi kurmanız gerekir. Diğer ayrıntılar için bkz. Azure Pipelines paket izinleri.