Skip to content
Main Navigation
Автоматизированное тестирование
Централизованное управление автотестами и результатами
Интеграции
Готовые коннекторы с CI/CD, трекерами и репозиториями
Ручное тестирование
Планирование, выполнение и контроль ручных проверок в одном месте
Дашборды и аналитика
Визуализация данных, отчёты и метрики тестов в реальном времени
Ресурсы
Документация
Материалы по установке, настройке и подключению интеграций в ТестОпс
Блог
Статьи и руководства по стратегиям и инструментам тестирования
События
Живое общение с командой ТестОпс на вебинарах и конференциях
Истории клиентов
Реальные кейсы и истории внедрения с результатами из первых рук
Последнее из блога
Искусственный интеллект в тестировании | Часть 2
Искусственный интеллект в тестировании | Часть 2
Руководство по подключению MCP-сервера с GitHub через Cursor IDE для автоматизации запуска тестов и управления процессами CI/CD напрямую из редактора.
Искусственный интеллект в тестировании | Часть 1
Искусственный интеллект в тестировании | Часть 1
Пошаговая инструкция по автоматизации тестирования: настройка окружения, интеграция с GitHub Actions и ТестОпс, использование Cursor IDE и MCP.
Настройка вебхуков в ТестОпс для Telegram
Настройка вебхуков в ТестОпс для Telegram
Гайд по настройке вебхуков в ТестОпс на примере создания сообщений для канала в Telegram.
Перейти в блог
ТарифыПартнерыСвязаться с нами
Sidebar Navigation

Описание ТестОпс

О продукте

Информация о релизах

Миграция с других решений

Термины и определения

Часто задаваемые вопросы

Установка ТестОпс

Архитектура

Установка и первый запуск

Обзор

Kubernetes

Docker Compose

DEB-пакеты

RPM-пакеты

База данных

S3-совместимое хранилище

Конфигурация

Обзор

Сеть

Аутентификация

Обзор

Локальная аутентификация

LDAP

OpenID и Azure AD

OpenID и Keycloak

SAML 2.0

Настройка SMTP

Перенос данных в другой инстанс

Начало работы

1. Создайте проект

2. Запустите ручной тест

3. Запустите автотест

4. Создайте комбинированный запуск

5. Обработайте результаты тестов

Обзор ТестОпс

Обзор

Дашборды

Тест-кейсы

Общие шаги

Тест-планы

Запуски

Результаты тестов

Дефекты

Джобы

Меню пользователя

Тест-кейсы

Статусы воркфлоу

Сценарий ручного теста

Параметры ручного теста

Вложения

Теги

Тестовые слои

Ссылки

Задачи из таск-трекеров

Сторонние тест-кейсы

Участники

Связанные тест-кейсы

Кастомные поля

Ключи маппинга

Импорт

Запуски

Окружение

Обновление метаданных

Сравнение запусков

Категории ошибок

Проект

Обзор

Управление доступом

Деревья

Вебхуки

Администрирование

Обзор

Участники

Группы

Очистка данных

Журналы аудита пользователей

Интеграции

Обзор

CI-системы

AWS CodePipeline

Azure DevOps

Bamboo

Bitbucket

CircleCI

GitHub

GitLab

Jenkins

TeamCity

TeamCity (allurectl)

Таск-трекеры

Битрикс24

EvaProject

GitHub

GitLab

Jira Data Center

Jira Software Cloud

Kaiten

Redmine

Wrike

Yandex Tracker

YouTrack

Системы управления тестированием

TestRail

Xray

Zephyr

Экосистема ТестОпс

allurectl

AQL

API

Устранение неполадок

SaaS

ТестОпс как SaaS

Миграция в облако ТестОпс

Техническая поддержка

On this page

Интеграция с GitLab ​

Эта страница описывает, как настроить интеграцию ТестОпс с GitLab в проекте, который использует GitLab для запуска тестов.

Как и все другие CI-интеграции для ТестОпс, это включает двустороннюю связь:

  • Джоба в пайплайне GitLab использует allurectl для отправки своего статуса и результатов тестов в ТестОпс.
  • ТестОпс использует API GitLab для запуска новых пайплайнов, при необходимости передавая тест-план.

После остановки пайплайна соответствующий запуск в ТестОпс может быть закрыт вручную или автоматически в соответствии с настройками автоматического закрытия.

Настройка интеграции ​

Примечание

Чтобы настроить интеграцию в ТестОпс, вы должны иметь доступ к разделам:

  • Администрирование — необходимы права администратора инстанса;
  • Настройки в конкретном проекте — необходима роль владельца этого проекта.

