Настройка автоматического запуска тестов при Pull Request

Настройка автоматического запуска тестов при Pull Request

Автозапуск тестов при PR — базовая защита от регрессий. Разработчик не может смержить код, который ломает существующую функциональность. Это не замена code review, а его дополнение: ревьюер фокусируется на логике, а не на ловле очевидных багов.

Структура пайплайна

Грамотный пайплайн разбит на параллельные джобы с fail-fast стратегией:

# .github/workflows/pr.yml
name: PR Tests
on:
  pull_request:
    branches: [main, develop]

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true  # Отменяем старые запуски при новом push

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20, cache: npm }
      - run: npm ci
      - run: npm run lint && npm run type-check

  unit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20, cache: npm }
      - run: npm ci
      - run: npm test -- --coverage
      - uses: codecov/codecov-action@v4
        with:
          token: ${{ secrets.CODECOV_TOKEN }}

  integration:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_DB: testdb
          POSTGRES_PASSWORD: test
        options: >-
          --health-cmd pg_isready
          --health-interval 5s
          --health-timeout 5s
          --health-retries 5
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20, cache: npm }
      - run: npm ci
      - run: npm run test:integration
        env:
          DATABASE_URL: postgresql://postgres:test@localhost:5432/testdb

Кэширование зависимостей

# Кэш node_modules по package-lock.json
- uses: actions/setup-node@v4
  with:
    node-version: 20
    cache: npm  # Встроенный кэш в actions/setup-node

# Или явно через actions/cache
- uses: actions/cache@v4
  with:
    path: ~/.npm
    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}

Без кэша npm ci на холодном раннере — 60–90 секунд. С кэшем — 5–10 секунд.

Матрица тестирования

Если приложение должно работать на нескольких версиях Node.js или PHP:

strategy:
  matrix:
    node-version: [18, 20, 22]
  fail-fast: false  # Запускаем все версии даже если одна упала

PHP / Laravel

- name: Run PHPUnit
  run: php artisan test --parallel --coverage-clover=coverage.xml
  env:
    DB_CONNECTION: pgsql
    DB_DATABASE: testing

- name: Upload coverage
  uses: codecov/codecov-action@v4
  with:
    files: coverage.xml

--parallel запускает тесты параллельно через brianium/paratest. На 200+ тестах ускоряет в 3–4 раза.

Статус-чеки и branch protection

В GitHub Settings → Branches → Branch protection rules добавляем required status checks: lint, unit, integration. Мерж в main без прохождения этих проверок невозможен.

Оптимизация скорости

• Path filtering — запускать тесты только при изменении релевантных файлов
• Test splitting — распределить тесты по нескольким раннерам (GitHub Actions matrix)
• Только изменённые модули — Jest --changedSince, pytest --testpaths

Цель: пайплайн укладывается в 5 минут. Медленнее — разработчики начинают игнорировать.

Сроки

Настройка базового пайплайна с unit и integration тестами для Node.js или PHP проекта — 1–2 дня. Настройка coverage репортов и badge в README — 0,5 дня.