UseDotNet@2 - dotnet v2 görevini kullanma

Bu görevi kullanarak internet veya yerel önbellekten belirli bir .NET Core SDK sürümünü edinin ve PATH'a ekleyin. Bu görevi, sonraki görevlerde kullanılan .NET Core sürümünü değiştirmek için 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. 
    #checkForExistingVersion: false # boolean. Check for existing installation. Default: false.
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Giriş

packageType - Kurulum için paket
string. İzin verilen değerler: runtime, sdk (SDK (çalışma zamanını içerir)). Varsayılan değer: sdk.

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

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

Tüm SDK'ları dosyalardan global.json kurar. Bu dosyalar .system.DefaultWorkingDirectory Çalışma dizini girişini ayarlayarak arama kök yolunu değiştirebilirsiniz.

Görev ayrıca sdk.rollForward belirtilen roll-forward politikasını karşılayan en son sürümü global.json okur ve yükler. Örneğin, global.json"version": "8.0.302" eğer belirtirseniz "rollForward": "latestFeature", görev tam sürümü yerine en son 8.0.x SDK'yı yükler. Eğer sdk.rollForward yoksa, görev önceki davranışla eşleşen tam olarak tanımlanan sdk.versionsürümü yükler. Desteklenen rollForward değerler hakkında daha fazla bilgi için Açıklamalar bölümüne ve global.json genel bakışına bakınız.

Girişte UseDotNet@2.version tanımlanan ve 6.1.x formatı (joker kart olarak kullanılarak.x), görevdeki girdide version kullanılır, içindeki parametre global.jsoniçin değilsdk.version.6.x

Eğer böyle ##[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. bir hata mesajı alırsanız ve kullanıyorsanızglobal.json, sdk.version .global.json

global.json hakkında daha fazla bilgi için bkz. Select the .NET version Choose that .

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

Dosyaların kullanıldığı global.json şekilde useGlobalJsonaranması gereken yolu belirtir. Değer boşsa, system.DefaultWorkingDirectory kök yolu olarak kabul edilir.

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

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

• 2.x: En son SDK veya çalışma zamanını belirtilen ana sürümle yükler, 2.
• 3.1.x: En son SDK veya çalışma zamanını belirtilen ana ve minör sürümlerle 3 yükler, ve 1.
• 3.1.402: Belirtilen SDK veya çalışma zamanı sürümünü yükler, 3.1.402.

SDK veya çalışma zamanı kurulumları için sürüm değerleri dosyada releases.json yer alır. Bir majör/minör versiyonun bağlantısı releases.jsonreleases-index dosyasında bulunur. Örneğin, sürüm 3.1 içinreleases.json dosyasına bağlantı.

vsVersion - Uyumlu Visual Studio versiyonu
string.

Karşılık gelen .NET Core SDK kurulumu için uyumlu bir Visual Studio sürümü belirtir. Değer, büyük bir versiyon, küçük bir versiyon ve bir yama numarası içeren tam bir sürüm 16.6.4numarası olmalıdır.

Dizide kullanılan SDK veya çalışma zamanı kurulumlarının version sürüm değerleri dosyada releases.json yer alır. Bir majör/minör versiyonun bağlantısı releases.jsonreleases-index dosyasında bulunur. Örneğin, sürüm 3.1 içinreleases.json dosyasına bağlantı.

checkForExistingVersion - Mevcut kurulumu kontrol edin
boolean. Varsayılan değer: false.

İndirmeye çalışmadan önce belirtilen sürümün zaten yüklü olup olmadığını tespit etmek isterseniz seçin. Yalnızca installationPath boş olduğunda yani varsayılan değere ayarlandığında kullanın.

includePreviewVersions - Önizleme Versiyonlarını Dahil Et
boolean. Opsiyonel. useGlobalJson = false || packageType = runtimeolduğunda kullanın. Varsayılan değer: false.

Eğer ayarlıysa true, görev en son çalışma zamanı/SDK sürümlerini aradığında, 2.2.x örneğin veya 3.1.xararken önizleme sürümlerini içerir. Bu ayar, örneğin tam bir sürüm 3.0.100-preview3-010431belirtirseniz göz ardı edilir.

installationPath - .Net Core Kurulum Yolu
string. Varsayılan değer: $(Agent.ToolsDirectory)/dotnet.

.NET Core SDK/Çalışma Zamanı'nın nereye yüklenmesi gerektiğini belirtir. Farklı yollar .NET'in davranışı üzerinde aşağıdaki etkiyi yaratabilir.

• $(Agent.ToolsDirectory): Bu yolu kullanıldığında, bu dizin boru hatları arasında temizlenmediği için kurulumu ajanda önbellekler. Aracıda çalışan tüm işlem hatlarının önceden yüklenmiş sürümlere erişimi vardır.
• $(Agent.TempDirectory): Bu yolu kullanmak, bir boru hattının önbelleklenmiş .NET Core sürümünü kullanmamasını sağlar; çünkü bu klasör her boru hattı sonrası temizlenir.
• Başka bir yol: Ajan süreci yola erişimi varsa herhangi bir yolu kullanabilirsiniz. Bu, makinenin durumunu değiştirir ve üzerinde çalışan tüm işlemleri etkiler.

Not