Чтобы настроить интеграцию с GitLab:

  1. Настройте связь от ТестОпс к GitLab:

    1. Создайте токен в GitLab.

    2. На уровне инстанса ТестОпс добавьте интеграцию с GitLab, указав:

      • название интеграции;
      • URL-адрес GitLab.
    3. На уровне инстанса или проекта ТестОпс включите добавленную интеграцию для проекта, указав созданный токен из GitLab.

  2. Настройте связь от GitLab к ТестОпс:

    1. Создайте API-токен в ТестОпс.
    2. В GitLab укажите созданный API-токен из ТестОпс.
    3. Измените пайплайн в GitLab.
    4. Запустите и проверьте пайплайн в GitLab.
    5. Настройте созданную джобу в ТестОпс.
  3. Параметризуйте джобы GitLab (если необходимо).

1. Настройте связь от ТестОпс к GitLab ​

1.1. Создайте токен в GitLab ​

  1. В GitLab нажмите на ваш аватар и перейдите в Preferences.

  2. В меню слева нажмите Access Tokens.

  3. Если форма создания токена не появилась, нажмите Add new token над списком токенов.

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

    • Token name — название, которое поможет вам распознать токен, например, Токен для ТестОпс.
    • Expiration date — срок действия токена (любая дата в пределах года с текущей даты). После указанной даты интеграция перестанет работать. Чтобы возобновить ее работу, вам нужно будет создать новый токен.
    • Select scopes — api и read_api.
  5. Нажмите Create personal access token.

    Страница обновится, и вверху появится поле Your new personal access token. Нажмите значок Копировать рядом с ним, чтобы скопировать токен в буфер обмена.

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

Таким же образом вы можете использовать токен доступа к проекту (project access token), но имейте в виду, что этот токен позволяет работать только с одним проектом.

1.2. Добавьте интеграцию с GitLab в ТестОпс ​

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

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

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

  4. В списке доступных интеграций выберите GitLab.

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

    • Название — название, которое поможет вам распознать интеграцию, например, GitLab production.
    • Endpoint — URL-адрес инстанса GitLab, например, https://gitlab.example.com/.
  6. Если ваш инстанс GitLab использует самоподписанный SSL-сертификат, поставьте галочку Отключить проверку сертификата.

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

1.3. Включите интеграцию для проекта ТестОпс ​

Чтобы включить интеграцию в нужном проекте ТестОпс воспользуйтесь одним из двух способов ниже:

  1. Перейдите в раздел Администрирование → Интеграции.
  2. В списке настроенных интеграций найдите и откройте вашу интеграцию с GitLab.
  3. Перейдите на вкладку Проекты.
  4. Нажмите + справа от поля поиска.
  5. В выпадающем списке Проект выберите нужный проект.
  6. В появившемся окне укажите Токен, который вы сохранили на шаге 1.1.
  7. Нажмите Проверить соединение. Если токен указан верно, через несколько секунд появится сообщение «Соединение установлено».
  8. Нажмите Добавить интеграцию, чтобы сохранить настройки.

2. Настройте связь от GitLab к ТестОпс ​

Этот раздел описывает вторую часть двусторонней связи: отправку статусов пайплайнов и результатов тестов из GitLab в ТестОпс.

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

  1. В ТестОпс нажмите на ваш аватар и перейдите в API-токены.

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

  3. Придумайте название для токена (например, «Токен для GitLab») и нажмите Создать.

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

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

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

2.2. Укажите токен в GitLab ​

  1. В GitLab откройте проект и перейдите в Settings → CI/CD.

  2. В разделе Variables нажмите Add variable.

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

    • Type — Variable;
    • Visibility — Masked;
    • Key — ALLURE_TOKEN;
    • Value — API-токен, который вы сохранили на шаге 2.1.
  4. Нажмите Add variable, чтобы сохранить настройки.

2.3. Измените пайплайн ​

Чтобы внести изменения в пайплайн, отредактируйте файл .gitlab-ci.yml в вашем репозитории GitLab. Вы можете сделать это либо в локальной директории, либо в редакторе GitLab (CI/CD → Editor в старой навигации, Build → Pipeline editor в новой навигации).

