Подключение сборочного сервера

• Создана: 02.10.2017
• Обновлена: 02.10.2017

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

• автоматического добавления сборки в список сборок Devprom
• публикации статуса сборки: в работе, готова, сломана, развернута и т.п.
• публикации отчетов от средств автоматизированного тестирования

Интеграция возможна с любым сервером сборки, например, Jenkins или TeamCity, и осуществялется посредством REST API

Создание сборки

Перейдите в модуль Сборки и откройте подсказку снизу, на ней приведен пример выполнения команды cURL, которая создает сборку, например:

curl -X POST -H "Devprom-Auth-Key: 714adb764994a678ab31a3e52d51c200" \
	-H "Content-Type:application/json" https://uat.myalm.ru/pm/demo/api/v1/builds \
	-d '{"Caption":"%build.number%","BuildRevision":{"Version":"%build.vcs.number%"},"State":"inprogress"}'

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

Изменение статуса сборки

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

• inprogress
• success
• failed
• deployed

Например, команда для изменения статуса сборки может иметь вид:

curl -X POST -H "Devprom-Auth-Key: 714adb764994a678ab31a3e52d51c200" \
	-H "Content-Type:application/json" https://uat.myalm.ru/pm/demo/api/v1/builds \
	-d '{"Caption":"%build.number%","State":"success"}'

Публикация отчетов о тестировании

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

Откройте модуль "Запуски тестов", откройте подсказку снизу списка и скопируйте команду, публикующую отчет по тестированию в Devprom, например,

curl -X POST -H "Devprom-Auth-Key: 714adb764994a678ab31a3e52d51c200" \
	--data-binary @testng-results.xml \
	"https://uat.myalm.ru/pm/demo/module/testing/convert?version=%build.number%&environment=<название-окружения>"

В ключе --data-binary необходимо указать путь к файлу с результатами тестирования. Приложение поддерживает импорт отчетов NUnit, TestNG.