DotNetCoreInstaller@1 — zadanie instalatora zestawu .NET Core SDK/środowiska uruchomieniowego w wersji 1

Użyj tego zadania, aby uzyskać określoną wersję zestawu .NET Core SDK z Internetu lub lokalnej pamięci podręcznej i dodać ją do ścieżki.

Ważne

To zadanie jest przestarzałe i zostanie wycofane 31 stycznia 2024 r. Użyj UseDotNet@2.

Składnia

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

Dane wejściowe

pakiet packageType - do zainstalowania
string. To jest wymagane. Dozwolone wartości: runtime (tylko środowisko uruchomieniowe), sdk (zestaw SDK (zawiera środowisko uruchomieniowe)). Wartość domyślna: sdk.

Określa, czy należy zainstalować tylko środowisko uruchomieniowe, czy pełny zestaw SDK.

version - wersja
string. To jest wymagane. Wartość domyślna: 2.2.x.

Określa wersję zestawu .NET Core SDK lub środowiska uruchomieniowego do zainstalowania.

Użyj następującego formatu, aby określić wersję:

• 2.x: instaluje najnowszą wersję główną.
• 2.2.x: instaluje najnowszą wersję główną i pomocniczą.
• 2.2.104: Instaluje dokładną wersję.

Znajdź wartość version instalowania zestawu SDK/środowiska uruchomieniowego w pliku releases-index.

includePreviewVersions - uwzględnij wersje zapoznawcza
boolean. Wartość domyślna: false.

Określa, czy chcesz, aby wersje zapoznawcze były uwzględniane podczas wyszukiwania najnowszych wersji. To ustawienie jest ignorowane, jeśli określisz dokładną wersję, taką jak 3.0.100-preview3-010431.

ścieżka installationPath - do zainstalowania platformy .Net Core
string. Wartość domyślna: $(Agent.ToolsDirectory)/dotnet.

Określa, gdzie ma być zainstalowany zestaw .NET Core SDK/środowisko uruchomieniowe. Różne ścieżki mogą mieć następujący wpływ na element . Zachowanie platformy NET:

• $(Agent.ToolsDirectory): określa wersję, która ma być buforowana na agencie, ponieważ ten katalog nie jest czyszczony w potokach. Wszystkie potoki uruchomione na agencie będą miały dostęp do wersji zainstalowanych wcześniej przy użyciu agenta.
• $(Agent.TempDirectory): Dzięki temu potok nie używa żadnej buforowanej wersji platformy .NET Core, ponieważ ten folder jest czyszczony po każdym potoku.
• Dowolna inna ścieżka: możesz skonfigurować dowolną inną ścieżkę, biorąc pod uwagę, że proces agenta ma dostęp do ścieżki. Spowoduje to zmianę stanu maszyny i wpłynie na wszystkie uruchomione na niej procesy.

Można również skonfigurować ustawienie Wyszukiwania na wielu poziomach. To ustawienie umożliwia skonfigurowanie hosta platformy .NET do sondowania odpowiedniej wersji.

performMultiLevelLookup - wyszukiwania na wielu poziomach
boolean. Wartość domyślna: false.

Te dane wejściowe mają zastosowanie tylko do agentów opartych na systemie Windows. Te dane wejściowe konfigurują zachowanie procesów hosta platformy .NET na potrzeby wyszukiwania odpowiedniej platformy udostępnionej. False oznacza, że proces hosta będzie wyglądał tylko wersje w folderze określonym w tym zadaniu. True oznacza, że host podejmie próbę wyszukania wstępnie zdefiniowanych lokalizacji globalnych przy użyciu wyszukiwania wielo levelowego.

W przypadku systemu Windows domyślne lokalizacje globalne to:

• C:\Program Files\dotnet (procesy 64-bitowe)
• C:\Program Files (x86)\dotnet (proces 32-bitowy)

Aby uzyskać więcej informacji, zobacz multi-level SharedFX Lookup.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

To zadanie jest przestarzałe. Użyj @UseDotNet2.

Co nowego w tej wersji zadania.

• Obsługa instalowania wielu wersji obok siebie.
• Obsługa wzorców w wersji w celu pobrania najnowszej wersji pomocniczej/głównej.
• Ogranicz wyszukiwanie na wielu poziomach.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	Uruchomienie tego zadania spełnia następujące wymagania dla wszystkich kolejnych zadań w tym samym zadaniu: DotNetCore
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadań	Narzędzie