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

Это пошаговое руководство по использованию Azure Pipelines для создания примера приложения из репозитория Git. В этом руководстве используются конвейеры YAML, настроенные с помощью редактора конвейера YAML.

Дополнительные сведения о различных разделах YAML-конвейера см. в описании pipeline в схеме Azure Pipelines YAML и в разделе Настройте ваш YAML-конвейер.

Если вместо этого вы хотите использовать классические конвейеры, см. раздел "Определение классического конвейера". Инструкции по использованию TFVC см. в статье о сборке репозиториев TFVC.

Предварительные требования — Azure DevOps

Убедитесь, что у вас есть указанные ниже компоненты.

• Учетная запись GitHub, в которой можно создать репозиторий. Создайте аккаунт бесплатно.

• Организация Azure DevOps. Создайте аккаунт бесплатно. Если у вашей команды уже есть один, убедитесь, что вы являетесь администратором проекта Azure DevOps, который вы хотите использовать.

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

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

https://github.com/MicrosoftDocs/pipelines-java

https://github.com/MicrosoftDocs/pipelines-dotnet-core

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

https://github.com/Azure-Samples/js-e2e-express-server

Просмотр конвейеров и управление ими

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

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

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

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

Выберите "Запуски" , чтобы просмотреть все запуски конвейера. При необходимости можно отфильтровать отображаемые запуски.

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

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

Просмотр сведений о конвейере

Страница сведений для конвейера позволяет просматривать и управлять этим конвейером.

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

Просмотр деталей выполнения конвейера

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

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

Задания и этапы

В области заданий отображается обзор состояния этапов и заданий. На этой панели может быть несколько вкладок в зависимости от того, содержит ли ваша платформа этапы и задания или только задания. В этом примере конвейер состоит из двух этапов сборки и развертывания. Для детализации этапов конвейера выберите задание в области этапов или заданий.

Выберите задание, чтобы просмотреть шаги для этого задания.

В интерфейсе шагов можно проверить состояние и сведения о каждом шаге. Из дополнительных действий можно переключать метки времени или просматривать необработанный журнал всех шагов в конвейере.

Отмена и повторный запуск конвейера

Если конвейер запущен, его можно отменить, нажав кнопку "Отмена". Если выполнение завершено, можно повторно запустить конвейер, нажав кнопку "Запустить новое".

Меню дополнительных действий запуска конвейера

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

Добавление индикатора состояния в репозиторий

Многие разработчики предпочитают демонстрировать высокое качество своего кода, отображая значки состояния в репозитории.

Значок статуса показывает, что поток Azure успешно выполнен.

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

1. В Azure Pipelines перейдите на страницу Pipelines, чтобы просмотреть список конвейеров. Выберите конвейер, созданный в предыдущем разделе.

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

3. Выберите значок статуса.

4. Скопируйте пример Markdown из раздела Sample Markdown.

Теперь с меткой Markdown в буфере обмена выполните следующие действия в GitHub:

1. Перейдите в список файлов и выберите Readme.md. Выберите значок карандаша для изменения.

2. Вставьте значок состояния Markdown в начале файла.

3. Зафиксируйте изменение в ветке main.

4. Обратите внимание, что индикатор состояния отображается в описании репозитория.

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

1. Перейдите в раздел "Параметры проекта" в левом нижнем углу страницы

2. Откройте вкладку "Параметры" в разделе "Конвейеры"

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

Так как вы только что изменили файл Readme.md в этом репозитории, Azure Pipelines автоматически создает код в соответствии с конфигурацией в файле azure-pipelines.yml в корне репозитория. Вернувшись в Azure Pipelines, обратите внимание, что появился новый запуск. Каждый раз, когда вы вносите изменения, в Azure Pipelines начинается новый процесс.

Мы покажем, как использовать классический редактор в Azure DevOps Server 2019 для создания сборки и релиза, которые печатают "Hello world".

1. Перейдите к Azure Repos. (Центр кода в предыдущей версии навигации)

   

2. Если ваш проект пуст, вам будет представлен экран, который поможет добавить код в репозиторий. Выберите нижний вариант, чтобы инициализировать репозиторий с readme файлом:

   

1. Перейдите к Azure Repos.

2. Добавьте файл.

   

3. В диалоговом окне назовите новый файл и создайте его.

   HelloWorld.ps1
   

4. Скопируйте и вставьте этот скрипт.

   Write-Host "Hello world"
   

5. Зафиксируйте (сохраните) файл.

1. Выберите Azure Pipelines, он должен автоматически отправить вас на страницу Builds.

   

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

   

   Для новых пользователей Azure DevOps это автоматически приведет к созданию конвейера YAML. Чтобы перейти к классическому редактору и завершить этот процесс, необходимо отключить функцию предварительного просмотра для нового интерфейса создания конвейеров YAML:

   

   

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

4. Начните с пустого задания.

5. В левой части выберите Конвейер и укажите любое имя, которое хотите использовать. Для пула агентов выберите Hosted VS2017.

