DotNetCoreInstaller@1 — задача пакета SDK для .NET Core или установщика среды выполнения версии 1

Статья
08/19/2024

Используйте эту задачу, чтобы получить определенную версию пакета SDK для .NET Core из Интернета или локального кэша и добавить ее в PATH.

Важно!

Эта задача устарела и будет прекращена 31 января 2024 г. Используйте UseDotNet@2.

Важно!

TЭтая задача является устаревшей. Используйте @UseDotNet2.

Получает определенную версию пакета SDK для .NET Core из Интернета или локального кэша и добавляет ее в PATH.

Синтаксис

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

Входные данные

packageType - Пакет для установки
string. Обязательный. Допустимые значения: runtime (только среда выполнения), sdk (пакет SDK (содержит среду выполнения)). Значение по умолчанию: sdk.

Указывает, следует ли устанавливать только среду выполнения или полный пакет SDK.

version - Версия
string. Обязательный. Значение по умолчанию: 2.2.x.

Указывает версию пакета SDK для .NET Core или среды выполнения для установки.

Используйте следующий формат, чтобы указать версию:

2.x: устанавливает последнюю в основной версии.
2.2.x. Устанавливает последнюю версию в основной и дополнительной версиях.
2.2.104: устанавливает точную версию.

Найдите значение version для установки пакета SDK или среды выполнения в файле releases-index.

includePreviewVersions - Включить предварительные версии
boolean. Значение по умолчанию: false.

Указывает, нужно ли включать предварительные версии при поиске последних версий. Этот параметр игнорируется при указании точной версии, например 3.0.100-preview3-010431.

installationPath - Путь к установке .Net Core
string. Значение по умолчанию: $(Agent.ToolsDirectory)/dotnet.

Указывает место установки пакета SDK или среды выполнения для .NET Core. Различные пути могут иметь следующее влияние на . Поведение NET:

$(Agent.ToolsDirectory): определяет версию, которая будет кэширована в агенте, так как этот каталог не очищается в конвейерах. Все конвейеры, работающие в агенте, будут иметь доступ к версиям, установленным ранее с помощью агента.
$(Agent.TempDirectory): это гарантирует, что конвейер не будет использовать кэшированные версии .NET Core, так как эта папка очищается после каждого конвейера.
Любой другой путь. Вы можете настроить любой другой путь, если у процесса агента есть доступ к пути. Это изменит состояние компьютера и повлияет на все выполняемые на нем процессы.

Вы также можете настроить параметр Многоуровневый уточняющий запрос. Этот параметр позволяет настроить узел .NET для проверки подходящей версии.

performMultiLevelLookup - Выполнение многоуровневого поиска
boolean. Значение по умолчанию: false.

Эти входные данные применимы только к агентам windows. Эти входные данные настраивают поведение хост-процессов .NET для поиска подходящей общей платформы. False означает, что ведущем процессе будут искаться только версии, имеющиеся в папке, указанной в этой задаче. True означает, что узел попытается выполнить поиск в предварительно определенных глобальных расположениях с помощью многоуровневого поиска.

Для Windows глобальные расположения по умолчанию:

C:\Program Files\dotnet (64-разрядные процессы)
C:\Program Files (x86)\dotnet (32-разрядный процесс)

Дополнительные сведения см. в разделе Multi-level SharedFX Lookup.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Эта задача является устаревшей. Используйте @UseDotNet2.

Новые возможности этой версии задачи.

Поддержка параллельной установки нескольких версий.
Поддержка шаблонов в версии для получения последних дополнительных или основных версий.
Ограничение многоуровневого поиска.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Нет
Capabilities	Выполнение этой задачи удовлетворяет следующим требованиям для всех последующих задач в том же задании: DotNetCore
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	Все поддерживаемые версии агента.
Категория задач	Инструмент

Поделиться через