Интеграция с TeamCity с помощью allurectl

Интеграция с TeamCity с помощью allurectl позволяет автоматически передавать результаты тестов из сборок TeamCity в ТестОпс.

Совет

Интеграция с TeamCity с помощью allurectl — ограниченный вариант интеграции, который не поддерживает запуск сборок TeamCity из интерфейса ТестОпс.

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

Настройка интеграции с TeamCity с помощью allurectl

Чтобы настроить интеграцию с TeamCity с помощью allurectl:

1. Создайте API-токен в ТестОпс.
2. Укажите созданный API-токен и другие переменные окружения в настройках проекта или сборки TeamCity.
3. Измените шаг сборки в TeamCity, чтобы он включал запуск allurectl для загрузки результатов тестов.

1. Создайте API-токен в ТестОпс

1. Перейдите в ваш инстанс ТестОпс.

2. Нажмите на ваш аватар и перейдите в раздел API-токены.

3. Нажмите + Токен.

4. Введите название токена, которое поможет вам распознать интеграцию (например, Токен для TeamCity).

5. Нажмите Создать.

   ТестОпс сгенерирует токен и отобразит его в модальном окне.

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

   Cохраните токен в безопасном месте, он понадобится для настройки интеграции в TeamCity.

7. Нажмите Готово.

2. Укажите переменные окружения в TeamCity

1. Перейдите в ваш инстанс TeamCity.

2. Откройте настройки вашего проекта или конфигурации сборки.

3. Перейдите на вкладки Parameters → Input Parameters.

4. Нажмите Add new parameter и добавьте переменные окружения (environment variable):

   Имя	Значение
   env.ALLURE_CI_TYPE	teamcity
   env.ALLURE_ENDPOINT	URL-адрес вашего инстанса ТестОпс. Пример: https://testops.example.com
   env.ALLURE_JOB_NAME	%system.teamcity.buildConfName%
   env.ALLURE_JOB_RUN_NAME	%system.teamcity.build.id%
   env.ALLURE_JOB_RUN_UID	%system.teamcity.build.id%
   env.ALLURE_JOB_RUN_URL	https://<URL-адрес вашего инстанса TeamCity>/viewLog.html?buildId=%system.teamcity.build.id%. Пример: https://teamcity.example.com/viewLog.html?buildId=%system.teamcity.build.id%
   env.ALLURE_JOB_UID	%system.teamcity.buildType.id%
   env.ALLURE_LAUNCH_NAME	Запуск TeamCity с помощью allurectl - %system.build.number%
   env.ALLURE_PROJECT_ID	ID вашего проекта ТестОпс
   env.ALLURE_RESULTS	Путь к директории с результатами тестов. Пример: build/allure-results
   env.ALLURE_TOKEN	API-токен, который вы сохранили на шаге 1

3. Измените шаг сборки в TeamCity

1. В TeamCity откройте настройки вашей сборки.

2. Перейдите на вкладку Build steps.

3. Напротив шага сборки с типом Command Line нажмите Edit.

4. Измените сборочный скрипт, обернув команду, запускающую тесты, в вызов allurectl.

   Пример

   Если вы используете Gradle для запуска тестов, замените строку запуска тестов:

   ./gradlew clean test

   на строки:

   curl -fsSL https://github.com/allure-framework/allurectl/releases/latest/download/allurectl_linux_amd64 -o allurectl
   chmod +x allurectl
   ./allurectl watch -- ./gradlew clean test