Пошаговое руководство TeamCity: интеграция с Jira (Cloud)

TeamCity предлагает интеграцию с Jira Cloud, и в этом уроке мы подробно рассмотрим, как ее настроить.

Сначала откройте проект и выберите Edit project. Слева вы увидите ссылку Issue Trackers. Просто создайте новое подключение, выберите Jira, и TeamCity попросит вас заполнить несколько полей.

tutorials-img

Сначала заполним поле Display Name: «My Personal Jira», затем добавим URL-адрес Jira Cloud. Нужно также указать имя пользователя и пароль или токен API. Для подключения необходимо создать токен API в Jira Cloud и вставить его в TeamCity.

tutorials-img

Можно также выбрать проект Jira и подключить его к TeamCity. Мы указываем «QL» в качестве имени проекта. При желании можно автоматически выбрать все проекты Jira. Если ввести ключ проекта (в нашем случае — «QL») в сообщении коммита в TeamCity, вы получите прямую ссылку из коммита на страницу в Jira Cloud.

Если вы хотите отправлять также информацию о результате сборки (успешное завершение или ошибка) прямо в тикет Jira Cloud, нужно создать в Jira Cloud приложение OAuth и ввести идентификатор пользователя и секрет сервера Cloud.

tutorials-img

После этого можно проверить подключение.

tutorials-img

Получилось!

tutorials-img

Затем откройте конфигурацию сборки, статус которой вы хотите отправить в Jira Cloud, и перейдите в General Settings | Build configurations | Edit | Build features | Jira Cloud integration.

tutorials-img

TeamCity предложит, в какой экземпляр Jira Cloud отправлять информацию о сборке. В этом уроке у нас есть только один экземпляр — выбираем его и нажимаем Save.

tutorials-img

Теперь проверим подключение. Переходим на страницу Projects overview в TeamCity и одновременно открываем GitHub, где уже подготовлен коммит для тестирования. Для демонстрации интеграции с Jira мы создали новый файл jiratest.txt с сообщением коммита «QL-2». Отправляем его прямо в основную ветку.

tutorials-img

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

tutorials-img

Если вам нужна более подробная информация о сборке, нажмите на ее номер и в открывшемся окне прокрутите до раздела Change. По гиперссылке можно перейти прямо к задаче в Jira Cloud.

tutorials-img

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

tutorials-img

Как видите, интеграция успешно работает в обоих направлениях.

О других возможностях интеграции TeamCity читайте в этих руководствах.