Сборка, тестирование и развертывание приложений .NET Core

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Используйте Azure Pipeline для автоматического создания, тестирования и развертывания проектов .NET Core. В этой статье показано, как выполнять следующие задачи:

• Настройте среду сборки с помощью размещенных корпорацией Майкрософт или локальных агентов.
• Восстановление зависимостей, сборка проекта и тестирование с помощью задачи .NET Core (DotNetCoreCLI@2) или скрипта.
• Протестируйте код и используйте задачу покрытия кода публикации для публикации результатов покрытия кода.
• Упаковка и доставка выходных данных сборки:
  • конвейер.
  • веб-канал NuGet.
  • .zip файл для развертывания веб-приложения в Azure.

Примечание.

Сведения о платформа .NET Framework проектах см. в статье "Создание приложений ASP.NET с помощью платформа .NET Framework".

Необходимые компоненты

• Учетная запись GitHub, в которой можно создать репозиторий. Создайте ее бесплатно.
• Организация и проект Azure DevOps. Создайте ее бесплатно.
• Возможность запуска конвейеров на размещенных агентах Майкрософт. Вы можете приобрести параллельное задание или запросить уровень "Бесплатный".

Создание первого конвейера

Вы не знакомы с Azure Pipelines? В этом случае рекомендуется сначала попробовать следующий раздел.

Создание проекта .NET.

Если у вас нет проекта .NET для работы, создайте новый проект в локальной системе. Начните с установки последнего пакета SDK для .NET 8.0.

1. Откройте окно терминала.

2. Создайте каталог проекта и перейдите к нему.

3. Создайте веб-приложение .NET 8.

   dotnet new webapp -f net8.0
   

4. В том же сеансе терминала запустите приложение локально с помощью dotnet run команды из каталога проекта.

   dotnet run
   

5. После запуска приложения нажмите клавиши CTRL-C, чтобы завершить работу приложения.

Создание репозитория Git и его подключение к GitHub

1. В каталоге проекта создайте локальный репозиторий Git и зафиксируйте код приложения в главной ветви.

2. Подключите локальный репозиторий Git к репозиторию GitHub.

Создание проекта DevOps

Войдите в Azure Pipelines. После входа в браузере откроется https://dev.azure.com/my-organization-name и отобразится панель мониторинга Azure DevOps.

1. В браузере перейдите к dev.azure.com и войдите в систему.
2. Выберите свою организацию.
3. Создайте новый проект, выбрав новый проект или создав проект при создании первого проекта в организации.
4. Заполните поле Имя проекта.
5. Выберите видимость проекта.
6. Нажмите кнопку создания.

1. В браузере перейдите на сервер Azure DevOps Server.
2. Выберите коллекцию.
3. Создайте новый проект, выбрав новый проект или создав проект при создании первого проекта в коллекции.
4. Заполните поле Имя проекта.
5. Выберите видимость проекта.
6. Нажмите кнопку создания.

Настройка среды сборки

Сборки выполняются в агентах, размещенных корпорацией Майкрософт. Вы можете создавать проекты .NET Core с помощью пакета SDK для .NET Core и среды выполнения в Windows, Linux и macOS.

Кроме того, можно использовать локальный агент. С помощью локального агента можно использовать предварительные версии или частные пакеты SDK, которые официально не поддерживаются Azure DevOps Services и запускать добавочные сборки.

Создание конвейера

Для создания конвейера можно использовать редактор конвейера YAML или классический редактор. Чтобы использовать классический редактор, выберите "Использовать классический редактор".

YAML

Создание конвейера и выбор источника

1. Войдите в свою организацию Azure DevOps и откройте нужный проект.

2. Перейдите к конвейерам и выберите "Создать конвейер" или "Создать конвейер" при создании первого конвейера.

3. Выполните все шаги мастера, выбрав GitHub в качестве расположения исходного кода.

4. Возможно, вам придется выполнить вход в GitHub. Для этого введите учетные данные GitHub.

5. Когда появится список репозиториев, выберите свой.

6. Вы можете перенаправиться на GitHub, чтобы установить приложение Azure Pipelines. В этом случае выберите " Утвердить" и "Установить".

