UseDotNet@2 – Použití úlohy dotnet v2

Pomocí této úlohy můžete získat konkrétní verzi sady .NET Core SDK z internetu nebo místní mezipaměti a přidat ji do cesty. Tuto úlohu použijte ke změně verze .NET Core, která se používá v dalších úlohách. Tato úloha také poskytuje podporu proxy serveru.

Syntax

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

Vstupy

packageType - Balíček pro instalaci
string. Povolené hodnoty: runtime, sdk (SDK (obsahuje modul runtime)). Výchozí hodnota: sdk.

Určuje, jestli se má nainstalovat pouze modul runtime .NET nebo sada SDK.

useGlobalJson - Použít globální json
boolean. Volitelný. Používá se při packageType = sdk. Výchozí hodnota: false.

Nainstaluje všechny sady SDK ze souborů global.json. Tyto soubory se prohledávají z system.DefaultWorkingDirectory. Kořenovou cestu vyhledávání můžete změnit nastavením vstupu pracovního adresáře.

Formát 6.x a 6.1.x (použití .x jako zástupný znak) popsaný ve vstupu UseDotNet@2.version je určený pro použití v version vstupu v úkolu, nikoli v parametru sdk.version v global.json.

Pokud se zobrazí chybová zpráva jako ##[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. a používáte global.json, zkontrolujte sdk.version v global.json.

Další informace o global.jsonnaleznete v tématu Vyberte verzi rozhraní .NET, která se má použít.

workingDirectory - pracovní adresář
string. Volitelný. Používá se při useGlobalJson = true.

Určuje cestu, ze které se mají hledat soubory global.json při použití useGlobalJson. Pokud je hodnota prázdná, bude system.DefaultWorkingDirectory považována za kořenovou cestu.

version - verze
string. Volitelný. Používá se při useGlobalJson = false || packageType = runtime.

Určuje verzi sady .NET Core SDK nebo modulu runtime, který se má nainstalovat. Formáty hodnot verzí se zobrazují s příklady:

• 2.x: Nainstaluje nejnovější sadu SDK nebo modul runtime se zadanou hlavní verzí 2.
• 3.1.x: Nainstaluje nejnovější sadu SDK nebo modul runtime se zadanými hlavními a podverzemi, 3 a 1.
• 3.1.402: Nainstaluje zadanou verzi sady SDK nebo modulu runtime 3.1.402.

Hodnoty verzí pro instalace sady SDK nebo modulu runtime jsou v souboru releases.json. Odkaz na releases.json hlavní/podverze je v souboru release-index. Například odkaz na soubor releases.json verze 3.1.

vsVersion - kompatibilní verze sady Visual Studio
string.

Určuje kompatibilní verzi sady Visual Studio pro odpovídající instalaci sady .NET Core SDK. Hodnota musí být celé číslo verze, například 16.6.4, která obsahuje hlavní verzi, podverzi a číslo opravy.

Hodnoty verzí pro instalace sady SDK nebo modulu runtime, které se používají pro řetězec version, jsou v souboru releases.json. Odkaz na releases.json hlavní/podverze je v souboru release-index. Například odkaz na soubor releases.json verze 3.1.

includePreviewVersions - zahrnout verze Preview
boolean. Volitelný. Používá se při useGlobalJson = false || packageType = runtime. Výchozí hodnota: false.

Pokud je nastavená hodnota true, zahrnuje verze Preview, pokud úloha hledá nejnovější verze modulu runtime nebo sady SDK, například hledání 2.2.x nebo 3.1.x. Toto nastavení se ignoruje, pokud zadáte přesnou verzi, například 3.0.100-preview3-010431.

installationPath - cesta k instalaci .Net Core
string. Výchozí hodnota: $(Agent.ToolsDirectory)/dotnet.

Určuje, kde se má nainstalovat sada .NET Core SDK/Runtime. Různé cesty mohou mít následující dopad na . Chování rozhraní NET

• $(Agent.ToolsDirectory): Při použití této cesty se instalace agenta ukládá do mezipaměti, protože tento adresář není vyčištěn napříč kanály. Všechny kanály spuštěné v agentu mají přístup k dříve nainstalovaným verzím.
• $(Agent.TempDirectory): Použití této cesty zajišťuje, že kanál nepoužívá verzi .NET Core uloženou v mezipaměti, protože tato složka se po každém kanálu vyčistí.
• jinou cestu: Pokud má proces agenta přístup k cestě, můžete použít libovolnou cestu. Tím se změní stav počítače a ovlivní všechny procesy, které na něm běží.

Poznámka

Pomocí nastavení vyhledávání na více úrovníchperformMultiLevelLookupmůžete nakonfigurovat, jak hostitel .NET hledá verze.

performMultiLevelLookup - provádět vyhledávání na více úrovních
boolean. Výchozí hodnota: false.

Konfiguruje chování hostitelského procesu .NET při hledání vhodné sdílené architektury. Jedná se o následující hodnoty:

• false: Proces hostitele hledá pouze verze, které jsou přítomné ve složce určené úlohou.
• true: Proces hostitele bude prohledávat předdefinovaná globální umístění pomocí vyhledávání na více úrovních. Výchozí globální umístění jsou:
  • C:\Program Files\dotnet (64bitové procesy)
  • C:\Program Files (x86)\dotnet (32bitové procesy)

Přečtěte si další informace o vyhledávání SharedFX na více úrovních.

Poznámka

performMultiLevelLookup se vztahuje pouze na agenty založené na Windows.

requestTimeout - Nastavit časový limit pro žádost o stažení balíčku
string. Výchozí hodnota: 300000.

Zadejte hodnotu časového limitu pro požadavky HTTP, které úloha provede k získání balíčku .NET. Hodnota je v milisekundách. Výchozí hodnota je 3 00000 milisekund (5 minut). Nesmí být delší než 6 00000 milisekund (10 minut).

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádný.

Poznámky

Úloha Use .NET Core získá konkrétní verzi .NET Core z internetu nebo mezipaměti nástrojů a přidá ji do CESTY agenta Azure Pipelines (hostovaného nebo privátního). Tuto úlohu použijte ke změně verze .NET Core, která se používá v dalších úlohách, jako je DotNetCoreCLI@2. Přidání této úlohy před DotNetCoreCLI@2 v definici sestavení zajistí, že bude verze dostupná v době sestavování, testování a publikování aplikace.

Přístup instalačního programu nástrojů také umožňuje oddělit od cyklů aktualizací agenta. Pokud v agentu Azure Pipelines (hostované nebo soukromé) chybí verze .NET Core, kterou hledáte, můžete pomocí této úlohy získat správnou verzi nainstalovanou v agentu.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
požadavky	Žádný
možnosti	Spuštění tohoto úkolu splňuje následující požadavky požadavky pro všechny následné úkoly ve stejné úloze: DotNetCore
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	2.144.0 nebo vyšší
Kategorie úkolu	Nástroj