re:re:actable
Урок 015 минут чтения

Тесты в CI: скорость, параллелизация и отчёты

На этой странице
Кратко

Тесты приносят пользу, только если они запускаются автоматически на каждое изменение и блокируют merge при падении. Хороший CI для фронтенда: быстрые проверки первыми (типы, линт, unit/интеграционные — минуты), e2e — параллельно и шардированно против превью или собранного приложения, только затронутое в монорепо (turbo --affected, nx affected, vitest --changed), кэш зависимостей, браузеров Playwright и результатов задач, отчёты, которые легко читать прямо в PR (аннотации GitHub, HTML-отчёт Playwright с трассами как артефакт, комментарии с покрытием и размером бандла). Целевое время обратной связи на PR — до 10–15 минут; дольше — разработчики начинают обходить CI. Стабильность важнее количества: flaky-тесты в блокирующем прогоне быстро разрушают доверие, поэтому нужны ретраи только в CI, учёт flaky и карантин. Тяжёлые проверки (полная матрица браузеров, визуальные, мутационные, производительность) уходят в ночные прогоны или запускаются по меткам.

Вопрос

Как организовать запуск тестов в CI, чтобы он был быстрым, стабильным и понятным? Что такое шардирование и как работать с отчётами?

Структура конвейера

PR
├─ install (pnpm --frozen-lockfile, кэш)                         ~1 мин
├─ параллельно:
│   ├─ typecheck (tsc --noEmit)                                  ~1 мин
│   ├─ lint (eslint, stylelint)                                  ~1 мин
│   └─ unit + integration (vitest run --coverage, затронутое)    ~2–4 мин
├─ build                                                         ~2–3 мин
├─ e2e: 4 шарда Playwright против next start / превью            ~5 мин
└─ отчёты: аннотации, HTML-отчёт, покрытие, size-limit
 
Nightly: все браузеры и мобильные проекты, визуальные, Lighthouse CI, Stryker

GitHub Actions: Vitest + Playwright с шардированием

name: Tests
on: [pull_request]
 
jobs:
  unit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22, cache: pnpm }
      - run: pnpm install --frozen-lockfile
      - run: pnpm vitest run --coverage --reporter=default --reporter=github-actions
      - uses: actions/upload-artifact@v4
        if: always()
        with: { name: coverage, path: coverage/ }
 
  e2e:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    strategy:
      fail-fast: false
      matrix:
        shard: [1/4, 2/4, 3/4, 4/4]
    services:
      postgres:
        image: postgres:17
        env: { POSTGRES_USER: test, POSTGRES_PASSWORD: test, POSTGRES_DB: app_test }
        ports: ["5433:5432"]
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22, cache: pnpm }
      - run: pnpm install --frozen-lockfile
      - run: pnpm exec playwright install --with-deps chromium
      - run: pnpm exec playwright test --shard=${{ matrix.shard }} --reporter=blob
        env:
          TEST_DATABASE_URL: postgres://test:test@localhost:5433/app_test
          E2E_CUSTOMER_EMAIL: ${{ secrets.E2E_CUSTOMER_EMAIL }}
          E2E_CUSTOMER_PASSWORD: ${{ secrets.E2E_CUSTOMER_PASSWORD }}
      - uses: actions/upload-artifact@v4
        if: always()
        with: { name: blob-report-${{ strategy.job-index }}, path: blob-report, retention-days: 7 }
 
  e2e-report:
    if: always()
    needs: e2e
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22, cache: pnpm }
      - run: pnpm install --frozen-lockfile
      - uses: actions/download-artifact@v4
        with: { path: all-blob-reports, pattern: blob-report-*, merge-multiple: true }
      - run: pnpm exec playwright merge-reports --reporter html ./all-blob-reports
      - uses: actions/upload-artifact@v4
        with: { name: playwright-report, path: playwright-report, retention-days: 14 }

Шардирование делит тесты между машинами, blob-отчёты каждого шарда сливаются в один HTML-отчёт с трассами упавших тестов.

Как ускорить

ПриёмЭффект
Кэш pnpm store и браузеров Playwright−1–2 мин на job
Только затронутое: turbo run test --affected, vitest --changed origin/mainКратно меньше тестов в монорепо
Удалённый кэш Turborepo/NxНеизменённые пакеты не тестируются повторно
Параллельные воркеры Vitest и fullyParallel в PlaywrightИспользование всех ядер
Шардирование e2eЛинейное ускорение по числу машин
Подготовка данных через API, вход через storageStatee2e-тесты в разы короче
Перенос проверок с e2e на интеграционный уровеньСамое большое ускорение
Нужный набор браузеров на PR (Chromium), остальное — nightly−50–70% времени e2e

Стабильность в CI

// playwright.config.ts
retries: process.env.CI ? 2 : 0,          // ретраи только в CI
workers: process.env.CI ? 2 : undefined,  // на слабых runners меньше воркеров = меньше flaky
forbidOnly: !!process.env.CI,             // забытый test.only роняет CI
// vitest.config.ts
test: { allowOnly: !process.env.CI }      // аналогично для Vitest
  • Отчёт Playwright помечает flaky-тесты — их собирают в дашборд (Currents, ReportPortal, Allure, встроенные отчёты CI).
  • Карантин через теги и --grep-invert @quarantine с задачей на исправление.

Отчёты в PR

ЧтоКак
Упавшие тесты прямо в diffРепортеры github-actions (Vitest) и github (Playwright)
Трассы, скриншоты, видеоHTML-отчёт Playwright как артефакт
Покрытие измененийCodecov / vitest-coverage-report-action
Размер бандлаsize-limit-action
Визуальные измененияChromatic / Argos — статус-чек с ревью
Lighthouselhci autorun — ссылка на отчёт

Branch protection

Обязательные проверки (required status checks) в настройках репозитория: typecheck, lint, unit, e2e. Без этого красный CI легко проигнорировать.

Предкоммитные проверки

// package.json — lint-staged + husky/lefthook: быстрые проверки только изменённых файлов
"lint-staged": {
  "*.{ts,tsx}": ["eslint --fix", "vitest related --run"]
}

vitest related запускает тесты, связанные с изменёнными файлами. Хуки должны быть быстрыми (секунды) — тяжёлое остаётся в CI.

Что важно помнить

  • Тесты в CI на каждый PR и обязательные проверки перед merge.
  • Быстрое первым, e2e параллельно и шардированно; цель — до 10–15 минут.
  • Только затронутое и кэш — главный способ ускорения в монорепо.
  • Ретраи только в CI, учёт flaky, forbidOnly.
  • Отчёты прямо в PR: аннотации, HTML с трассами, покрытие, бандл.

Мини-шпаргалка

  • playwright test --shard=1/4 --reporter=blob → merge-reports.
  • vitest run --reporter=github-actions, vitest --changed, vitest related.
  • turbo run test --affected.
  • retries, workers, forbidOnly от process.env.CI.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам