.NET Core uygulamalarını derleme, test etme ve dağıtma

Azure Pipelines oturum açın

Azure Pipelinesoturum açın. oturum açtıktan sonra, tarayıcınız öğesine gider https://dev.azure.com/my-organization-name ve Azure DevOps panonuzu görüntüler.

Seçtiğiniz kuruluş içinde bir Projeoluşturun. Kuruluşunuzda bir projeniz yoksa, başlamak için bir proje oluşturun ekranına bakabilirsiniz. aksi takdirde, panonun sağ üst köşesindeki oluştur Project düğmesini seçin.

1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

2. Pipelinesgidin ve yeni işlem hattı' nı seçin.

3. ilk olarak GitHub kaynak kodunuzun konumu olarak seçerek sihirbazın adımlarını gözden geçir.

4. oturum açmak için GitHub yönlendiriliyorsunuz. bu durumda GitHub kimlik bilgilerinizi girin.

5. Depo listesi göründüğünde, deponuzu seçin.

6. Azure Pipelines uygulamasını yüklemek için GitHub yönlendiriliyorsunuz. Öyleyse, yüklemeyi Onayla' yı seçin.

Yapılandır sekmesi göründüğünde ASP.NET Core' yi seçin.

1. Yeni ardışık düzen belirdiğinde, ne yaptığını görmek için YAML 'ye göz atın. Hazırsanız Kaydet ve Çalıştır' ı seçin.

   

2. Deponuza yeni bir Azure-Pipelines. yıml dosyası uygulamanız istenir. İletiden memnun olduktan sonra Kaydet ' i seçin ve yeniden çalıştırın .

   İşlem hattınızı eylem bölümünde izlemek isterseniz, yapı işini seçin.

   kodunuzun ASP.NET Core şablonu için iyi bir eşleşme görünmediğinden, sizin için otomatik olarak oluşturduğumuz bir işlem hattı oluşturdunuz ve çalıştırdınız.

   Artık, deponuzda özelleştirmeniz için hazır bir YAML işlem hattı ( azure-pipelines.yml ) çalışıyor!

3. işlem hattınızda değişiklik yapmaya hazırsanız, Pipelines sayfasında seçin ve sonra dosyayı düzenleyin .

4. İşlem hattınızı özelleştirmenin daha yaygın yöntemlerinden bazılarını öğrenmek için aşağıdaki bölümlere bakın.

YAML

1. azure-pipelines.ymlDeponuzda bir dosya ekleyin. Derlemeniz için bu kod parçacığını özelleştirin.

trigger:
- master

pool: Default

variables:
  buildConfiguration: 'Release'

# do this before all your .NET Core tasks
steps:
- task: DotNetCoreInstaller@2
  inputs:
    version: '2.2.402' # replace this value with the version that you need for your project
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

2. Bir işlem hattı oluşturun (nasıl olduğunu bilmiyorsanız, ilk işlem hattınızı oluşturma) ve şablon Için YAML' yi seçin.

3. İşlem hatlarınız için Aracı havuzunu ve YAML dosya yolunu ayarlayın.

4. İşlem hattını kaydedin ve bir derlemeyi kuyruğa alın. Derleme #nnnnnnnn. n sıraya alınmış ileti görüntülendiğinde, işlem hattınızı eylemde görmek için sayı bağlantısını seçin.

5. İşlem hattınızda değişiklik yapmaya hazırsanız, düzenleyin .

6. İşlem hattınızı özelleştirmenin daha yaygın yöntemlerinden bazılarını öğrenmek için aşağıdaki bölümlere bakın.

Klasik

1. İşlem hattı oluşturun (nasıl olduğunu bilmiyorsanız, bkz. ilk işlem hattınızı oluşturma). Şablon için boş Işlem hattı seçin.

2. Görev kataloğunda .NET Core görevini bulun ve ekleyin. Bu görev, dotnet build örnek depodaki kodu oluşturmak için çalıştırılır.

3. İşlem hattını kaydedin ve bir derlemeyi kuyruğa alın. Derleme #nnnnnnnn. n sıraya alınmış ileti görüntülendiğinde, işlem hattınızı eylemde görmek için sayı bağlantısını seçin.

   Artık özelleştirmeniz için hazır olan çalışır durumda bir işlem hattı var!

