Интеграция с Bamboo

Интеграция с Bamboo позволяет настроить следующие связи:

• одна джоба в ТестОпс соответствует одному плану Bamboo,
• один запуск джобы ТестОпс соответствует одной сборке Bamboo (набору джоб в Bamboo).

Новая сборка Bamboo может быть запущена либо ТестОпс, либо самим Bamboo, при этом обе стороны отображают ее статус в своих веб-интерфейсах.

Во время выполнения тестов плагин ТестОпс для Bamboo регулярно сканирует новые файлы в директории с результатами тестов (например, build/allure-results, см. Allure Report → Как это работает). Для каждого нового файла плагин немного ждет (чтобы избежать загрузки наполовину записанных файлов), затем загружает файл на сервер ТестОпс. Таким образом ТестОпс получает результаты тестов как можно скорее и может показать частичные результаты запуска еще до завершения джобы.

Чтобы включить поддержку Allure на вашем сервере Bamboo:

1. Установите плагин для Bamboo.
2. Включите отправку данных из Bamboo.
3. Включите запуск сборок Bamboo.
4. Параметризуйте джобы Bamboo (если необходимо).

Важно

В настоящее время плагин для Bamboo не поддерживает инстансы ТестОпс с самоподписанными сертификатами.

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

1. Установите плагин для Bamboo

1. В веб-интерфейсе Bamboo нажмите на значок шестеренки в правом верхнем углу и выберите Manage apps.

2. Нажмите Find new apps.

3. Используя поле поиска, найдите плагин Allure TestOps for Bamboo.

4. Нажмите Install рядом с плагином.

5. В появившемся окне нажмите Install, затем Accept & install.

   Подождите, пока плагин загрузится и установится.

2. Включите отправку данных из Bamboo

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

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

1. В ТестОпс нажмите на ваш аватар и перейдите в Ваш профиль.
2. В разделе API-токены нажмите + Токен.
3. Введите Название токена (например, Токен для Bamboo), затем нажмите Отправить.
4. В появившемся окне нажмите значок Копировать, чтобы скопировать токен в буфер обмена. Этот токен понадобится вам на следующем шаге.

2.2. Измените настройки плана в Bamboo

1. В панели управления Bamboo перейдите к вашему плану сборки.

2. Нажмите Actions → Configure plan.

3. Перейдите на вкладку Other.

4. В разделе Allure Upload заполните поля:

   • Enable Allure Upload— должно быть отмечено.
   • Server endpoint URL — URL-адрес сервера ТестОпс, например, https://allure.example.com/.
   • Server token — API-токен, который вы получили на шаге 2.1.
   • Project ID — название проекта в ТестОпс.
   • Launch name — шаблон для именования запусков тестов. В этом поле можно использовать переменные Bamboo.
   • Launch tags — список тегов, которые должны быть присвоены запуску тестов (через запятую).

5. Нажмите Save.

2.3. Укажите директорию с результатами тестов

1. В панели управления Bamboo перейдите к вашему плану сборки.

2. Нажмите Actions → Configure plan.

3. Нажмите на джобу, которая запускает тесты.

4. Перейдите на вкладку Other.

