
Test IT поддерживает интеграцию с GitLab. Для настройки используется все несколько строк кода и поддерживаются любые тестовые фреймворки и платформы.
Вы можете интегрировать как простые проекты (только с запуском тестов), так и сложные проекты (несколько отдельных проектов), которые запускаются в несколько независимых потоков.
Независимо от ваших требований процесс интеграции всегда будет одинаков:
- Запуск автоматизированных тестов в пайплайнах GitLab.
- Генерация Junit XML отчета с результатами автоматизированных тестов.
- Загрузка результатов с помощью Test IT CLI
Не забывайте передавать приватный токен через переменную окружения
TMS_TOKEN
для корректной работы утилиты Test IT CLI. Как это сделать безопасно смотрите ниже.
Стандартный запуск
В данном разделе показано как запускать простые проекты в GitLab. В качестве примера мы выбрали тестовый фреймворк Pytest для Python. Но данная инструкция будет актуальна для любых тестовых фреймворков и платформ.
Мы будем использовать утилиту Test IT CLI
для быстрой и простой интеграции с нашей системой управления тестированием. С помощью одной команды мы загрузим все результаты автоматизированных тестов.
Ниже представлен пример файла .gitlab-ci.yml
, который отвечает за работу пайплайнов в GitLab:
# .gitlab-ci.yml
default:
image: python:3.10-bullseye
stages:
- test
test:
stage: test
script:
# Install project dependencies
- pip install -r requirements.txt
# Execute test and generate report
- pytest --junitxml=results/test-results.xml src/tests.py
after_script:
# Install Test IT CLI
- pip install testit-cli
# Submit test results to TMS
- testit \
--url <YOUR_INSTANCE_URL> \
--project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
--configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \
--testrun-name "GitLab test run" \
--results results/test-results.xml
artifacts:
when: always
reports:
junit:
- results/test-results.xml
Простым добавлением необходимых шагов вы можете запускать множество необходимых вам тестов и загружать их в Test IT. Больше информации вы можете найти в официальной документации.
Параллельный запуск
Мы так же полностью поддерживаем параллельный запуск автоматизированных тестов в GitLab. Добавляются дополнительные независимые шаги для создания, завершения тестрана и запуска тестов.
Ниже представлен пример файла .gitlab-ci.yml
, который отвечает за работу пайплайнов в GitLab:
# .gitlab-ci.yml
default:
image: python:3.10-bullseye
stages:
- create
- test
- complete
create:
stage: create
script:
# Install Test IT CLI
- pip install testit-cli
# Create testrun
- testit \
--mode create \
--url <YOUR_INSTANCE_URL> \
--project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
--testrun-name "GitLab test run" \
--output output.txt
# Export TMS_TEST_RUN_ID env variable
- echo "TMS_TEST_RUN_ID=$(cat output.txt)" > tms.env
artifacts:
reports:
dotenv: tms.env
test:
parallel: 4
stage: test
script:
# Install project dependencies
- pip install -r requirements.txt
# Execute test and generate report
- pytest --junitxml=results/test-results.xml src/tests.py
after_script:
# Install Test IT CLI
- pip install testit-cli
# Submit test results to TMS
- testit \
--mode upload \
--url <YOUR_INSTANCE_URL> \
--configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \
--results results/test-results.xml
artifacts:
when: always
reports:
junit:
- results/test-results.xml
dependencies:
- create
complete:
stage: complete
script:
# Install Test IT CLI
- pip install testit-cli
# Complete testrun
- testit \
--mode finish \
--url <YOUR_INSTANCE_URL>
dependencies:
- test
- create
when: always
Безопасное хранение данных
Для работы утилиты Test IT CLI вам необходимо использовать приватный токен для авторизации. Хранение данного токена и другой чувствительной информации в коде строго не рекомендуется, так как доступ к этой информации будет иметь любой у кого есть доступ к коду.
Используйте проектные переменные GitLab для хранения чувствительной информации. Подробнее с переменными вы можете ознакомится в официальной документации.