.NET Core CLI görevi

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

Azure Pipelines

Dotnet uygulaması derlemek, test etmek, paketle veya yayımlamak ya da özel bir dotnet komutu çalıştırmak için bu görevi kullanın. Paket komutları için bu görev NuGet.org ve Paket Yönetimi ve MyGet gibi Paket Yönetimi akışları destekler.

.NET Core veya .NET Standard derlemeniz NuGet paketlerine bağlı ise, bu adımın iki kopyasını ekleyin: biri komutuyla, biri restorebuild komutuyla.

# .NET Core
# Build, test, package, or publish a dotnet application, or run a custom dotnet command
- task: DotNetCoreCLI@2
  inputs:
    #command: 'build' # Options: build, push, pack, publish, restore, run, test, custom
    #publishWebProjects: true # Required when command == Publish
    #projects: # Optional
    #custom: # Required when command == Custom
    #arguments: # Optional
    #publishTestResults: true # Optional
    #testRunTitle: # Optional
    #zipAfterPublish: true # Optional
    #modifyOutputPath: true # Optional
    #feedsToUse: 'select' # Options: select, config
    #vstsFeed: # Required when feedsToUse == Select
    #feedRestore: # Required when command == restore. projectName/feedName for project-scoped feed. FeedName only for organization-scoped feed.
    #includeNuGetOrg: true # Required when feedsToUse == Select
    #nugetConfigPath: # Required when feedsToUse == Config
    #externalFeedCredentials: # Optional
    #noCache: false
    restoreDirectory:
    #restoreArguments: # Optional
    #verbosityRestore: 'Detailed' # Options: -, quiet, minimal, normal, detailed, diagnostic
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # Required when command == Push
    #nuGetFeedType: 'internal' # Required when command == Push# Options: internal, external
    #publishVstsFeed: # Required when command == Push && NuGetFeedType == Internal
    #publishPackageMetadata: true # Optional
    #publishFeedCredentials: # Required when command == Push && NuGetFeedType == External
    #packagesToPack: '**/*.csproj' # Required when command == Pack
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # Optional
    #nobuild: false # Optional
    #includesymbols: false # Optional
    #includesource: false # Optional
    #versioningScheme: 'off' # Options: off, byPrereleaseNumber, byEnvVar, byBuildNumber
    #versionEnvVar: # Required when versioningScheme == byEnvVar
    #majorVersion: '1' # Required when versioningScheme == ByPrereleaseNumber
    #minorVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #patchVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #buildProperties: # Optional
    #verbosityPack: 'Detailed' # Options: -, quiet, minimal, normal, detailed, diagnostic
    workingDirectory:

Bağımsız değişkenler

Görev denetimi seçenekleri

Örnekler

Derleme

Proje oluşturma

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'

Birden Çok Proje Derleme

# Build multiple projects
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: |
      src/proj1/proj1.csproj 
      src/proj2/proj2.csproj 
      src/other/other.sln    # Pass a solution instead of a csproj.

Gönder

İç NuGet paketlerini anından itme

# Push non test NuGet packages from a build to internal organization Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    searchPatternPush: '$(Build.ArtifactStagingDirectory)/*.nupkg;!$(Build.ArtifactStagingDirectory)/*.Tests.nupkg'
    feedPublish: 'FabrikamFeed'

Dış NuGet paketlerini anından dışa doğru itme

# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    nugetFeedType: 'external'
    externalEndPoint: 'MyNuGetServiceConnection'

Paketi

NuGetPackage'i belirli bir çıkış dizinine paketleme

# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'

Sembol Paketi Paketleme

# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    includesymbols: true

Yayımlama

Projeleri belirtilen klasöre yayımlama

# Publish projects to specified folder.
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
    zipAfterPublish: true
    modifyOutputPath: true

Geri Yükleme

#Restore packages with the .NET Core CLI task
- task: DotNetCoreCLI@2
  displayName: 'dotnet restore'
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    feedRestore: 'projectName/feedName'
    projects: '**/*.csproj'
    includeNuGetOrg: true

Test etme

Depoda testleri çalıştırma

# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
  inputs:
    command: 'test'

SSS

Derleme, yayımlama veya test adımım paketleri geri yükleyememe neden başarısız oluyor?

, dotnet ve gibi buildpublish komutların çoğu örtülü bir adım testrestore içerir. Önceki adım, kullandığı kimlik bilgilerini temizlemiş olduğundan, önceki adımda başarılı bir şekilde çalışmanız bile kimliği doğrulanmış akışlarda dotnet restore başarısız olur.

Bu sorunu düzeltmek için Bağımsız --no-restore Değişkenler metin kutusuna bayrağını ekleyin.

Buna ek olarak, komut veya bağımsız değişkenlerini ve bu şekilde belirtilen akışları tanımaz, örtülü adım NuGet.config oluşturulan testfeedRestorevstsFeed dosyaya restore dahil olmaz. Paketleri geri yüklemek için açık dotnet restore bir adımın kullanılması önerilir. komutu restore ve bağımsız feedRestorevstsFeed değişkenlerini saygıyla karşılar.

Neden bir NuGet.config?

Bir NuGet.config denetimine denetim, projenizi oluşturmak için gereken önemli bir bilgi parçasının, paketlerin konumu olan 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 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.

Sorun giderme

Çıktı dosyaları için dosya yapısı önceki derlemelerden farklıdır

Azure DevOps barındırılan aracılar .NET Core 3.0, 2.1 ve 2.2 ile yapılandırılır. .NET Core 3.0 için CLI, çıkış klasörü bağımsız değişken kullanarak projeleri yayımlarken farklı bir davranışa sahip. Projeleri çıkış klasörü bağımsız değişkeni (-o) ile yayımlarken, çıkış klasörü proje dosyasının dizininde değil kök dizinde oluşturulur. Bu nedenle birden fazla proje yayımlanırken tüm dosyalar aynı dizinde yayımlanır ve bu da soruna neden olur.

Bu sorunu çözmek için Add project name to publish path parametresini (YAML'de modifyOutputPath) .NET Core CLI kullanın. Bu, çıkış klasörünün içinde proje dosyasının adıyla bir alt klasör oluşturur. Bu nedenle tüm projeleriniz ana çıkış klasörünün içindeki farklı alt klasörler altında yayımlanır.

steps:
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: publish
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o testpath'
    zipAfterPublish: false
    modifyOutputPath: true

Project kullanan Entity Framework Barındırılan Aracılar üzerinde çalışmayı durdurdu

En son .NET Core: 3.0'da yerleşik Entity Framework (EF) yok. Yürütmeye başlamadan önce EF'yi yüklemeniz veya gerekli sürümle birlikte projeye global.json .NET Core SDK gerekir. Bu, EF projesi derlemek için doğru SDK'nın kullanılır. Gerekli sürüm makinede yoksa, gerekli sürümü yüklemek için işlem hattınıza UseDotNetV2 görevini ekleyin. .NET Core 3.0 ile EF hakkında daha fazla bilgi

Açık Kaynak

Bu görev, üzerinde açık kaynak GitHub. Geri bildirim ve katkılar açıktır.