Настройка параллельных воркеров

Основы параллельного запуска тестов

Параллельное выполнение тестов в Cypress позволяет существенно сокращать время проверки за счёт распределения тестов между несколькими воркерами. Воркеры — это независимые процессы, каждый из которых запускает отдельную часть тестового набора. Cypress использует стратегию sharding, распределяя тесты по воркерам автоматически на основе количества файлов тестов.

Ключевые преимущества параллельного запуска:

  • Сокращение времени прохождения полного набора тестов.
  • Повышение надёжности за счёт изоляции тестов в отдельных процессах.
  • Возможность масштабирования тестирования на CI/CD.

Настройка параллельного режима

  1. Установка Cypress Dashboard Для полноценной работы параллельного режима необходимо использовать Cypress Dashboard. Он обеспечивает координацию воркеров и хранение статистики выполнения. Установка выполняется через npm:

    npm install --save-dev cypress

  2. Идентификация проекта Для включения параллельного выполнения проект должен быть зарегистрирован в Dashboard. После регистрации Cypress выдаёт projectId, который необходимо добавить в cypress.config.js:

    const { defineConfig } = require('cypress');

module.exports = defineConfig({
  projectId: 'ваш_projectId',
  e2e: {
    setupNodeEvents(on, config) {
      // события можно подключать здесь
    },
  },
});

  3. Разделение тестов между воркерами Cypress автоматически распределяет тестовые файлы, если запуск выполняется с параметром --parallel. Для оптимальной работы важно:

    • Иметь тесты, разбитые на отдельные файлы.
    • Поддерживать независимость тестов — состояния не должны пересекаться.
    • Использовать уникальные данные для параллельных тестов, например, через фикстуры или генерацию случайных значений.

    Пример запуска:

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

    Параметр --record отправляет результаты в Dashboard, а --parallel активирует распределение тестов между воркерами.

Управление воркерами

  • Количество воркеров Cypress автоматически определяет оптимальное количество воркеров на основе числа доступных CPU. Можно задавать вручную через параметр --ci-build-id для идентификации конкретного билда:

    npx cypress run --record --key <CYPRESS_RECORD_KEY> --parallel --ci-build-id 1234

  • Повторные попытки (retries) В параллельном режиме важно настроить корректное количество попыток повторного запуска упавших тестов. Это снижает вероятность ложных ошибок при нестабильных соединениях или случайных сбоях:

    module.exports = defineConfig({
  e2e: {
    retries: {
      runMode: 2,
      openMode: 0
    }
  }
});

  • Фильтрация тестов по воркерам Cypress поддерживает стратегию распределения тестов на основе хеширования имени файла, что обеспечивает равномерное распределение нагрузки. Дополнительно можно использовать теги или группы тестов для точного контроля.

Работа с CI/CD

Параллельные воркеры особенно эффективны в интеграции с CI/CD:

  • GitHub Actions, GitLab CI, Jenkins — Cypress запускается через команду npx cypress run с параметром --parallel.
  • Оптимизация ресурсов — для экономии ресурсов можно ограничить количество одновременно работающих воркеров с помощью переменных окружения CYPRESS_PARALLEL_LIMIT.
  • Агрегация отчётов — Dashboard автоматически объединяет результаты всех воркеров, что упрощает анализ ошибок и покрытия.

Советы по стабильности

  • Каждый тест должен быть полностью изолированным, чтобы параллельное выполнение не влияло на результат.
  • Использование фикстур и моков снижает вероятность конфликта при параллельных запросах к серверу.
  • Логирование отдельно для каждого воркера помогает быстро идентифицировать причину падений.
  • Проверять использование глобальных состояний и кук — при параллельном запуске их изменение в одном воркере не должно влиять на другие.

Расширенные возможности

  • Dynamic test splitting: Cypress позволяет динамически перераспределять тесты, если один воркер выполняется дольше остальных.
  • Group tags: Тесты можно группировать по функциональным блокам, чтобы один воркер запускал только определённую категорию тестов.
  • Dashboard insights: Анализ времени выполнения каждого воркера позволяет выявлять “тяжёлые” тесты и оптимизировать их выполнение.

Настройка параллельных воркеров в Cypress является ключевым элементом оптимизации тестовых прогонов, особенно при больших наборах тестов и CI/CD интеграциях. Эффективное использование этой функциональности требует правильной структуры тестов, корректного управления состояниями и внимательного подхода к конфигурации Dashboard и параметров запуска.

Оглавление