Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу, чтобы получить определённую версию .NET Core SDK из internet или локального кэша и добавить её в 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.
#checkForExistingVersion: false # boolean. Check for existing installation. Default: false.
#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.
#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.
Входы
пакет для установки
. Допустимые значения: , (пакет SDK (содержит среду выполнения)). Значение по умолчанию: .
Указывает, устанавливать ли только .NET runtime или SDK.
Использование глобальных json
. Необязательный. Используется при . Значение по умолчанию: .
Устанавливает все пакеты SDK из файлов. Эти файлы выполняются в . Корневой путь поиска можно изменить, задав входные данные рабочего каталога.
Формат и (используя в качестве подстановочного знака), описанный в входных данных, предназначен для использования в входных данных задачи, а не параметра в .
Если вы получаете сообщение об ошибке, например и используете , проверьте в .
Для получения дополнительной информации о global.json см. Выберите .NET версию для использования.
рабочий каталог
. Необязательный. Используется при .
Указывает путь, из которого следует искать файлы при использовании . Если значение пусто, будет считаться корневым путем.
версии
. Необязательный. Используется при .
Указывает версию .NET Core SDK или runtime для установки. Форматы значений версии показаны с примерами:
- : устанавливает последний пакет SDK или среду выполнения с указанной основной версией, .
- . Устанавливает последний пакет SDK или среду выполнения с указанными основными и дополнительными версиями, и .
- : устанавливает указанный пакет SDK или версию среды выполнения, .
Значения версий для установок пакета SDK или среды выполнения находятся в файле . Ссылка на основной или дополнительной версии находится в файле выпуска. Например, ссылка на файл releases.json версии 3.1.
vsVersion
-
совместимая версия Visual Studio
.
Указывает совместимую версию Visual Studio для соответствующей установки .NET Core SDK. Это значение должно быть полным номером версии, например , который содержит основную версию, дополнительный номер версии и номер исправления.
Значения версий для установок пакета SDK или среды выполнения, которые используются для строки , находятся в файле . Ссылка на основной или дополнительной версии находится в файле выпуска. Например, ссылка на файл releases.json версии 3.1.
Проверьте наличие существующей установки
. Значение по умолчанию: .
Выбирайте, хотите ли вы определить, установлена ли уже указанная версия, прежде чем пытаться скачивать. Используйте только тогда, когда путь установки пустой, то есть установлен на значение по умолчанию.
включить предварительные версии
. Необязательный. Используется при . Значение по умолчанию: .
Если задано значение , включает предварительные версии при поиске последней версии среды выполнения или пакета SDK, например поиск или . Этот параметр игнорируется, если указать точную версию, например .
Путь для установки .Net Core
. Значение по умолчанию: .
Указывает, где следует устанавливать .NET Core SDK/Runtime. Разные пути могут оказывать следующее влияние на поведение .NET.
- . Использование этого пути кэширует установку агента, так как этот каталог не очищается в конвейерах. Все конвейеры, работающие на агенте, имеют доступ к ранее установленным версиям.
-
$(Agent.TempDirectory): Использование этого пути гарантирует, что конвейер не использует кэшированную версию .NET Core, так как эта папка очищается после каждого конвейера. - другой путь: можно использовать любой путь, если процесс агента имеет доступ к пути. Это изменит состояние компьютера и повлияет на все процессы, выполняемые на нем.
Заметка
Вы можете использовать настройки Multi-Level LookupperformMultiLevelLookup, чтобы настроить поиск версий на .NET хосте.
выполнение многоуровневого поиска
. Значение по умолчанию: .
Настраивает поведение процесса .NET-хоста при поиске подходящего общего фреймворка. Значения:
- : процесс узла выполняет поиск только версий, присутствующих в папке, указанной задачей.
- . Процесс узла будет выполнять поиск в предопределенных глобальных расположениях с помощью многоуровневого поиска. Глобальные расположения по умолчанию:
- (64-разрядные процессы)
- (32-разрядные процессы)
Дополнительные сведения о многоуровневойподстановки SharedFX.
Заметка
performMultiLevelLookup применяется только к агентам, работающим #REF!.
Задать время ожидания для запроса на скачивание пакетов
. Значение по умолчанию: .
Предоставить значение тайм-аута для HTTP-запросов, которые выполняет задача, чтобы получить пакет .NET. Значение находится в миллисекундах. Значение по умолчанию — 300000 миллисекунда (5 минут). Не может быть более 600000 миллисекунда (10 минут).
Параметры управления задачами
Все задачи имеют параметры управления в дополнение к входным данным задачи. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Никакой.
Замечания
Задача Use .NET Core получает определённую версию .NET Core из inte rnet или кэша инструментов, и добавляет её в PATH Azure Pipelines Agent (хостинг или приватный). Используйте эту задачу, чтобы изменить версию .NET Core, используемую в последующих задачах, таких как DotNetCoreCLI@2. Добавление этой задачи перед DotNetCoreCLI@2 в определении сборки гарантирует, что версия будет доступна во время сборки, тестирования и публикации приложения.
Подход установщика инструментов также позволяет разделить циклы обновления агента. Если нужная вам версия .NET Core отсутствует в агенте Azure Pipelines (Hosted или Private), то вы можете использовать эту задачу, чтобы установить нужную версию на агенте.
Требования
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка, классический выпуск |
| Выполняется в | Агент, DeploymentGroup |
| требования | Никакой |
| возможностей |
Выполнение этой задачи удовлетворяет следующим требованиям для любых последующих задач в том же задании: DotNetCore |
| ограничения команд | Любой |
| переменные settable | Любой |
| Версия агента | 2.144.0 или более поздней версии |
| Категория задач | Инструмент |