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 = sdk
olduğunda kullanın. Varsayılan değer: false
.
global.json
dosyalardan tüm SDK'ları yükler. Bu dosyalar system.DefaultWorkingDirectory
aranı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) version
sdk.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.json
kullanıyorsanız, sdk.version
içindeki global.json
denetleyin.
global.json
hakkında daha fazla bilgi için bkz. kullanmak için .NET sürümünü seçme.
çalışma dizini
string
. Opsiyonel.
useGlobalJson = true
olduğunda kullanın.
global.json
kullanı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 = runtime
olduğ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ı2
yükler. -
3.1.x
: belirtilen ana ve ikincil sürümler3
ve1
ile 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.402
yü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ı2
yükler. -
3.1.x
: belirtilen ana ve ikincil sürümler3
ve1
ile 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.402
yü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.4
gibi 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 = runtime
olduğunda kullanın. Varsayılan değer: false
.
true
olarak ayarlanırsa, görev en son çalışma zamanı/SDK sürümlerini ararken 2.2.x
veya 3.1.x
arama gibi önizleme sürümlerini içerir.
3.0.100-preview3-010431
gibi tam bir sürüm belirtirseniz bu ayar yoksayılır.
önizleme sürümlerini dahil
boolean
. Varsayılan değer: false
.
true
olarak ayarlanırsa, görev en son çalışma zamanı/SDK sürümlerini ararken 2.2.x
veya 3.1.x
arama gibi önizleme sürümlerini içerir.
3.0.100-preview3-010431
gibi tam bir sürüm belirtirseniz bu ayar yoksayılır.
.Net Core Yüklemek için
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 |