4. İşlem hattınızda değişiklik yapmaya hazırsanız, düzenleyin .

5. İşlem hattınızı özelleştirmenin daha yaygın yöntemlerinden bazılarını öğrenmek için aşağıdaki bölümlere bakın.

.net Core projelerinizi Windows, Linux veya macos üzerinde kendi altyapınızı ayarlamaya gerek kalmadan derlemek için Azure Pipelines kullanın. Azure Pipelines ' deki Microsoft tarafından barındırılan aracılar , .net Core sdk 'larının önceden yüklenmiş birkaç sürümünü içerir.

Ubuntu 18,04, YAML dosyasında ayarlanır.

pool:
  vmImage: 'ubuntu-18.04' # examples of other options: 'macOS-10.15', 'windows-2019'

Daha fazla örnek için bkz. görüntülerin ve havuzun tam listesi için Microsoft tarafından barındırılan aracılar .

Microsoft tarafından barındırılan aracılar .NET Core SDK eski sürümlerinden bazılarını içermez. Bunlar genellikle ön sürüm sürümlerini de içermez. Microsoft tarafından barındırılan aracılarda bu tür SDK 'lara ihtiyacınız varsa, UseDotNet@2 görevini YAML dosyanıza ekleyin.

.NET Core 3.0. x ' i hedefleyen testleri çalıştırmak için 5.0. x SDK 'sının, derleme ve 3.0. x için Önizleme sürümünü yüklemek için şu kod parçacığını ekleyin:

steps:
- task: UseDotNet@2
  inputs:
    version: '5.0.x'
    includePreviewVersions: true # Required for preview versions

- task: UseDotNet@2
  inputs:
    version: '3.0.x'
    packageType: runtime

Windows aracıları zaten bir .net Core çalışma zamanı içeriyor. Daha yeni bir SDK yüklemek için, performMultiLevelLookuptrue Bu kod parçacığında olarak ayarlayın:

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 5.0.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

Windows, Linux veya macos 'ta .NET Core SDK ve çalışma zamanını kullanarak .net Core projelerinizi oluşturabilirsiniz. Yapılarınız kendi kendine barındırılan bir aracıdaçalışır. Aracıda yüklü .NET Core SDK ve çalışma zamanının gerekli sürümüne sahip olduğunuzdan emin olun.

Azure Artifacts, NuGet. org veya başka bir dış ya da dahili NuGet deposundan NuGet paketlerini indirebilirsiniz. .net Core görevi, paketleri kimliği doğrulanmış NuGet akışlarından geri yüklemek için özellikle yararlıdır.

Bu işlem hattı dotnet restore , dotnet restorebir yapıt akışı kullanır.

trigger:
- master

pool:
  vmImage: 'windows-latest'

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-vsts-feed' # A series of numbers and letters

- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    arguments: '--configuration $(buildConfiguration)'
  displayName: 'dotnet build $(buildConfiguration)'

NuGet. org ' dan NuGet paketlerini indirebilirsiniz.

.NET Core SDK sürüm 2,0 ve daha yeni sürümlerde paketler, gibi diğer komutları çalıştırırken otomatik olarak geri yüklenir dotnet build .

.NET Core SDK sürüm 2,0 ve daha yeni sürümlerde paketler, gibi diğer komutları çalıştırırken otomatik olarak geri yüklenir dotnet build . Ancak, kimliği doğrulanmış bir akış kullanıyorsanız paketleri geri yüklemek için yine de .NET Core görevini kullanmanız gerekebilir.

bağlantı sorunları nedeniyle derlemeleriniz bazen NuGet. org 'dan geri yüklenirken başarısız olursa, yukarı akış kaynaklarıyla Azure Artifacts kullanabilir ve paketleri önbelleğe alabilirsiniz. Azure Artifacts bağlantı sırasında işlem hattının kimlik bilgileri otomatik olarak kullanılır. bu kimlik bilgileri genellikle Project koleksiyonu derleme hizmeti hesabından türetilir.