Настройка конвейера

1. Когда появится вкладка "Настройка", выберите "Показать больше" и выберите шаблон конвейера ASP.NET Core из списка.

2. Проверьте новый конвейер, чтобы узнать, что делает YAML.

Вы можете настроить YAML-файл для ваших требований. Например, можно указать пул агентов или добавить задачу для установки другого пакета SDK для .NET.

Сохранение и запуск конвейера

1. Когда будете готовы, выберите Сохранить и запустить.

   

2. При необходимости можно изменить сообщение фиксации.

3. Зафиксируйте новый файл azure-pipelines.yml в репозиторий, нажав кнопку "Сохранить и запустить".

4. Чтобы просмотреть конвейер в действии, выберите задание в разделе "Задания ".

Классическое

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

Создание конвейера

1. Перейдите в проект и выберите "Конвейеры".

2. Выберите "Создать конвейер" или "Создать конвейер", если вы не создаете первый конвейер для этого проекта.

3. Выберите "Использовать классический редактор".

Выбор источника

1. Выберите источник. В этом примере выберите GitHub.
2. Введите учетные данные GitHub, чтобы создать подключение службы GitHub для использования в конвейере.
3. Выберите репозиторий и нажмите кнопку "Продолжить".

Настройка конвейера

1. В разделе "Выбор шаблона" найдите и выберите ASP.NET Core.

   Откроется страница конвейера, в которой можно настроить конвейер. Здесь можно добавить задачи, указать пулы агентов и агенты и настроить другие параметры сборки.

2. На вкладке "Задачи" выберите пул агентов (обычно по умолчанию)

3. Выберите спецификацию агента. В этом примере выберите windows-latest.

   Вы можете добавить другие задачи в задание агента, выбрав + задание агента и выбрав другую задачу из каталога. Например, может потребоваться добавить задачу Use .NET Core в качестве первой задачи, чтобы установить необходимую версию пакета SDK для .NET.

Сохранение и запуск конвейера

1. Выберите "Сохранить и очередь" в раскрывающемся списке "Сохранить и очередь" в верхней части страницы.
2. В конвейере выполнения введите комментарий и нажмите кнопку "Сохранить и запустить".

Конвейер можно увидеть в действии, выбрав задание из раздела "Задания " на вкладке "Сводка ".

Теперь у вас есть рабочий конвейер, готовый к настройке! Дополнительные сведения о некоторых распространенных способах настройки конвейера.

Среда сборки

Azure Pipelines можно использовать для создания проектов .NET Core в Windows, Linux или macOS без необходимости настройки инфраструктуры.

Например, Ubuntu устанавливается здесь в файле YAML конвейера.

pool:
  vmImage: 'ubuntu-latest' 

Полный список образов и дополнительных примеров конфигурации см . в размещенных майкрософт агентах .

Размещенные корпорацией Майкрософт агенты в Azure Pipelines включают несколько предварительно установленных версий поддерживаемых пакетов SDK для .NET Core. Агенты, размещенные корпорацией Майкрософт, не включают некоторые из старых версий пакета SDK для .NET Core. Они также обычно не включают предварительные версии. Если вам нужны эти версии пакета SDK для агентов, размещенных корпорацией Майкрософт, установите их с помощью задачи UseDotNet@2 .

Например, чтобы установить пакет SDK 5.0.x, добавьте следующий фрагмент кода:

steps:
- task: UseDotNet@2
  inputs:
    version: '5.x'

Агенты Windows уже включают среду выполнения .NET Core. Чтобы установить новый пакет SDK, задайте performMultiLevelLookup для true следующего фрагмента кода:

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 8.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

Совет

Чтобы сэкономить затраты на запуск установщика инструментов, можно настроить локальный агент Linux, macOS или Windows. Вы также можете использовать автономные агенты для экономии дополнительного времени, если у вас есть большой репозиторий или выполняется добавочная сборка. Локальный агент также может помочь вам использовать предварительные версии или частные пакеты SDK, которые официально не поддерживаются Azure DevOps или доступны только в корпоративных или локальных средах.

Восстановить зависимости

