Использование задачи .NET Core

ПараметрыОписание
packageType
Пакет для установки
Укажите, следует ли устанавливать только среду выполнения или пакет SDK
Значение по умолчанию: пакет SDK
useGlobalJson
Использовать глобальный JSON
Выберите этот параметр, чтобы установить все пакеты SDK из файлов Global. JSON. Поиск этих файлов осуществляется из системы. DefaultWorkingDirectory. Путь к корневому каталогу поиска можно изменить, задав входные данные рабочего каталога.
workingDirectory
Рабочий каталог
Укажите путь, по которому следует искать файлы Global. JSON при использовании команды "Use Global JSON". Если пусто, System. DefaultWorkingDirectory будет рассматриваться как корневой путь
version
Версия
Укажите версию пакет SDK для .NET Core или среды выполнения для установки.
Версии могут быть указаны в следующих форматах:
  • 2. x = > установить последнюю версию в основной версии.
  • 3.1. x = > Установка последней версии в основной и дополнительной версиях
  • 3.1.402 = > установить точную версию

  • Найдите значение version для установки пакета SDK и среды выполнения из файла releases. JSON. Ссылка на releases. JSON этой основной. дополнительной версии можно найти в файле Release-index File. Как и ссылка на releases. JSON для версии 3,1, https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/3.1/releases.json
    includePreviewVersions
    Включить предварительные версии
    Выберите, если требуется включать предварительные версии при поиске последних версий, например при поиске 3.1. x. Этот параметр игнорируется, если указана точная версия, например: 3.0.100-preview3-010431
    Значение по умолчанию: false
    installationPath
    Путь к установке .NET Core
    Укажите, где следует установить пакет SDK для .NET Core или среду выполнения. Различные пути могут иметь следующее воздействие на. Поведение NET.
  • $ (Agent. Тулсдиректори): позволяет кэшировать версию на агенте, так как этот каталог не очищается между конвейерами. Все конвейеры, работающие на агенте, имеют доступ к версиям, установленным ранее с помощью агента.
  • $ (Agent. TempDirectory): это может гарантировать, что конвейер не использует кэшированную версию .NET Core, так как эта папка очищается после каждого конвейера.
  • Любой другой путь. можно настроить любой другой путь, по которому процесс агента имеет доступ к пути. Это приведет к изменению состояния компьютера и влиянию всех запущенных на нем процессов.
    Обратите внимание, что можно также настроить параметр многоуровневого поиска, который может настроить проверку узла .NET для подходящей версии.
    Значение по умолчанию: $ (Agent. Тулсдиректори)/дотнет
  • performMultiLevelLookup
    Выполнить поиск на нескольких уровнях
    эти входные данные применимы только к агентам на основе Windows. Это настраивает поведение хост-процесса .NET для поиска подходящей общей платформы.
  • false: (по умолчанию) хост-процесс будет искать только версии, находящиеся в папке, указанной в этой задаче.
  • true: узел попытается выполнить поиск в предопределенных глобальных расположениях, используя Многоуровневый поиск.
    Глобальные расположения по умолчанию:
    Для Windows.
    C:/Program Files/DotNet (64-разрядные процессы)
    C:/Program Files (x86)/дотнет (32-разрядный процесс)
  • Дополнительные сведения можно прочитать здесь .

    В этом примере YAML устанавливается версия 3.1.402 .NET Core.

    steps:
    - task: UseDotNet@2
      displayName: 'Use .NET Core sdk'
      inputs:
        packageType: sdk
        version: 3.1.402
        installationPath: $(Agent.ToolsDirectory)/dotnet
    

    Открытый код

    Эта задача является открытым исходным кодом на GitHub. Отзывы и вклады приветствуются.

    Azure Pipelines

    Эта задача предназначена для получения определенной версии .NET Core из Интернета или из кэша инструментов и добавления в путь.

    Эту задачу также можно использовать для изменения версии .NET Core, используемой в последующих задачах, например в задаче CLI .NET Core.

    Еще одна причина использования установщика средств заключается в том, чтобы отвязать конвейер от наших циклов обновления, чтобы избежать разрыва конвейерного выполнения из-за изменений, внесенных в программное обеспечение агента.

    What's New

    • Поддержка установки нескольких версий параллельно.

    • Поддержка шаблонов в версии для получения последней версии в дополнительной и основной версиях. Например, теперь можно указать 3.1. x, чтобы получить Последнее исправление.

    • Выполнение многоуровневого поиска. эти входные данные применимы только к агентам на основе Windows. Он настраивает поведение хост-процесса .NET Core для поиска подходящей общей платформы на компьютере. Дополнительные сведения см. в разделе шаредфксный Поиск по нескольким уровням.

    • устанавливает NuGet версии 4.4.1 и настраивает конфигурацию прокси-сервера, если она есть в NuGet config.

    Входные данные задачи