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.

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

# 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.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

# Use dotnet 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.
    #version: # string. Version. 
    #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.

Указывает, следует ли устанавливать только среду выполнения .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.

version - версии
string.

Указывает версию пакета 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.

includePreviewVersions - включить предварительные версии
boolean. Значение по умолчанию: 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, так как эта папка очищается после каждого конвейера.
• другой путь: можно использовать любой путь, если процесс агента имеет доступ к пути. Это изменит состояние компьютера и повлияет на все процессы, выполняемые на нем.

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

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

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

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

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

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

Никакой.