NuGet — это популярный способ зависеть от кода, который вы не создаете. Вы можете скачать пакеты NuGet и инструменты для конкретного проекта, указанные в файле проекта, выполнив dotnet restore команду с помощью задачи .NET Core или непосредственно в скрипте в конвейере. Дополнительные сведения см. в статье о задаче .NET Core (DotNetCoreCLI@2).

Пакеты NuGet можно скачать из Артефактов Azure, NuGet.org или другого внешнего или внутреннего репозитория NuGet. Задача .NET Core особенно полезна для восстановления пакетов из проверенных веб-каналов NuGet. Если веб-канал находится в том же проекте, что и конвейер, вам не нужно проходить проверку подлинности.

Этот конвейер использует веб-канал dotnet restore Артефакта Azure для задачи DotNetCoreCLI@2 .

trigger:
- main

pool:
  vmImage: 'windows-latest'

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 8.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-vsts-feed' # A series of numbers and letters

- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    arguments: '--configuration $(buildConfiguration)'
  displayName: 'dotnet build $(buildConfiguration)'

Команда dotnet restore использует NuGet.exe пакет с пакетом пакета SDK для .NET Core и может восстанавливать только пакеты, указанные в файлах проекта .csproj .NET Core.

Если в решении также есть проект Microsoft платформа .NET Framework или используется package.json для указания зависимостей, используйте задачу NuGet для восстановления этих зависимостей.

- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '**/*.sln'
    feedsToUse: 'select'

Примечание.

Если вы используете Ubuntu 24.04 или более поздней версии, необходимо использовать задачу NuGetAuthenticate с .NET CLI вместо задачи NuGetCommand@2. Дополнительные сведения см. в разделе о поддержке новых размещенных образов Ubuntu.

В пакете SDK для .NET Core версии 2.0 и более поздних версий пакеты восстанавливаются автоматически при выполнении таких dotnet buildкоманд. Однако вам по-прежнему потребуется использовать задачу .NET Core для восстановления пакетов, если вы используете веб-канал, прошедший проверку подлинности.

Сборки могут завершиться ошибкой из-за проблем с подключением при восстановлении пакетов из NuGet.org. Для кэширования пакетов можно использовать артефакты Azure с вышестоящими источниками . Учетные данные конвейера автоматически используются при подключении к Артефактам Azure. Эти учетные данные обычно являются производными от учетной записи службы сборки коллекции проектов. Дополнительные сведения об использовании артефактов Azure для кэширования пакетов NuGet см. в статье "Подключение к веб-каналам артефактов Azure".

Чтобы указать репозиторий NuGet, поместите URL-адрес в NuGet.config файл в репозиторий. Если веб-канал проходит проверку подлинности, управляйте учетными данными, создав подключение службы NuGet на вкладке "Службы " в разделе "Параметры проекта".

При использовании агентов, размещенных корпорацией Майкрософт, вы получаете новый компьютер при каждом запуске сборки, который восстанавливает пакеты при каждом запуске. Восстановление может занять значительное время. Чтобы устранить проблему, можно использовать Azure Artifacts или локальный агент с преимуществом использования кэша пакетов.

Дополнительные сведения о подключениях к службе NuGet см. в публикации в веб-каналах NuGet.

Восстановление пакетов из внешнего веб-канала

Выполните следующие действия, чтобы восстановить пакеты из внешнего веб-канала.

YAML

Вы можете добавить команду восстановления в конвейер с помощью редактора конвейера YAML, вставьте следующий фрагмент кода в azure-pipelines.yml файл или с помощью помощника по задачам для добавления задачи .NET Core .

# do this before your build tasks
steps:
- task: DotNetCoreCLI@2
  displayName: Restore
  inputs:
    command: restore
    projects: '**/*.csproj'
    feedsToUse: config
    nugetConfigPath: NuGet.config    # Relative to root of the repository
    externalFeedCredentials: <Name of the NuGet service connection>

Замените <заполнитель> именем подключения службы.

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

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

1. Перейдите в положение в YAML-файле, где вы хотите вставить задачу.

2. Выберите .NET Core из каталога задач.

