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ş

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

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

Genel json kullanma
. Opsiyonel. olduğunda kullanın. Varsayılan değer: .

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

girişinde açıklanan ve biçimi (joker karakter olarak kullanarak) parametresinde değil, görevdeki girişinde kullanılır.

gibi bir hata iletisi alırsanız ve kullanıyorsanız, içindeki denetleyin.

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

çalışma dizini
. Opsiyonel. olduğunda kullanın.

kullanılırken dosyalarının aranacağı yolu belirtir. Değer boşsa, kök yol olarak kabul edilir.

Sürüm
. Opsiyonel. olduğ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:

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

SDK veya çalışma zamanı yüklemelerinin sürüm değerleri dosyasındadır. Birincil/ikincil sürümün 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 versiyonu
.

Karşılık gelen .NET Core SDK kurulumu 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 gibi eksiksiz bir sürüm numarası olmalıdır.

dizesi için kullanılan SDK veya çalışma zamanı yüklemelerinin sürüm değerleri dosyasındadır. Birincil/ikincil sürümün 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ı.

Mevcut kurulumu kontrol edin
. Varsayılan değer: .

İ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.

önizleme sürümlerini dahil
. Opsiyonel. olduğunda kullanın. Varsayılan değer: .

olarak ayarlanırsa, görev en son çalışma zamanı/SDK sürümlerini ararken veya arama gibi önizleme sürümlerini içerir. gibi tam bir sürüm belirtirseniz bu ayar yoksayılır.

.Net Core Yüklemek için Yolu
. Varsayılan değer: .

.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.

• : 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 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: 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

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

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

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

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

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

Not

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

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

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 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 ajan'ında (Hosted veya Private) eksikse, bu görevi kullanarak doğru sürümü ajana yükleyebilirsiniz.

Gereksinim -leri

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Aracı, 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