UseDotNet@2. Использование задачи dotnet версии 2

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

Синтаксис

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

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

useGlobalJson - Использование глобальных json
boolean. Необязательный. Используется при packageType = sdk. Значение по умолчанию: false.

Устанавливает все пакеты SDK из global.json файлов. Эти файлы выполняются в system.DefaultWorkingDirectory. Корневой путь поиска можно изменить, задав входные данные рабочего каталога.

Формат 6.x и 6.1.x (используя .x в качестве подстановочного знака), описанный в UseDotNet@2.version входных данных, предназначен для использования в version входных данных задачи, а не параметра sdk.version в global.json.

Если вы получаете сообщение об ошибке, например ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. и используете global.json, проверьте sdk.version в global.json.

Дополнительные сведения о global.jsonсм. в разделе Выбор версии .NET для использования.

workingDirectory - рабочий каталог
string. Необязательный. Используется при useGlobalJson = true.

Указывает путь, из которого следует искать файлы global.json при использовании useGlobalJson. Если значение пусто, system.DefaultWorkingDirectory будет считаться корневым путем.

version - версии
string. Необязательный. Используется при useGlobalJson = false || packageType = runtime.

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

• 2.x: устанавливает последний пакет SDK или среду выполнения с указанной основной версией, 2.
• 3.1.x. Устанавливает последний пакет SDK или среду выполнения с указанными основными и дополнительными версиями, 3 и 1.
• 3.1.402: устанавливает указанный пакет SDK или версию среды выполнения, 3.1.402.

Значения версий для установок пакета SDK или среды выполнения находятся в файле releases.json. Ссылка на releases.json основной или дополнительной версии находится в файле выпуска. Например, ссылка на файл releases.json версии 3.1.

vsVersion - Совместимая версия Visual Studio
string.

Указывает совместимую версию Visual Studio для соответствующей установки пакета SDK для .NET Core. Это значение должно быть полным номером версии, например 16.6.4, который содержит основную версию, дополнительный номер версии и номер исправления.

Значения версий для установок пакета SDK или среды выполнения, которые используются для строки version, находятся в файле releases.json. Ссылка на releases.json основной или дополнительной версии находится в файле выпуска. Например, ссылка на файл releases.json версии 3.1.

includePreviewVersions - включить предварительные версии
boolean. Необязательный. Используется при useGlobalJson = false || packageType = runtime. Значение по умолчанию: false.

Если задано значение true, включает предварительные версии при поиске последней версии среды выполнения или пакета SDK, например поиск 2.2.x или 3.1.x. Этот параметр игнорируется, если указать точную версию, например 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.

Настраивает поведение процесса узла .NET при поиске подходящей общей платформы. Значения:

• false: процесс узла выполняет поиск только версий, присутствующих в папке, указанной задачей.
• true. Процесс узла будет выполнять поиск в предопределенных глобальных расположениях с помощью многоуровневого поиска. Глобальные расположения по умолчанию:
  • C:\Program Files\dotnet (64-разрядные процессы)
  • C:\Program Files (x86)\dotnet (32-разрядные процессы)

Дополнительные сведения о многоуровневойподстановки SharedFX.

Заметка

performMultiLevelLookup применимо только к агентам на основе Windows.

requestTimeout - Задать время ожидания для запроса на скачивание пакетов
string. Значение по умолчанию: 300000.

Укажите значение времени ожидания для HTTP-запросов, которые задача выполняет для получения пакета .NET. Значение находится в миллисекундах. Значение по умолчанию — 300000 миллисекунда (5 минут). Не может быть более 600000 миллисекунда (10 минут).

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

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

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

Никакой.

Замечания

Задача Use .NET Core получает определенную версию .NET Core из Интернета или кэша инструментов и добавляет его в ПУТЬ агента Azure Pipelines (размещенного или закрытого). Используйте эту задачу для изменения версии .NET Core, используемой в последующих задачах, таких как DotNetCoreCLI@2. Добавление этой задачи перед DotNetCoreCLI@2 в определении сборки гарантирует, что версия будет доступна во время сборки, тестирования и публикации приложения.

Подход установщика инструментов также позволяет разделить циклы обновления агента. Если нужную версию .NET Core отсутствует в агенте Azure Pipelines (размещенном или закрытом), можно использовать эту задачу, чтобы получить нужную версию, установленную на агенте.

Требования

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