3. Выберите команду восстановления из раскрывающегося списка команд.

4. В поле "Путь к проектам" введите путь к .csproj файлам.

5. Выберите Добавить.

6. Нажмите кнопку "Сохранить", чтобы зафиксировать изменение.

Классическое

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

1. Выберите задачи в конвейере и выберите задание, которое выполняет задачи сборки.

2. Выберите + , чтобы добавить новую задачу в это задание.

3. В каталоге задач найдите и выберите задачу .NET Core и нажмите кнопку "Добавить".

4. Выберите задачу, чтобы открыть редактор задач.

5. Выберите восстановление в списке команд и укажите другие параметры, необходимые для этой задачи.

6. В списке задач перетащите задачу, чтобы разместить ее перед задачей сборки.

7. В раскрывающемся списке "Сохранить" и "Очередь " выберите параметр для сохранения изменения.

Примечание.

Убедитесь, что в файле указан NuGet.config пользовательский веб-канал, а учетные данные указаны в подключении службы NuGet.

Сборка проекта

Создайте проекты .NET Core, выполнив dotnet build команду. Вы можете добавить команду в конвейер в качестве скрипта командной строки или с помощью задачи .NET Core.

Сборка .NET Core с помощью задачи .NET Core

Пример YAML для сборки с помощью задачи DotNetCoreCLI@2:

steps:
- task: DotNetCoreCLI@2
  displayName: Build
  inputs:
    command: build
    projects: '**/*.csproj'
    arguments: '--configuration $(buildConfiguration)' # Update this to match your needs

YAML

Вы можете добавить задачу сборки с помощью редактора конвейера YAML, непосредственно изменив файл или добавив задачу .NET Core с помощью помощника по задачам.

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

1. Перейдите в положение в YAML-файле, где вы хотите вставить задачу.

2. Выберите .NET Core из каталога задач.

3. Выберите команду сборки из раскрывающегося списка команд.

4. В поле "Путь к проектам" введите путь к .csproj файлам.

5. Выберите Добавить.

6. Нажмите кнопку "Сохранить", чтобы зафиксировать изменение.

Классическое

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

1. Выберите "Задачи " в конвейере.

2. Выберите задание, которое выполняет задачи сборки.

3. Выберите + , чтобы добавить новую задачу в это задание.

4. В каталоге задач найдите и добавьте задачу .NET Core .

5. Выберите задачу и выберите сборкуиз раскрывающегося списка команд .

6. В поле "Путь к проектам" введите путь к .csproj файлам.

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

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

Сборка .NET Core с помощью скрипта командной строки

Пример YAML для сборки с помощью dotnet build скрипта:

steps:
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

YAML

Вы можете добавить задачу сборки с помощью редактора конвейера YAML, непосредственно изменив файл или добавив задачу командной строки .

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

1. Перейдите в положение в YAML-файле, где вы хотите вставить задачу.

2. Выберите командную строку из каталога задач.

3. При необходимости добавьте отображаемое имя.

4. Введите команду с параметрами dotnet build . Например, dotnet build --configuration $(buildConfiguration).

5. Введите путь к .csproj файлу в качестве рабочего каталога.

6. Выберите Добавить.

7. Нажмите кнопку "Сохранить", чтобы зафиксировать изменение.

Классическое

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

1. Выберите "Задачи " в конвейере.

2. Выберите задание, которое выполняет задачи сборки.

3. Выберите + , чтобы добавить новую задачу в это задание.

4. В каталоге задач найдите и добавьте задачу командной строки .

5. При необходимости добавьте отображаемое имя.

6. Введите команду с параметрами dotnet build . Например, dotnet build --configuration $(buildConfiguration).

7. Введите путь к .csproj файлу в качестве рабочего каталога.

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

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

Добавление команд ПАКЕТА SDK для .NET в конвейер

Команды SDK для .NET можно добавить в проект в качестве скрипта или с помощью задачи .NET Core. Задача .NET Core (DotNetCoreCLI@2) позволяет легко добавлять команды dotnet CLI в конвейер. Задачи .NET Core можно добавить, изменив файл YAML или используя классический редактор.