bir NuGet deposu belirtmek isterseniz, url 'leri NuGet.config deponuzdaki bir dosyaya koyun. akışlarınızın kimliği doğrulandıysa, Project Ayarlaraltındaki hizmetler sekmesinde bir NuGet hizmet bağlantısı oluşturarak kimlik bilgilerini yönetin.

Microsoft tarafından barındırılan aracılar kullanıyorsanız, her bir derlemeyi her çalıştırdığınızda yeni bir makine alırsınız, bu da paketleri her seferinde geri yükleme anlamına gelir. Bu geri yükleme işlemi, önemli miktarda zaman alabilir. bu sorunu gidermek için Azure Artifacts veya şirket içinde barındırılan bir aracı kullanabilirsiniz. bu durumda, paket önbelleğini kullanma avantajını elde edersiniz.

Paketleri dış özel akıştan geri yüklemek için .NET Core görevini kullanın:

# do this before your build tasks
steps:
- task: DotNetCoreCLI@2
  displayName: Restore
  inputs:
    command: restore
    projects: '**/*.csproj'
    feedsToUse: config
    nugetConfigPath: NuGet.config    # Relative to root of the repository
    externalFeedCredentials: <Name of the NuGet service connection>
# ...

NuGet hizmeti bağlantıları hakkında daha fazla bilgi için bkz. NuGet akışlara yayımlama.

1. İşlem hattındaki görevleri seçin. Yapı görevlerinizi çalıştıran işi seçin. Sonra + Bu işe yeni bir görev eklemeyi seçin.

2. Görev kataloğunda .NET Core görevini bulun ve ekleyin.

3. Görevi seçin ve komutiçin geri yükle' yi seçin.

4. Bu görev için gereken diğer seçenekleri belirtin. Sonra derlemeyi kaydedin.

Projenizi .NET Core görevini kullanarak derlemek için, dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml :

steps:
- task: DotNetCoreCLI@2
  displayName: Build
  inputs:
    command: build
    projects: '**/*.csproj'
    arguments: '--configuration $(buildConfiguration)' # Update this to match your need

İşlem hattınızda herhangi bir özel DotNet komutunu çalıştırabilirsiniz. Aşağıdaki örnekte, .NET küresel aracının nasıl yükleneceği ve kullanılacağı gösterilmektedir:

steps:
- task: DotNetCoreCLI@2
  displayName: 'Install dotnetsay'
  inputs:
    command: custom
    custom: tool
    arguments: 'install -g dotnetsay'

Derleme

1. İşlem hattındaki görevleri seçin. Yapı görevlerinizi çalıştıran işi seçin. Sonra + Bu işe yeni bir görev eklemeyi seçin.

2. Görev kataloğunda .NET Core görevini bulun ve ekleyin.

3. Görevi seçin ve komutiçin Oluştur veya Yayımla' yı seçin.

4. Bu görev için gereken diğer seçenekleri belirtin. Sonra derlemeyi kaydedin.

Araç yükler

Windows çalıştıran derlemede dotnetdeyin gibi bir .net Core küresel aracı yüklemek için aşağıdaki adımları uygulayın:

1. .NET Core görevini ekleyin ve aşağıdaki özellikleri ayarlayın:

   • Komut: özel.
     • Projelerin yolu: boş bırakın.
   • Özel komut: aracı.
   • Bağımsız değişkenler: .

2. Bir komut satırı görevi ekleyin ve aşağıdaki özellikleri ayarlayın:

   • Betik: .

Dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml :

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration)'

Diğer bir seçenek de dotnet test komutu belirli bir günlükçü ile çalıştırmak ve sonra dotnet test görevini kullanmaktır:

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx
- task: PublishTestResults@2
  condition: succeededOrFailed()
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

Testetmek için komut kümesini içeren .NET Core görevini kullanın. Projelerin yolu çözümünüzdeki test projelerine başvurmalıdır.

Dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml :

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration) --collect "Code coverage"'

Komutu çalıştırmayı seçerseniz dotnet test , test sonuçları günlükçüsü ve kapsam seçeneklerini belirtin. Ardından test sonuçları Yayımla görevini kullanın:

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx --collect "Code coverage"
- task: PublishTestResults@2
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

