Интеграция с 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 нажмите на значок шестеренки в правом верхнем углу и выберите Управление приложениями.

2. Нажмите Найти новые приложения.

3. Используя поле поиска, найдите плагин “ТестОпс для Bamboo”.

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

5. В появившемся диалоге нажмите Установить, затем Принять и установить.

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

---

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

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

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

1. В ТестОпс нажмите на свой аватар и перейдите в Ваш профиль.

2. В разделе API токены нажмите Создать.

3. Введите Имя токена (например, “Токен для Bamboo”), затем нажмите Отправить.

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

   Этот токен понадобится вам на следующем шаге.

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

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

2. Нажмите Действия → Настроить план.

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

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 — список тегов, которые должны быть присвоены запуску тестов, через запятую.

2. Нажмите Сохранить.

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

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

2. Нажмите Действия → Настроить план.

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

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

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

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

6. Нажмите Сохранить.

---

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 сертификат, отметьте флажок Отключить проверку сертификата.

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. Нажмите Действия → Настроить план.

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

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

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

5. В поле Переменные окружения введите: ALLURE_TESTPLAN_PATH=${bamboo.ALLURE_TESTPLAN_PATH}.

   

6. Нажмите Сохранить.

---

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. Нажмите Действия → Настроить план.

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

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

   1. В поле Имя переменной укажите имя переменной окружения (такое же, как Ключ сопоставления из шага 4.2).

   2. В поле Значение укажите значение по умолчанию, которое должно использоваться, если не переопределено для конкретного запуска.

   3. Нажмите Добавить.