UseDotNet@2 - dotnet v2 görevini kullanma

İnternet'ten veya yerel önbellekten .NET Core SDK'sının belirli bir sürümünü almak ve PATH'e eklemek için bu görevi kullanın. Sonraki görevlerde kullanılan .NET Core sürümünü değiştirmek için bu görevi kullanın. Bu görev ayrıca ara sunucu desteği sağlar.

Sözdizimi

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.
# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.
# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.
# Use dotnet v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #version: # string. Version. 
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Giriş

yüklenecek paketi
string. İzin verilen değerler: runtime, sdk (SDK (çalışma zamanı içerir)). Varsayılan değer: sdk.

Yalnızca .NET çalışma zamanının mı yoksa SDK'nın mı yükleneceğini belirtir.


useGlobalJson - Genel json kullanma
boolean. Opsiyonel. packageType = sdkolduğunda kullanın. Varsayılan değer: false.

global.json dosyalardan tüm SDK'ları yükler. Bu dosyalar system.DefaultWorkingDirectoryaranıyor. Çalışma dizini girişini ayarlayarak arama kök yolunu değiştirebilirsiniz.

6.x girişinde açıklanan 6.1.x ve .x biçimi (joker karakter olarak UseDotNet@2.version kullanarak) versionsdk.version parametresinde değil, görevdeki global.json girişinde kullanılır.

##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. gibi bir hata iletisi alırsanız ve global.jsonkullanıyorsanız, sdk.versioniçindeki global.json denetleyin.

global.jsonhakkında daha fazla bilgi için bkz. kullanmak için .NET sürümünü seçme.


çalışma dizini
string. Opsiyonel. useGlobalJson = trueolduğunda kullanın.

global.jsonkullanılırken useGlobalJson dosyalarının aranacağı yolu belirtir. Değer boşsa, system.DefaultWorkingDirectory kök yol olarak kabul edilir.


version - Sürüm
string. Opsiyonel. useGlobalJson = false || packageType = runtimeolduğunda kullanın.

Yüklenecek .NET Core SDK veya çalışma zamanının sürümünü belirtir. Sürüm değeri biçimleri örneklerle gösterilir:

  • 2.x: Belirtilen ana sürüme sahip en son SDK'yı veya çalışma zamanını 2yükler.
  • 3.1.x: belirtilen ana ve ikincil sürümler 3 ve 1ile en son SDK'yı veya çalışma zamanını yükler.
  • 3.1.402: belirtilen SDK veya çalışma zamanı sürümünü 3.1.402yükler.

SDK veya çalışma zamanı yüklemelerinin sürüm değerleri releases.json dosyasındadır. Birincil/ikincil sürümün releases.json bağlantısı releases-index dosyasındadır. Örneğin, sürüm 3.1 için releases.json dosyasının bağlantısı.


version - Sürüm
string.

Yüklenecek .NET Core SDK veya çalışma zamanının sürümünü belirtir. Sürüm değeri biçimleri örneklerle gösterilir:

  • 2.x: Belirtilen ana sürüme sahip en son SDK'yı veya çalışma zamanını 2yükler.
  • 3.1.x: belirtilen ana ve ikincil sürümler 3 ve 1ile en son SDK'yı veya çalışma zamanını yükler.
  • 3.1.402: belirtilen SDK veya çalışma zamanı sürümünü 3.1.402yükler.

SDK veya çalışma zamanı yüklemelerinin sürüm değerleri releases.json dosyasındadır. Birincil/ikincil sürümün releases.json bağlantısı releases-index dosyasındadır. Örneğin, sürüm 3.1 için releases.json dosyasının bağlantısı.


vsVersion - Uyumlu Visual Studio sürümü
string.

İlgili .NET Core SDK yüklemesi için uyumlu bir Visual Studio sürümü belirtir. Değer, ana sürüm, ikincil sürüm ve düzeltme eki numarası içeren 16.6.4gibi eksiksiz bir sürüm numarası olmalıdır.

version dizesi için kullanılan SDK veya çalışma zamanı yüklemelerinin sürüm değerleri releases.json dosyasındadır. Birincil/ikincil sürümün releases.json bağlantısı releases-index dosyasındadır. Örneğin, sürüm 3.1 için releases.json dosyasının bağlantısı.


önizleme sürümlerini dahil
boolean. Opsiyonel. useGlobalJson = false || packageType = runtimeolduğunda kullanın. Varsayılan değer: false.