5. В поле Test Results Directories укажите путь к директории с результатами тестов, например, build/allure-results.

   Если в вашем проекте несколько директорий с результатами тестов, вы можете разделить их запятыми или использовать шаблон с подстановочными символами, например, modules/*/build/allure-results.

6. Нажмите Save.

3. Включите запуск сборок Bamboo

Интеграция с Bamboo должна быть настроена на двух уровнях.

Сначала администратор должен указать URL-адрес сервера Bamboo.

Затем владелец проекта должен добавить свои учетные данные Bamboo в проект ТестОпс и добавить джобу в ТестОпс.

3.1. Укажите сервер Bamboo в ТестОпс

1. Войдите в ТестОпс, используя учетную запись администратора.

2. Перейдите в раздел Администрирование → Интеграции.

3. Нажмите + Добавить интеграцию в правом верхнем углу страницы.

4. В появившемся окне выберите Bamboo CI Server.

5. Заполните поля:

   • Название — название, которое поможет вам распознать сервер Bamboo, например, Bamboo production.
   • Endpoint — URL-адрес сервера Bamboo, например, https://bamboo.example.com/.

6. Если ваш сервер Bamboo использует самоподписанный SSL-сертификат, поставьте галочку Disable certificate validation.

7. Нажмите Добавить интеграцию.

3.2. Добавьте учетные данные Bamboo в проект ТестОпс

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Интеграции.

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

4. В появившемся окне введите Имя пользователя и Пароль учетной записи Bamboo.

   Совет

   Проверьте правильность учетных данных

   Нажмите Проверить соединение. Через несколько секунд должно появиться сообщение “Соединение установлено”.

5. Нажмите Добавить интеграцию, чтобы сохранить настройки и закрыть окно.

3.3. Добавьте новую джобу в ТестОпс

Самый простой и надежный способ создать джобу в ТестОпс — выполнить пайплайн Bamboo, загрузить результаты тестов в ТестОпс, а затем закрыть созданный запуск.

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

Создайте новую джобу вручную

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Джобы.

3. Нажмите + Джоба в правом верхнем углу страницы.

4. В появившемся окне заполните поля:

   • Сервер сборки — название сервера Bamboo, который вы добавили на шаге 3.1.
   • Может выполнять тесты — если отмечено, пользователи смогут запускать эту джобу из интерфейса Тест-кейсов.
   • Джоба — название проекта Bamboo. Обратите внимание, что вы не можете добавить один и тот же проект Bamboo в ТестОпс дважды.
   • Параметры — параметры, которые должны быть переданы в Bamboo через переменные окружения, см. Окружение.

5. Нажмите Отправить.

3.4. Включите поддержку тест-планов в джобе Bamboo

1. В панели управления Bamboo перейдите к вашему плану сборки.

2. Нажмите Actions → Configure plan.

3. Нажмите на джобу, которая запускает тесты.

4. В списке джоб выберите ту, которая запускает тесты.

   Например, во многих проектах это будет джоба Script с командой, специфичной для фреймворка.

5. В поле Environment variables введите: ALLURE_TESTPLAN_PATH=${bamboo.ALLURE_TESTPLAN_PATH}.

   

6. Нажмите Save.

4. Параметризуйте джобы Bamboo

Bamboo использует переменные для передачи параметров в сборки. ТестОпс интегрирует эту функцию с собственной концепцией Окружения, что позволяет вам как задавать параметры для новых джоб, так и видеть параметры, установленные для джоб, запущенных вне ТестОпс.

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

Важно

Если ваш план Bamboo настроен на использование нескольких веток, убедитесь, что вы создали переменную окружения Branch в ТестОпс и передали ее в вашу джобу. Это специальное имя укажет Bamboo, какая из веток плана должна быть запущена.

4.1. Добавьте глобальные названия параметров

1. Войдите в ТестОпс, используя учетную запись администратора.

2. Перейдите в раздел Администрирование → Окружение.

3. Для каждого параметра, который вы хотите добавить:

   1. Нажмите + Создать.
   2. Введите название параметра.
   3. Нажмите Отправить.

   

4.2. Сопоставьте параметры с переменными окружения

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Окружение.

3. Для каждого параметра, который вы хотите использовать:

   1. Нажмите + Создать, если параметра нет в списке. Если параметр уже существует, нажмите значок Редактировать рядом с его названием.
   2. В поле Ключ укажите название переменной окружения.
   3. В поле Переменная окружения выберите глобальное название параметра из шага 4.1.
   4. Нажмите Отправить.

   

4.3. Добавьте параметры в джобу

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Джобы.

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

   Появится окно настроек джобы, содержащее раздел Параметры.

4. Для каждого параметра, который вы хотите добавить, нажмите Добавить и заполните поля:

   • Название — название переменной окружения (такое же, как Ключ из шага 4.2).
   • Значение — значение по умолчанию, которое должно использоваться, если не указано для конкретного запуска.
   • Переменная окружения — переменная окружения из шага 4.1.

   

5. Нажмите Отправить.

4.4. Установите значения по умолчанию в Bamboo

1. В панели управления Bamboo перейдите к вашему плану сборки.

2. Нажмите Actions → Configure plan.

3. Перейдите на вкладку Variables.

4. Для каждого параметра, который вы хотите добавить:

   1. В поле Variable name укажите название переменной окружения (такое же, как Ключ из шага 4.2).
   2. В поле Value укажите значение по умолчанию, которое должно использоваться, если не указано для конкретного запуска.
   3. Нажмите Add.