Çok Seviyeli Araştırma ayarını performMultiLevelLookup kullanarak .NET sunucunun sürüm aramasını yapılandırabilirsiniz.

performMultiLevelLookup - Çok Seviyeli Arama Yapın
boolean. Varsayılan değer: false.

.NET ana sürecinin uygun paylaşılan bir çerçeve aradığında davranışını yapılandırır. Değerler şunlardır:

• false: Ana işlem yalnızca görev tarafından belirlenen klasörde bulunan sürümleri arar.
• true: Ev sahibi süreç, çok katmanlı arama kullanarak önceden tanımlanmış küresel konumlarda arama yapar. Varsayılan genel konumlar şunlardır:
  • C:\Program Files\dotnet (64-bit işlemler)
  • C:\Program Files (x86)\dotnet (32-bit işlemler)

Çok katmanlı SharedFX araştırması hakkında daha fazla bilgi edinin.

Not

performMultiLevelLookup yalnızca Windows tabanlı ajanlar 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 elde etmek için yaptığı HTTP istekleri için zaman aşımına değer sağla. 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

Use .NET Core görevi, inte rnet veya araçlar önbelleğinden belirli bir .NET Core sürümünü edinir ve bunu Azure Pipelines Ajan'ın (barındırılan veya özel) PATH'ine ekler. Bu görevi, DotNetCoreCLI@2 gibi sonraki görevlerde kullanılan .NET Core sürümünü değiştirmek için kullanın. Bu görevi DotNetCoreCLI@2 öncesine eklemek, uygulamanızı oluşturma, test ve yayınlama sırasında sürümün erişilebilir 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 ajan'ında (Hosted veya Private) eksikse, bu görevi kullanarak doğru sürümü ajana yükleyebilirsiniz.

Roll-forward destek global.json

Görev useGlobalJson ayarlandığında true, dosyanızdaki sdk.rollForward özelliği global.json okur ve belirtilen roll-forward politikasını karşılayan en son SDK sürümünü yükler. disable, patch, feature, ve minor politikalar için, bu durum .NET CLI'nin SDK sürümlerini yerel olarak nasıl çözdüğüne uyduruyor; major ve latestMajor şu anda aynı ana sürüm içinde çözülüyor.

Eğer sdk.rollForward sizin global.jsoniçinde yoksa, görev tam olarak belirtilen sdk.versionsürümü yükler. Bu, önceki davranışla eşleşiyor.

Aşağıdaki tablo, her değerin rollForward sürüm çözünürlüğünü nasıl etkilediğini göstermektedir:

rollForward değeri	Behavior	Örnek: versiyon 8.0.302 şu şekilde çözülür
disable	Tam olarak belirtilen sürümü yükler.	8.0.302
patch	Aynı özellik bandında en son yamayı yükler.	Son Bilgiler >=8.0.300 <8.0.400
latestPatch	patchile aynıdır.	Son Bilgiler >=8.0.300 <8.0.400
feature	Aynı major.minor sürümüne en son özellik bandını yükler.	Son Bilgiler 8.0.x
latestFeature	featureile aynıdır.	Son Bilgiler 8.0.x
minor	Aynı ana versiyonun içinde en son küçük versiyonu yükler.	Son Bilgiler 8.x
latestMinor	minorile aynıdır.	Son Bilgiler 8.x
major	Aynı ana sürüm içinde en son sürümü yükler.	Son Bilgiler 8.x
latestMajor	majorile aynıdır.	Son Bilgiler 8.x

Not

UseDotNet@2'de, major ve latestMajor politikaları şu anda sadece aynı ana sürümde çözülüyor. Çapraz ana sürüm çözünürlüğü henüz desteklenmemektedir.

Eğer global.json tanınmayan rollForward bir değer içeriyorsa, görev bir uyarı kaydeder ve tam olarak belirtilen sdk.versionsürümü yüklemeye geri döner.

Değerlerin rollForward tam belirtisini için global.json genel bakışına bakınız.

Examples

En son özellik bandını global.json

Aşağıdaki global.json dosya, ayarlı olarak latestFeatureSDK sürümünü 8.0.302rollForward belirtir. Görev, mevcut en son 8.0.x SDK'yı yükler.

{
  "sdk": {
    "version": "8.0.302",
    "rollForward": "latestFeature"
  }
}

steps:
- task: UseDotNet@2
  displayName: 'Install .NET SDK from global.json'
  inputs:
    packageType: 'sdk'
    useGlobalJson: true

En son yamayı bir özellik bandında global.json

Aşağıdaki global.json dosya, ayarlı olarak latestPatchSDK sürümünü 8.0.302rollForward belirtir. Görev, özellik bandı içinde en son SDK sürümünü 8.0.3xx yükler.

{
  "sdk": {
    "version": "8.0.302",
    "rollForward": "latestPatch"
  }
}

steps:
- task: UseDotNet@2
  displayName: 'Install .NET SDK from global.json'
  inputs:
    packageType: 'sdk'
    useGlobalJson: true

Gereksinim -leri

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Aracı, DeploymentGroup
Talepleri	Hiç kimse
Özellikler	Bu görevi çalıştırmak, aynı işteki sonraki görevler için aşağıdaki talepleri 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

Ayrıca bakınız

• global.json genel bakış
• Kullanılacak .NET sürümünü seçin
• DotNetCoreCLI@2 görev