UseDotNet@2 – Dotnet v2-feladat használata

Ezzel a feladatsal beszerezheti a .NET Core SDK egy adott verzióját az internetről vagy a helyi gyorsítótárból, és hozzáadhatja a PATH-hoz. Ezzel a feladatsal módosíthatja a későbbi tevékenységekben használt .NET Core-verziót. Ez a feladat proxytámogatást is biztosít.

Szintaxis

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

Bemenetek

packageType - csomag telepítése
string. Engedélyezett értékek: runtime, sdk (SDK (futtatókörnyezetet tartalmaz)). Alapértelmezett érték: sdk.

Megadja, hogy csak a .NET-futtatókörnyezetet vagy az SDK-t telepítse-e.

useGlobalJson - Globális JSON- használata
boolean. Szabadon választható. Használja a packageType = sdk. Alapértelmezett érték: false.

Telepíti az összes SDK-t global.json fájlokból. Ezek a fájlok system.DefaultWorkingDirectory. A keresési gyökér elérési útját a munkakönyvtár bemenetének beállításával módosíthatja.

A UseDotNet@2.version bemenetben leírt 6.x és 6.1.x formátum (.x helyettesítő karakterrel) a feladat version bemenetében használható, nem pedig a global.jsonsdk.version paraméterében.

Ha hibaüzenetet kap, például ##[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., és global.jsonhasznál, ellenőrizze a global.jsonsdk.version.

A global.jsontovábbi információ: Válassza ki ahasználni kívánt .NET-verziót.

workingDirectory - Munkakönyvtár
string. Szabadon választható. Használja a useGlobalJson = true.

Azt az elérési utat adja meg, amelyből global.json fájlokat kell keresni useGlobalJsonhasználatakor. Ha az érték üres, system.DefaultWorkingDirectory lesz a gyökérútvonal.

version - verzió
string. Szabadon választható. Használja a useGlobalJson = false || packageType = runtime.

Megadja a telepíteni kívánt .NET Core SDK vagy futtatókörnyezet verzióját. A verzióérték-formátumok példákkal jelennek meg:

• 2.x: Telepíti a legújabb SDK-t vagy futtatókörnyezetet a megadott főverzióval, 2.
• 3.1.x: Telepíti a legújabb SDK-t vagy futtatókörnyezetet a megadott fő- és alverziókkal, 3 és 1.
• 3.1.402: Telepíti a megadott SDK-t vagy futtatókörnyezetet, 3.1.402.

Az SDK- vagy futtatókörnyezet-telepítések verzióértékei a releases.json fájlban találhatók. A főverzió/alverzió releases.json hivatkozás a releases-index fájlban található. Például a 3.1-es verzió releases.json fájlra mutató hivatkozás.

vsVersion - Kompatibilis Visual Studio-verzió
string.

Egy kompatibilis Visual Studio-verziót ad meg a megfelelő .NET Core SDK-telepítéshez. Az értéknek teljes verziószámnak kell lennie, például 16.6.4, amely egy főverziót, egy alverziót és egy javításszámot tartalmaz.

A version sztringhez használt SDK- vagy futtatókörnyezet-telepítések verzióértékei a releases.json fájlban találhatók. A főverzió/alverzió releases.json hivatkozás a releases-index fájlban található. Például a 3.1-es verzió releases.json fájlra mutató hivatkozás.

includePreviewVersions - Előzetes verziók belefoglalása
boolean. Szabadon választható. Használja a useGlobalJson = false || packageType = runtime. Alapértelmezett érték: false.

Ha trueértékre van állítva, akkor az előzetes verziókat is tartalmazza, amikor a feladat a legújabb futtatókörnyezeti/SDK-verziókat keresi, például 2.2.x vagy 3.1.xkeres. Ez a beállítás figyelmen kívül lesz hagyva, ha pontos verziót ad meg, például 3.0.100-preview3-010431.

installationPath - .Net Core- telepítésének elérési útja
string. Alapértelmezett érték: $(Agent.ToolsDirectory)/dotnet.

Megadja, hogy hol kell telepíteni a .NET Core SDK/Futtatókörnyezetet. A különböző elérési utakra a következő hatással lehet: A NET viselkedése.

• $(Agent.ToolsDirectory): Az elérési út használata gyorsítótárazza a telepítést az ügynökön, mivel ez a könyvtár nem lesz megtisztítva a folyamatok között. Az ügynökön futó összes folyamat hozzáfér a korábban telepített verziókhoz.
• $(Agent.TempDirectory): Az elérési út használatával biztosítható, hogy a folyamatok ne használják a .NET Core gyorsítótárazott verzióját, mivel ez a mappa minden folyamat után törlődik.
• Másik elérési út: Bármilyen elérési utat használhat, ha az ügynökfolyamat hozzáfér az elérési úthoz. Ez megváltoztatja a gép állapotát, és hatással lesz a rajta futó összes folyamatra.

Jegyzet

A többszintű keresés beállításával performMultiLevelLookupkonfigurálhatja, hogy a .NET-gazdagép hogyan keres verziókat.

performMultiLevelLookup - Többszintű keresési
boolean. Alapértelmezett érték: false.

Konfigurálja a .NET-gazdagépfolyamat viselkedését, amikor megfelelő megosztott keretrendszert keres. Az értékek a következők:

• false: A gazdagépfolyamat csak a feladat által megadott mappában található verziókra keres.
• true: A gazdagép folyamata előre definiált globális helyeken keres többszintű kereséssel. Az alapértelmezett globális helyek a következők:
  • C:\Program Files\dotnet (64 bites folyamatok)
  • C:\Program Files (x86)\dotnet (32 bites folyamatok)

További információ többszintű SharedFX keresési.

Jegyzet

performMultiLevelLookup csak Windows-alapú ügynökökre vonatkozik.

requestTimeout - Csomagletöltési kérelem időtúllépésének beállítása
string. Alapértelmezett érték: 300000.

Adjon időtúllépési értéket a .NET-csomag beszerzéséhez a feladat által végzett HTTP-kérésekhez. Az érték ezredmásodpercben van. Az alapértelmezett érték 300000 ezredmásodperc (5 perc). Nem lehet több, mint 6000000 ezredmásodperc (10 perc).

Tevékenységvezérlési beállítások

Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.

Kimeneti változók

Egyik sem.

Megjegyzések

A .NET Core használata feladat az internetről vagy az eszközök gyorsítótárából szerzi be a .NET Core- egy adott verzióját, és hozzáadja az Azure Pipelines-ügynök PATH-éhez (üzemeltetett vagy privát). Ezzel a feladatsal módosíthatja a .NET Core olyan későbbi tevékenységekben használt verzióját, mint a DotNetCoreCLI@2. A feladat builddefinícióban való DotNetCoreCLI@2 előtti hozzáadása biztosítja, hogy a verzió elérhető legyen az alkalmazás létrehozása, tesztelése és közzétételekor.

Az eszköztelepítő módszer lehetővé teszi az ügynökfrissítési ciklusok leválasztására is. Ha a keresett .NET Core-verzió hiányzik az Azure Pipelines-ügynökből (üzemeltetett vagy privát), akkor ezzel a feladatgal a megfelelő verziót telepítheti az ügynökre.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva	Ügynök, DeploymentGroup
Követelmények	Egyik sem
képességek	A feladat futtatása megfelel a következő követelményeknek, az ugyanazon feladatban lévő további tevékenységekhez: DotNetCore
parancskorlátozások	Bármely
Változók beállítása	Bármely
Ügynök verziója	2.144.0 vagy újabb
Tevékenységkategória	Eszköz