UseDotNet@2 – Dotnet v2-feladat használata

Ezt a feladatot arra használjuk, hogy beszerezz egy adott verziót a .NET Core SDK-ból az internet-ről vagy a helyi gyorsítótárból, és hozzáadd azt az PATH-hoz. Ezt a feladatot arra használjuk, hogy megváltoztasd a .NET Core verzióját, amely a következő feladatokban használatos. 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. 
    #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.

Bemenetek

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

Megadja, hogy csak a .NET futásidőt vagy az SDK-t telepítsük.

Globális JSON- használata
. Szabadon választható. Használja a . Alapértelmezett érték: .

Telepíti az összes SDK-t fájlokból. Ezek a fájlok . 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 bemenetben leírt és formátum ( helyettesítő karakterrel) a feladat bemenetében használható, nem pedig a paraméterében.

Ha hibaüzenetet kap, például , és használ, ellenőrizze a .

További információért a global.json oldalról lásd: Válassza ki a .NET verziót.

Munkakönyvtár
. Szabadon választható. Használja a .

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

verzió
. Szabadon választható. Használja a .

Megadja a .NET Core SDK vagy futtatóidejű telepítési verzióját. A verzióérték-formátumok példákkal jelennek meg:

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

Az SDK- vagy futtatókörnyezet-telepítések verzióértékei a fájlban találhatók. A főverzió/alverzió 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ó
.

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

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

Ellenőrizd a meglévő telepítést
. Alapértelmezett érték: .

Válaszd ki, ha azt szeretnéd, hogy észleld, hogy a megadott verzió már telepítve van-e, mielőtt megpróbálnád letölteni. Csak akkor használd, ha az installPath üres, azaz alapértelmezett értékre van állítva.

Előzetes verziók belefoglalása
. Szabadon választható. Használja a . Alapértelmezett érték: .

Ha é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 vagy keres. Ez a beállítás figyelmen kívül lesz hagyva, ha pontos verziót ad meg, például .

.Net Core- telepítésének elérési útja
. Alapértelmezett érték: .

Megadja, hol kell telepíteni a .NET Core SDK/Runtime-t. A különböző utak a következő hatással lehetnek a .NET viselkedésére.

• : 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): Ezen útvonal használata biztosítja, hogy a csővezeték ne használja .NET Core gyorsítótáros verzióját, mivel ezt a mappát minden pipeline után tisztítják.
• 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

Használhatod a Multi-Level Lookup beállítást, performMultiLevelLookup, hogy beállítsd, hogyan keres a .NET hoszt verziókat.

Többszintű keresési
. Alapértelmezett érték: .

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

• : A gazdagépfolyamat csak a feladat által megadott mappában található verziókra keres.
• : 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:
  • (64 bites folyamatok)
  • (32 bites folyamatok)

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

Jegyzet

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

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

Biztosíts időtúlzási értéket a feladat által a .NET csomag eléréséhez szükséges 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 Use .NET Core feladat egy adott verziót szerez be a .NET Core inte-ből vagy az eszközök gyorsítótárából rnet majd hozzáadja azt a Azure Pipelines Agent (hosztolt vagy privát) PATH-jához. Ezt a feladatot használd arra, hogy megváltoztasd a .NET Core verziót, amelyet a következő feladatokban, például az DotNetCoreCLI@2 használnak. 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 az .NET Core verzió, amit keresel, hiányzik a Azure Pipelines ügynökből (Hosted vagy Private), akkor ezzel a feladattal telepítheted a megfelelő verziót az ügynökön.

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