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

Použijte tuto úlohu k získání konkrétní verze technologie .NET Core SDK z internet nebo lokální cache a přidejte ji do PATH. Použijte tuto úlohu ke změně verze technologie .NET Core, která se používá v následujících úlohách. Tato úloha také poskytuje podporu proxy serveru.

Syntaxe

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

Vstupy

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

Specifikuje, zda se instaluje pouze technologie .NET runtime nebo SDK.

Použít globální json
. Volitelný. Používá se při . Výchozí hodnota: .

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

Formát a (použití jako zástupný znak) popsaný ve vstupu je určený pro použití v vstupu v úkolu, nikoli v parametru v .

Pokud se zobrazí chybová zpráva jako a používáte , zkontrolujte v .

Pro více informací o global.json viz Vyberte technologie .NET verzi pro použití.

pracovní adresář
. Volitelný. Používá se při .

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

verze
. Volitelný. Používá se při .

Specifikuje verzi technologie .NET Core SDK nebo runtime pro instalaci. Formáty hodnot verzí se zobrazují s příklady:

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

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

vsVersion - kompatibilní Visual Studio verzi
.

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

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

Zkontrolujte stávající instalaci
. Výchozí hodnota: .

Vyber, jestli chceš zjistit, jestli je daná verze už nainstalovaná, než se pokusíš o stažení. Používejte pouze tehdy, když je installPath prázdný, tj. nastavený na výchozí hodnotu.

zahrnout verze Preview
. Volitelný. Používá se při . Výchozí hodnota: .

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

cesta k instalaci .Net Core
. Výchozí hodnota: .

Specifikuje, kde by měl být instalován technologie .NET Core SDK/runtime. Různé cesty mohou mít následující dopad na chování technologie .NET.

• : 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 pipeline nepoužívá cacheovanou verzi technologie .NET Core, protože tato složka se po každém pipeline vymaže.
• 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

Můžete použít nastavení Multi-Level LookupperformMultiLevelLookup, abyste nakonfigurovali, jak technologie .NET host vyhledává verze.

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

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

• : Proces hostitele hledá pouze verze, které jsou přítomné ve složce určené úlohou.
• : 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:
  • (64bitové procesy)
  • (32bitové procesy)

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

Poznámka

performMultiLevelLookup platí pouze pro agenty se sídlem Windows.

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

Uveďte časovou hranici pro HTTP požadavky, které úkol provádí pro získání balíčku technologie .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 technologie .NET Core získá specifickou verzi technologie .NET Core z inte rnet nebo cache nástrojů a přidá ji do PATH Azure Pipelines Agenta (hostovaného nebo soukromého). Použijte tuto úlohu ke změně verze technologie .NET Core používané v následujících úlohách, například 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 hledáte verzi technologie .NET Core v agentu Azure Pipelines (hostované nebo soukromé), můžete tuto úlohu použít k instalaci správné verze na agenta.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, skupina nasazení
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