Для каждой джобы, которая запускает тесты, выполните следующие действия:

  1. Добавьте команду before_script, которая загружает инструмент allurectl и делает его исполняемым.

    В приведенном ниже примере мы используем curl для загрузки файла. Если curl не включен в образ Docker, который вы используете для джобы, используйте wget или аналогичный инструмент.

    Вы также можете создать и использовать собственный образ Docker с allurectl.

  2. Добавьте или расширьте блок variables. Он должен включать следующие переменные:

    • ALLURE_ENDPOINT — URL-адрес инстанса ТестОпс.
    • ALLURE_PROJECT_ID — ID проекта ТестОпс.
    • ALLURE_RESULTS — путь к директории с результатами тестов, например, build/allure-results. Если в вашем проекте несколько директорий с результатами тестов, вы можете разделить их запятыми или использовать шаблон с подстановочными символами, например, modules/*/build/allure-results.
  3. Оберните команду, которая запускает тесты, в команду ./allurectl watch.

Совет

Пример

Предположим, у нас есть проект на Java с файлом .gitlab-ci.yml такого вида:

yaml
test:
  stage: test
  image: gradle
  script:
    - gradle clean test

С интеграцией ТестОпс файл будет выглядеть примерно так:

yaml
test:
  stage: test
  image: gradle
  variables:
    ALLURE_ENDPOINT: https://testops.example.com
    ALLURE_PROJECT_ID: 1
    ALLURE_RESULTS: build/allure-results
  before_script:
    - curl -fsSL https://github.com/allure-framework/allurectl/releases/latest/download/allurectl_linux_amd64 -o allurectl
    - chmod +x allurectl
  script:
    - ./allurectl watch -- gradle clean test

2.4. Запустите и проверьте пайплайн ​

  1. В GitLab откройте проект и перейдите к выполнению пайплайна, запущенного последним коммитом.

  2. Если выполнение пайплайна еще не завершено, дождитесь его завершения.

  3. В деталях выполнения пайплайна нажмите на джобу, которая запускает тесты.

    Ближе к концу лога должна быть ссылка на отчет о тестировании в ТестОпс. Убедитесь, что она присутствует и работает.

    Ссылка на запуск находится в логах выполнения пайплайна.

  4. В запуске в ТестОпс откройте результаты одного теста.

    Внизу страницы должна быть ссылка на пайплайн GitLab. Убедитесь, что она присутствует и работает.

    Ссылка на пайплайн GitLab находится внизу результатов теста.

2.5. Настройте джобу в ТестОпс ​

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

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

    Страница должна содержать новую джобу, автоматически добавленную и настроенную во время запуска на шаге 2.4.

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

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

    • Название — название, которое поможет вам распознать джобу.
    • Сервер сборки — название интеграции, которую вы добавили на шаге 1.2.
    • Джоба может быть использована для запуска тестов — если установлено, пользователи смогут запускать эту джобу из ТестОпс.
    • Параметры — параметры, которые должны быть переданы в GitLab через переменные окружения, см. Окружение.

    Окно позволяет настроить параметры джобы.

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

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

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

Важно

Если в репозитории вашего проекта есть несколько веток, обязательно создайте переменную окружения Branch в ТестОпс и передайте ее в вашу джобу. Это специальное имя укажет GitLab, какую из веток нужно использовать.

3.1. Установите значения по умолчанию в GitLab ​

Чтобы внести изменения в пайплайн, отредактируйте файл .gitlab-ci.yml в вашем репозитории GitLab. Вы можете сделать это либо в локальной директории, либо в редакторе GitLab (CI/CD → Editor в старой навигации, Build → Pipeline editor в новой навигации).

Добавьте переменные и их значения по умолчанию в блок variables пайплайна или джобы. Например:

yaml
test:
  stage: test
  image: gradle
  variables:
    ALLURE_ENDPOINT: https://testops.example.com
    ALLURE_PROJECT_ID: 1
    ALLURE_RESULTS: build/allure-results
    PRODUCT_VERSION: "1.23"
    TESTS_BROWSER: chrome
  before_script:
    - curl -fsSL https://github.com/allure-framework/allurectl/releases/latest/download/allurectl_linux_amd64 -o allurectl
    - chmod +x allurectl
  script:
    - ./allurectl watch -- gradle clean test

3.2. Добавьте глобальные названия параметров в ТестОпс ​

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

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

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

    Обратите внимание, что это название может быть человекочитаемым и не обязательно должно совпадать с названием из шага 3.1.

    Названия переменных окружения добавляются в панели администрирования.

3.3. Сопоставьте параметры с переменными окружения в ТестОпс ​

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

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

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

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

    Сопоставление переменных окружения находится в настройках проекта.

3.4. Добавьте параметры в джобу ТестОпс ​

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

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

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

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

    • Название — название переменной окружения из шага 3.1.
    • Значение — значение по умолчанию, такое же, как значение из шага 3.1.
    • Переменная окружения — глобальное название параметра из шага 3.2.

    В окне можно указать несколько переменных окружения.

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

Pager
Previous pageGitHub
Next pageJenkins

Logo © 2025 Все права защищены. Сайт принадлежит компании ООО «Инструменты тестирования»