Тесты в 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, StrykerGitHub 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, вход через storageState | e2e-тесты в разы короче |
| Перенос проверок с 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 — статус-чек с ревью |
| Lighthouse | lhci 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.