DotNetCoreInstaller@1 – .NET Core SDK/runtime installer v1 feladat

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 azt a PATH-hoz.

Fontos

Ez a feladat elavult, és 2024. január 31-én megszűnik. Használja a UseDotNet@2.

Syntax

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #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.

Bevitelek

packageType - Telepítendő csomag
string. Kötelező. Engedélyezett értékek: runtime (csak futtatókörnyezet) sdk (SDK (futtatókörnyezetet tartalmaz)). Alapértelmezett érték: sdk.

Meghatározza, hogy csak a futtatókörnyezetet vagy a teljes SDK-t telepítse-e.

version - Változat
string. Kötelező. Alapértelmezett érték: 2.2.x.

Megadja a telepíteni kívánt .NET Core SDK vagy Futtatókörnyezet verzióját.

A verzió megadásához használja a következő formátumot:

• 2.x: Telepíti a legújabbat a főverzióban.
• 2.2.x: Telepíti a legújabbat a fő- és alverzióban.
• 2.2.104: A pontos verzió telepítése.

A releases-index fájlban keresse meg az SDK/Runtime telepítésének értékétversion.

includePreviewVersions - Előzetes verzió belefoglalása
boolean. Alapértelmezett érték: false.

Itt adhatja meg, hogy az előzetes verziókat bele szeretné-e foglalni a legújabb verziók keresésekor. 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 - A .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-t/futtatókörnyezetet. A különböző elérési utak a következő hatással lehetnek a következőre: . A NET viselkedése:

• $(Agent.ToolsDirectory): Ez határozza meg az ügynök gyorsítótárazandó verzióját, mivel ez a könyvtár nem törlődik a folyamatok között. Az ügynökön futó összes folyamat hozzáfér az ügynök használatával korábban telepített verziókhoz.
• $(Agent.TempDirectory): Ezzel 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.
• Bármely más elérési út: Bármilyen más elérési utat konfigurálhat, mivel 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.

A többszintű keresési beállítást is konfigurálhatja. Ez a beállítás konfigurálhatja a .NET-gazdagépet a megfelelő verzió tesztelésére.

performMultiLevelLookup - Többszintű keresés végrehajtása
boolean. Alapértelmezett érték: false.

Ez a bemenet csak Windows-alapú ügynökökre vonatkozik. Ez a bemenet konfigurálja a .NET-gazdagépfolyamatok viselkedését a megfelelő megosztott keretrendszerek keresése érdekében. False azt jelenti, hogy a gazdafolyamat csak az ebben a feladatban megadott mappában található verziókat tekinti meg. True azt jelenti, hogy a gazdagép többszintű kereséssel megkísérli az előre meghatározott globális helyek keresését.

Windows esetén az alapértelmezett globális helyek a következők:

• C:\Program Files\dotnet (64 bites folyamatok)
• C:\Program Files (x86)\dotnet (32 bites folyamat)

További információ: Többszintű SharedFX-keresés.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ez a feladat elavult. Használja a @UseDotNet2.

A feladatverzió újdonságai.

• Több verzió egymás melletti telepítésének támogatása.
• A verzió mintáinak támogatása a legújabb alverzió/főverzió lekéréséhez.
• A többszintű keresés korlátozása.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	A feladat futtatása megfelel a következő követelményeknek az ugyanabban a feladatban lévő összes további tevékenységre vonatkozóan: DotNetCore
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	Minden támogatott ügynökverzió.
Feladatkategória	Eszköz