1. Yapı işinize .NET Core görevini ekleyin ve aşağıdaki özellikleri ayarlayın:

   • Komut: test.
   • Projelerin yolu: çözümünüzdeki test projelerine başvurmalıdır.
   • Bağımsız değişkenler: .

2. Test sonuçlarını yayımla seçeneğinin seçili olduğundan emin olun.

Yapıtları Azure Pipelines yayımlama

.NET derlemenizeait çıktıyı yayımlamak için

• dotnet publish --output $(Build.ArtifactStagingDirectory)CLI üzerinde çalıştırın veya Yayımla komutuyla DotNetCoreCLI@2 görevini ekleyin.
• Yapıtı yapıyı Yayımla görevini kullanarak yayımlayın.

Dosyanıza aşağıdaki kod parçacığını ekleyin azure-pipelines.yml :

steps:

- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

# this code takes all the files in $(Build.ArtifactStagingDirectory) and uploads them as an artifact of your build.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)' 
    artifactName: 'myWebsiteName'

Yayımlamadan önce, derleme dizinine daha fazla dosya kopyalamak için yardımcı program: dosyaları Kopyala' yı kullanın.

NuGet bir akışa yayımlama

bir NuGet paketi oluşturmak ve yayımlamak için aşağıdaki kod parçacığını ekleyin:

steps:
# ...
# do this near the end of your pipeline in most cases
- script: dotnet pack /p:PackageVersion=$(version)  # define version variable elsewhere in your pipeline
- task: NuGetAuthenticate@0
  input:
    nuGetServiceConnections: '<Name of the NuGet service connection>'
- task: NuGetCommand@2
  inputs:
    command: push
    nuGetFeedType: external
    publishFeedCredentials: '<Name of the NuGet service connection>'
    versioningScheme: byEnvVar
    versionEnvVar: version

NuGet paketlerini sürüm oluşturma ve yayımlama hakkında daha fazla bilgi için bkz. NuGet akışlara yayımlama.

Bir web uygulaması dağıtma

Bir Web uygulamasına yayımlamaya hazırlamış bir .zip dosya arşivi oluşturmak için aşağıdaki kod parçacığını ekleyin:

steps:
# ...
# do this after you've built your app, near the end of your pipeline in most cases
# for example, you do this before you deploy to an Azure web app on Windows
- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

Bu Arşivi bir Web uygulamasında yayımlamak için bkz. Azure Web Apps dağıtımı.

Yapıtları Azure Pipelines yayımlama

derlemenize ait çıktıyı Azure Pipelines veya TFS 'ye yayımlamak için yayımla Artifacts görevini kullanın.

NuGet bir akışa yayımlama

kodunuzu NuGet bir akışta yayınlamak istiyorsanız aşağıdaki adımları uygulayın:

1. Komut olarak ayarlanmış bir .NET Core görevi kullanın.

2. paketinizi NuGet bir akışa yayımlayın.

Bir web uygulaması dağıtma

1. Yayımlamak için komutuyla ayarlanan bir .NET Core görevi kullanın.

2. .zip dosya arşivi oluşturma seçeneğini seçtiğinizden emin olun.

3. Bu Arşivi bir Web uygulamasında yayımlamak için bkz. Azure Web Apps dağıtımı.

• Microsoft tarafından barındırılan aracılarda .NET Core SDK ön sürüm sürümlerini yüklemeiyoruz. .NET Core SDK yeni bir sürümü kullanıma sunulduktan sonra, Azure Pipelines üzerinde çalıştığı tüm veri merkezlerine bu kadar birkaç hafta sürebilir. Bu piyasaya çıkma işleminin bitmesini beklemeniz gerekmez. Microsoft tarafından barındırılan aracılarda .NET Core SDK istenen sürümünü yüklemek için, bu kılavuzda açıklanan .NET Core araç yükleyicisinikullanabilirsiniz.

Azure Pipelines yeni misiniz? Bu durumda, diğer bölümlere geçmeden önce bu bölümü denemeniz önerilir.