6. В левой части выберите знак плюса (+), чтобы добавить задачу в задание 1. В правой части выберите категорию служебной программы, выберите задачу PowerShell из списка и нажмите кнопку "Добавить".

   

7. В левой части выберите новую задачу скрипта PowerShell .

8. Для аргумента «Путь к скрипту» нажмите кнопку , чтобы перейти к вашему репозиторию и выбрать созданный вами скрипт.

   

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

1. На вкладке "Задачи" выберите знак плюса (+), чтобы добавить задачу в задание 1.

2. Выберите категорию Utility, выберите задачу Publish Build Artifacts и нажмите Добавить.

   

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

   Имя артефакта: Введите drop.

   Место публикации артефакта: Выберите Azure Artifacts/TFS.

1. Выберите "Сохранить и очередь", а затем выберите "Сохранить и очередь".

2. В диалоговом окне нажмите «Сохранить и добавить в очередь» еще раз.

   Ставит в очередь новую сборку на агенте, размещенном корпорацией Майкрософт.

3. Вы увидите ссылку на новую сборку в верхней части страницы.

   

   Выберите ссылку, чтобы посмотреть новую сборку, как это происходит. После выделения агента вы начнете видеть журналы сборки в реальном времени. Обратите внимание, что скрипт PowerShell выполняется в рамках сборки и что "Hello world" выводится в консоль.

   

4. Перейдите к сводке сборки. На вкладке "Артефакты" сборки обратите внимание, что скрипт публикуется как артефакт.

   

Теперь вы увидите результаты изменений. Перейдите к Azure Pipelines и выберите Queued. Обратите внимание, что в разделе "Очередь" или " Запущенная " сборка автоматически активируется с помощью зафиксированного изменения.

1. Перейдите на вкладку "Конвейеры" и выберите "Выпуски".

2. Выберите действие для создания нового конвейера. Если конвейер выпуска уже создан, выберите знак плюса (+) и нажмите кнопку "Создать конвейер выпуска".

3. Выберите действие, чтобы начать с пустого задания.

4. Назовите этап QA.

5. На панели артефактов нажмите кнопку +Добавить и укажите источник (конвейер сборки). Нажмите кнопку "Добавить".

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

   

7. Перейдите на вкладку "Задачи " и выберите этап качества обслуживания.

8. Выберите знак плюса (+) для задания, чтобы добавить задачу в задание.

9. В диалоговом окне "Добавление задач" выберите "Служебная программа", найдите задачу PowerShell и нажмите кнопку "Добавить".

10. В левой части выберите новую задачу скрипта PowerShell .

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

12. Добавьте следующие аргументы:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    

13. На вкладке Конвейер выберите этап QA и выберите Клонировать.

    

14. Переименуйте клонированный этап Production.

15. Переименуйте конвейер выпуска Hello world.

    

16. Сохраните конвейер выпуска.

1. Создайте новый выпуск.

   

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

2. Откройте выпуск, который вы создали.

   

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

   

Вы узнали, как создать первый конвейер в Azure. Теперь узнайте больше о настройке конвейеров на выбранном языке:

• .NET Core
• Вперед
• Java
• Node.js
• Python
• Контейнеры

Кроме того, можно продолжить настройку созданного конвейера .

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

Дополнительные сведения о создании репозиториев GitHub см. в разделе Создание репозиториев GitHub.

Для получения информации о том, как публиковать артефакты конвейера, см. «Публикация артефактов конвейера».

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

Очистка

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

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

az pipelines list --output table

ID    Path    Name           Status    Default Queue
----  ------  -------------  --------  ------------------
6     \       FabrikamFiber  enabled   Hosted Ubuntu 1604

az pipelines delete --id 6

Are you sure you want to delete this pipeline? (y/n): y
Pipeline 6 was deleted successfully.

• Клиенты

  • Visual Studio Code для Windows, macOS и Linux
  • Visual Studio с Git для Windows или Visual Studio для Mac
  • Затмение
  • Xcode
  • IntelliJ
  • Командная строка

• Службы

  • Azure Pipelines
  • Поставщики услуг Git, такие как Azure Repos Git, GitHub и Bitbucket Cloud
  • Subversion

Как реплицировать конвейер?

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

После клонирования конвейера можно внести изменения, а затем сохранить его.

После экспорта конвейера его можно импортировать на вкладке "Все конвейеры ".

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

Как работать с черновиками?

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

Что еще можно сделать при очереди сборки?

Вы можете автоматически или вручную поставить сборки в очередь.

При ручной постановке сборки в очередь можно выполнить её однократное выполнение:

• Укажите пул, в который будет помещена сборка.

• Добавьте и измените некоторые переменные.

• Добавьте требования.

• В репозитории Git

  • Создайте ветвь или тег.

  • Создайте фиксацию.

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

• Получение источников
• задачи
• Переменные
• Триггеры
• Сохранение
• История

Как программно создать конвейер сборки?

Справочник по REST API. Создание конвейера сборки