Интеграция с CI/CD системами

Cypress — это инструмент для энд-ту-энд тестирования веб-приложений, который активно используется в современных DevOps-процессах. Интеграция с системами CI/CD позволяет автоматизировать запуск тестов при каждом изменении кода, повышая качество продукта и сокращая время на проверку функциональности.

Подготовка проекта к CI/CD

Перед интеграцией необходимо убедиться, что проект Cypress корректно настроен для безголового запуска:

Установка Cypress как зависимости проекта

npm install cypress --save-dev

Добавление скриптов в package.json Для запуска тестов в CI полезно иметь отдельный скрипт:

"scripts": {
  "cypress:open": "cypress open",
  "cypress:run": "cypress run"
}

Конфигурация headless режима В CI/CD тесты запускаются без графического интерфейса. Cypress поддерживает режимы запуска в браузерах Electron, Chrome и Firefox:

npx cypress run --browser chrome

Настройка окружений Переменные окружения (CYPRESS_baseUrl, CYPRESS_API_KEY и т.д.) можно передавать через CI, чтобы тесты выполнялись в разных средах (staging, production).

Интеграция с GitHub Actions

GitHub Actions предоставляет удобный способ автоматизации запуска тестов:

name: Cypress Tests

on:
  push:
    branches:
      - main
  pull_request:

jobs:
  cypress-run:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: 20
      - run: npm ci
      - run: npx cypress run
        env:
          CYPRESS_baseUrl: https://staging.example.com

Особенности настройки:

runs-on: ubuntu-latest — обеспечивает чистое окружение для каждого запуска.
npx cypress run запускает все тесты в headless режиме.
Перед запуском тестов можно добавить шаги для установки зависимостей, миграции базы данных и подготовки тестового окружения.

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

Jenkins позволяет гибко настраивать пайплайны:

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }
        stage('Install Dependencies') {
            steps {
                sh 'npm ci'
            }
        }
        stage('Run Cypress Tests') {
            steps {
                sh 'npx cypress run --browser chrome'
            }
        }
    }
    post {
        always {
            archiveArtifacts artifacts: 'cypress/screenshots/**', allowEmptyArchive: true
            junit 'cypress/results/*.xml'
        }
    }
}

Ключевые моменты:

Архивация артефактов: скриншоты и видео тестов позволяют анализировать ошибки.
JUnit отчеты: Cypress поддерживает экспорт результатов в формате JUnit для интеграции с Jenkins Dashboard.
Параллельный запуск: можно запускать тесты параллельно на нескольких агентах для ускорения проверки.

Отчёты и визуализация

Для CI/CD критично отслеживать результаты тестирования:

Cypress Dashboard предоставляет возможность хранить логи, скриншоты, видео и метрики покрытия.
Отчёты в формате JUnit позволяют CI системам автоматически отображать статус тестов в интерфейсе пайплайна.
Плагины: cypress-mochawesome-reporter генерирует детальные HTML отчёты с визуализацией прохождения тестов.

Настройка параллельного запуска

Параллельный запуск сокращает время выполнения тестов. Cypress поддерживает распределение тестов между несколькими CI агентами:

npx cypress run --record --parallel --key <project-record-key>

Пояснения:

--record отправляет результаты на Cypress Dashboard.
--parallel позволяет CI системе распределять тесты между машинами.
<project-record-key> — уникальный ключ проекта для связи с Dashboard.

Управление окружениями и конфигурацией

Для различных сред удобно использовать конфигурационные файлы:

npx cypress run --config-file cypress.staging.json

В файле cypress.staging.json можно переопределять baseUrl, таймауты и другие параметры. Это упрощает поддержку нескольких окружений в одном пайплайне.