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

packageType - Pakiet do zainstalowania
string. 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. 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ę, na przykład 3.0.100-preview3-010431.

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

Określa, gdzie należy zainstalować zestaw .NET Core SDK/środowisko uruchomieniowe. Różne ścieżki mogą mieć następujący wpływ na usługę . Zachowanie platformy NET:

• $(Agent.ToolsDirectory): określa wersję, która ma być buforowana w 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ę, ponieważ proces agenta ma dostęp do ścieżki. Spowoduje to zmianę stanu maszyny i wpłynie na wszystkie uruchomione na nim procesy.

Można również skonfigurować ustawienie Wyszukiwanie wielowymiarowe. To ustawienie umożliwia skonfigurowanie hosta platformy .NET pod kątem odpowiedniej wersji.

performMultiLevelLookup - Wyszukiwanie 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 .NET w celu wyszukania odpowiedniej struktury udostępnionej. False oznacza, że proces hosta będzie wyglądać tylko w wersjach znajdujących się w folderze określonym w tym zadaniu. True oznacza, że host podejmie próbę wyszukania wstępnie zdefiniowanych lokalizacji globalnych przy użyciu wyszukiwania wielowymiarowego.

W przypadku systemu Windows domyślne lokalizacje globalne to:

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

Aby uzyskać więcej informacji, zobacz Wyszukiwanie funkcji SharedFX na poziomie wieloeziomowym.

Opcje sterowania zadania

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

Zmienne wyjściowe

Brak.

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

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	Uruchomienie tego zadania spełnia następujące wymagania dotyczące wszystkich kolejnych zadań w tym samym zadaniu: DotNetCore
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadania	Narzędzie