Добавление команды .NET CLI с помощью задачи .NET Core

YAML

Чтобы добавить команду CLI .NET Core с помощью редактора конвейера YAML, сделайте следующее:

1. Перейдите в положение в YAML-файле, где вы хотите вставить задачу.

2. Выберите .NET Core из каталога задач.

3. Выберите команду, которую вы хотите выполнить.

4. Настройте все необходимые параметры.

5. Выберите Добавить.

6. Нажмите кнопку "Сохранить", чтобы зафиксировать изменение.

Классическое

Чтобы добавить задачу .NET Core с помощью классического редактора, сделайте следующее:

1. Выберите "Задачи " в конвейере.

2. Выберите задание, которое выполняет задачи сборки.

3. Выберите + , чтобы добавить новую задачу в это задание.

4. В каталоге задач найдите и добавьте задачу .NET Core .

5. Выберите задачу и выберите команду , которую вы хотите запустить.

6. Настройте все необходимые параметры.

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

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

Добавление команды .NET Core CLI с помощью скрипта

Команды CLI .NET Core можно добавить в script файл.azure-pipelines.yml

Пример:

steps:
# ...
- script: dotnet test <test-project> 

Установка средства

Чтобы установить глобальное средство .NET Core, например dotnetsay в сборке, работающей в Windows, сделайте следующее:

1. Добавьте задачу .NET Core и задайте следующие свойства:
   • Команда: custom.
     • Путь к проектам: оставьте пустым.
   • Настраиваемая команда: инструмент.
   • Аргументы: install -g dotnetsay.
2. Чтобы запустить средство, добавьте командную строку и задайте следующие свойства:
   • Скрипт:dotnetsay.

Запуск тестов

При наличии тестовых проектов в репозитории можно использовать задачу .NET Core для выполнения модульных тестов с помощью платформ тестирования, таких как MSTest, xUnit и NUnit. Тестовый проект должен ссылаться на Microsoft.NET.Test.SDK версии 15.8.0 или более поздней. Результаты теста автоматически публикуются в службе. Эти результаты доступны в сводке сборки и могут использоваться для устранения неполадок неудачных тестов и анализа времени тестирования.

Вы можете добавить тестовую задачу в конвейер с помощью задачи DotNetCoreCLI@2 или добавить следующий фрагмент кода в azure-pipelines.yml файл:

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration)'

При использовании редактора задач .NET Core задайте команду для тестирования и пути к проектам, которые должны ссылаться на тестовые проекты в решении.

Кроме того, можно выполнить dotnet test команду с определенным средством ведения журнала, а затем использовать задачу "Опубликовать результаты теста".

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx
- task: PublishTestResults@2
  condition: succeededOrFailed()
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

Сбор покрытия кода

При создании на платформе Windows метрики покрытия кода можно собирать с помощью встроенного сборщика данных покрытия. Тестовый проект должен ссылаться на Microsoft.NET.Test.SDK версии 15.8.0 или более поздней.

При использовании задачи .NET Core для выполнения тестов данные покрытия автоматически публикуются на сервере. Файл .coverage можно скачать из сводки сборки для просмотра в Visual Studio.

Добавьте следующий фрагмент кода в azure-pipelines.yml файл:

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration) --collect "Code Coverage"'

Чтобы добавить задачу .NET Core через редактор задач, выполните следующие действия.

1. Добавьте задачу .NET Core в задание сборки и задайте следующие свойства:

   1. Команда: тест.
   2. Путь к проектам: должен ссылаться на тестовые проекты в решении.
   3. Аргументы: --configuration $(BuildConfiguration) --collect "Code Coverage".

2. Убедитесь, что параметр "Опубликовать результаты теста" остается выбранным.

Если вы решили выполнить dotnet test команду, укажите параметры ведения журнала результатов теста и покрытия. Затем используйте задачу "Опубликовать результаты теста":

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx --collect "Code Coverage"
- task: PublishTestResults@2
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

Сбор метрик покрытия кода с помощью Coverlet

Если вы используете Linux или macOS, можно использовать обложку или аналогичное средство для сбора метрик покрытия кода.