trueolarak ayarlanırsa, görev en son çalışma zamanı/SDK sürümlerini ararken 2.2.x veya 3.1.xarama gibi önizleme sürümlerini içerir. 3.0.100-preview3-010431gibi tam bir sürüm belirtirseniz bu ayar yoksayılır.


önizleme sürümlerini dahil
boolean. Varsayılan değer: false.

trueolarak ayarlanırsa, görev en son çalışma zamanı/SDK sürümlerini ararken 2.2.x veya 3.1.xarama gibi önizleme sürümlerini içerir. 3.0.100-preview3-010431gibi tam bir sürüm belirtirseniz bu ayar yoksayılır.


.Net Core Yüklemek için Yolu
string. Varsayılan değer: $(Agent.ToolsDirectory)/dotnet.

.NET Core SDK/Runtime'ın nereye yüklenmesi gerektiğini belirtir. Farklı yolların üzerinde aşağıdaki etkisi olabilir. NET'in davranışı.

  • $(Agent.ToolsDirectory): Bu dizin işlem hatlarında temizlenmediği için bu yol kullanıldığında aracıda yükleme önbelleğe alınır. Aracıda çalışan tüm işlem hatlarının önceden yüklenmiş sürümlere erişimi vardır.
  • $(Agent.TempDirectory): Bu yol kullanıldığında, her işlem hattından sonra bu klasör temizlendiğinden işlem hattının önbelleğe alınmış bir .NET Core sürümünü kullanmamasını sağlar.
  • Başka bir yol: Aracı işleminin yola erişimi varsa herhangi bir yolu kullanabilirsiniz. Bu, makinenin durumunu değiştirir ve üzerinde çalışan tüm işlemleri etkiler.

Not

.NET ana bilgisayarının sürümleri nasıl arayabileceğini yapılandırmak için performMultiLevelLookup ayarını kullanabilirsiniz.


performMultiLevelLookup - Çok Düzeyli Arama Gerçekleştirme
boolean. Varsayılan değer: false.

Uygun bir paylaşılan çerçeveyi ararken .NET konak işleminin davranışını yapılandırılır. Değerler şunlardır:

  • false: Konak işlemi yalnızca görev tarafından belirtilen klasörde bulunan sürümleri arar.
  • true: Konak işlemi, çok düzeyli aramayı kullanarak önceden tanımlanmış genel konumlarda arama yapacaktır. Varsayılan genel konumlar şunlardır:
    • C:\Program Files\dotnet (64 bit işlemler)
    • C:\Program Files (x86)\dotnet (32 bit işlemler)

çok düzeyli SharedFX aramahakkında daha fazla bilgi edinin.

Not

performMultiLevelLookup yalnızca Windows tabanlı aracılar için geçerlidir.


requestTimeout - Paket indirme isteği için zaman aşımı ayarlama
string. Varsayılan değer: 300000.

Görevin .NET paketini almak için yaptığı HTTP istekleri için bir zaman aşımı değeri sağlayın. Değer milisaniye cinsindendir. Varsayılan değer 300000 milisaniyedir (5 dakika). 600000 milisaniyeden (10 dakika) uzun olamaz.


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

.NET Core Kullan görevi, İnternet'ten veya araçlar önbelleğinden .NET Core belirli bir sürümünü alır ve Azure Pipelines Aracısı'nın PATH'sine (barındırılan veya özel) ekler. DotNetCoreCLI@2gibi sonraki görevlerde kullanılan .NET Core sürümünü değiştirmek için bu görevi kullanın. Bu görevi derleme tanımında DotNetCoreCLI@2 önce eklemek, sürümün uygulamanızı oluşturma, test etme ve yayımlama sırasında kullanılabilir olmasını sağlar.

Araç yükleyicisi yaklaşımı, aracı güncelleştirme döngülerinden ayrıştırmanıza da olanak tanır. Aradığınız .NET Core sürümü Azure Pipelines aracısında (Barındırılan veya Özel) eksikse, aracıya doğru sürümü yüklemek için bu görevi kullanabilirsiniz.

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örevin çalıştırılması, aynı işteki sonraki görevler için aşağıdaki taleplerini karşılar: DotNetCore
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Herhangi
Aracı sürümü 2.144.0 veya üzeri
Görev kategorisi Alet
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örevin çalıştırılması, aynı işteki sonraki görevler için aşağıdaki taleplerini karşılar: DotNetCore
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Herhangi
Aracı sürümü Desteklenen tüm aracı sürümleri.
Görev kategorisi Alet