Результаты покрытия кода можно опубликовать на сервере, используя задачу Публикация результатов покрытия кода (PublishCodeCoverageResults@2). Средство покрытия должно быть настроено для создания результатов в формате покрытия Cobertura или JaCoCo.

Чтобы выполнить тесты и опубликовать покрытие кода с помощью Coverlet, выполните следующие задачи:

• Добавьте ссылку на пакет NuGet coverlet.collector.

• Добавьте следующий фрагмент кода в azure-pipelines.yml файл:

  - task: UseDotNet@2
    inputs:
      version: '8.x'
      includePreviewVersions: true # Required for preview versions
  
  - task: DotNetCoreCLI@2
    displayName: 'dotnet build'
    inputs:
      command: 'build'
      configuration: $(buildConfiguration)
  
  - task: DotNetCoreCLI@2
    displayName: 'dotnet test'
    inputs:
      command: 'test'
      arguments: '--configuration $(buildConfiguration) --collect:"XPlat Code Coverage" -- DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Format=cobertura'
      publishTestResults: true
      projects: 'MyTestLibrary' # update with your test project directory
  
  - task: PublishCodeCoverageResults@2
    displayName: 'Publish code coverage report'
    inputs:
      codeCoverageTool: 'Cobertura'
      summaryFileLocation: '$(Agent.TempDirectory)/**/coverage.cobertura.xml'
  

Упаковка и доставка кода

Артефакты сборки можно опубликовать следующими способами:

• Публикация в Azure Pipelines.
• Публикация пакетов в Azure Artifacts.
• Создание пакета NuGet и публикация в веб-канале NuGet.
• Создание архива .zip для развертывания веб-приложения.

Публикация артефактов в Azure Pipelines

Чтобы опубликовать выходные данные сборки .NET в конвейере, выполните следующие задачи:

• Запустите dotnet publish --output $(Build.ArtifactStagingDirectory) интерфейс командной строки .NET или добавьте задачу DotNetCoreCLI@2 с помощью команды публикации.
• Опубликуйте артефакт с помощью задачи "Публикация артефакта конвейера".

Добавьте следующий фрагмент кода в azure-pipelines.yml файл:

steps:

- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

# this code takes all the files in $(Build.ArtifactStagingDirectory) and uploads them as an artifact of your build.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)' 
    artifactName: 'myWebsite'

Примечание.

Задача DotNetCoreCLI@2 имеет входные publishWebProjects данные, которые по умолчанию имеют значение true . Эта задача публикует все веб-проекты в репозитории по умолчанию. Дополнительные сведения и справку можно найти в задаче открытый код на сайте GitHub.

Чтобы скопировать дополнительные файлы в каталог сборки перед публикацией, используйте задачу копирования файлов (CopyFile@2).

Публикация в веб-канале NuGet

Чтобы создать пакет NuGet и опубликовать его в веб-канале NuGet, добавьте следующий фрагмент кода:

steps:
# ...
# do this near the end of your pipeline in most cases
- script: dotnet pack /p:PackageVersion=$(version)  # define version variable elsewhere in your pipeline
- task: NuGetAuthenticate@1
  inputs:
    nuGetServiceConnections: '<Name of the NuGet service connection>'
- task: NuGetCommand@2
  inputs:
    command: push
    nuGetFeedType: external
    publishFeedCredentials: '<Name of the NuGet service connection>'
    versioningScheme: byEnvVar
    versionEnvVar: version

Примечание.

Задача NuGetAuthenticate@1 не поддерживает проверку подлинности ключа API NuGet. Если вы используете ключ API NuGet, используйте задачу NuGetCommand@2 с входным набором с command аргументом push. Например, dotnet nuget push --api-key $(NuGetApiKey).

Дополнительные сведения об использовании версий и публикации пакетов NuGet см. в статье "Публикация в веб-каналах NuGet".

Публикация пакета NuGet в Артефактах Azure

Пакеты NuGet можно опубликовать в веб-канале Артефактов Azure с помощью NuGetCommand@2 для отправки в веб-канал Артефакта Azure. Например, см. статью "Публикация пакетов NuGet с помощью Azure Pipelines".

Развертывание веб-приложения

Чтобы создать архив файла .zip, готовый к публикации в веб-приложении, добавьте следующий фрагмент кода:

steps:
# ...
# do this after you've built your app, near the end of your pipeline in most cases
# for example, you do this before you deploy to an Azure web app on Windows
- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

Сведения о публикации этого архива в веб-приложении см. в статье веб-приложения развертывании Azure.

Создание образа и отправка в реестр контейнеров

Вы также можете создать образ для приложения и отправить его в реестр контейнеров.

Публикация символов

Задачу PublishSymbols@2 можно использовать для публикации символов на сервере символов Azure Artifacts или общей папке.

Например, чтобы опубликовать символы в общей папке, добавьте следующий фрагмент кода в azure-pipelines.yml файл:

- task: PublishSymbols@2
  inputs:
    SymbolsFolder: '$(Build.SourcesDirectory)'
    SearchPattern: '**/bin/**/*.pdb'
    IndexSources: true
    PublishSymbols: true
    SymbolServerType: 'FileShare' 
    SymbolsPath: '\\server\shareName'

При использовании классического редактора выберите источники индекса, чтобы добавить в конвейер символы из каталога задач.

Дополнительные сведения см. в разделе "Публикация символов".

Устранение неполадок

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

• Предварительные версии пакета SDK для .NET Core не устанавливаются в агенты, размещенные корпорацией Майкрософт. После выпуска новой версии пакета SDK для .NET Core может потребоваться несколько недель, чтобы развернуть все центры обработки данных Azure Pipelines. Вам не нужно ждать завершения этого развертывания. Вы можете использовать задачу .NET Core для установки версии пакета SDK для .NET Core , которую вы хотите использовать в агентах, размещенных в Майкрософт.

• Проверьте версии пакета SDK для .NET Core и среду выполнения на компьютере разработки и убедитесь, что они соответствуют агенту. Скрипт командной строки dotnet --version можно включить в конвейер, чтобы распечатать версию пакета SDK для .NET Core. Используйте установщик средств .NET Core для развертывания той же версии на агенте или обновите проекты и компьютер разработки до более новой версии пакета SDK для .NET Core.

• Возможно, вы используете некоторую логику в интегрированной среде разработки Visual Studio, которая не закодирована в конвейере. Azure Pipelines выполняет каждую из команд, указанных в задачах после другой в новом процессе. Просмотрите журналы из сборки конвейеров, чтобы увидеть точные команды, которые выполнялись как часть сборки. Повторите те же команды в том же порядке на компьютере разработки, чтобы найти проблему.

• Если у вас есть смешанное решение, включающее некоторые проекты .NET Core и некоторые платформа .NET Framework проекты, необходимо также использовать задачу NuGet для восстановления пакетов, указанных в packages.config файлах. Добавьте задачу сборки MSBuild или Visual Studio, чтобы создать проекты платформа .NET Framework.

• Сборки могут завершиться сбоем при восстановлении пакетов: NuGet.org возникают проблемы или возникают проблемы с сетью между центром обработки данных Azure и NuGet.org. Вы можете изучить, улучшает ли использование артефактов Azure с NuGet.org в качестве вышестоящего источника, так как он не находится в нашем элементе управления.

• Иногда при развертывании новой версии пакета SDK для .NET Core или Visual Studio сборка может нарушиться. Например, более новая версия или функция средства NuGet поставляется с пакетом SDK, может нарушить сборку. Чтобы изолировать эту проблему, используйте задачу установщика инструментов .NET Core, чтобы указать версию пакета SDK для .NET Core, используемого в сборке.

Вопросы и ответы

Вопрос. Где можно узнать больше о артефактах Azure?

Ответ. Управление пакетами в артефактах Azure

Вопрос. Где можно узнать больше о командах .NET Core?

Ответ. Средства командной строки .NET Core

Вопрос. Где можно узнать больше о выполнении тестов в моем решении?

Ответ. Модульное тестирование в проектах .NET Core

Вопрос. Где можно узнать больше о задачах?

Ответ. Создание и выпуск задач