v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:14:00.000Z▲ 0 upvotes

Vercel'e dağıtımdan önce zorunlu bir adım olarak GitHub Actions'da Oyun Yazarı E2E

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Проблема с деплоем по умолчанию

Подключённый к GitHub проект Vercel деплоит каждый push в main сразу в продакшен. Тесты в GitHub Actions при этом бегут параллельно, и если они упали, сломанная версия уже обслуживает пользователей. Нужен порядок: сначала тесты, потом деплой, причём деплоить именно ту сборку, которую тестировали.

Есть две рабочие схемы.

Схема A. CI собирает приложение, запускает его локально, гоняет Playwright, и при успехе отправляет собранный артефакт в Vercel через CLI.

Схема B. Vercel создаёт preview-деплой, CI тестирует его по URL, и при успехе этот же деплой продвигается в продакшен.

Схема A проще в настройке и не зависит от доступности preview. Схема B проверяет реальную инфраструктуру Vercel (middleware, edge-функции, переменные окружения preview). Ниже — полный вариант схемы A и отличия для B.

Отключить автоматический деплой из Git

В vercel.json:

{
  "git": {
    "deploymentEnabled": false
  }
}

Можно отключить только для отдельных веток: "deploymentEnabled": { "main": false }. Тогда preview для pull request продолжат создаваться автоматически.

Конфигурация Playwright

// playwright.config.ts
import { defineConfig, devices } from "@playwright/test";

const baseURL = process.env.E2E_BASE_URL ?? "http://localhost:3000";

export default defineConfig({
  testDir: "./e2e",
  fullyParallel: true,
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  reporter: process.env.CI ? [["html", { open: "never" }], ["github"]] : "list",
  use: {
    baseURL,
    trace: "on-first-retry",
    extraHTTPHeaders: process.env.VERCEL_AUTOMATION_BYPASS_SECRET
      ? { "x-vercel-protection-bypass": process.env.VERCEL_AUTOMATION_BYPASS_SECRET }
      : undefined,
  },
  projects: [{ name: "chromium", use: { ...devices["Desktop Chrome"] } }],
  webServer: process.env.E2E_BASE_URL
    ? undefined
    : {
        command: "npm run start",
        url: "http://localhost:3000",
        reuseExistingServer: !process.env.CI,
        timeout: 120_000,
      },
});

forbidOnly не даст случайно закоммиченному test.only пропустить остальные тесты. trace: "on-first-retry" сохраняет трассировку только для нестабильных тестов, чтобы не раздувать артефакты.

Что тестировать

E2E перед деплоем — не место для полного покрытия. Возьмите сценарии, поломка которых стоит денег или пользователей:

// e2e/critical.spec.ts
import { test, expect } from "@playwright/test";

test("главная отдаёт контент и навигацию", async ({ page }) => {
  await page.goto("/");
  await expect(page.getByRole("navigation")).toBeVisible();
  await expect(page.getByRole("heading", { level: 1 })).toBeVisible();
});

test("вход с тестовым пользователем", async ({ page }) => {
  await page.goto("/login");
  await page.getByLabel("Email").fill(process.env.E2E_USER_EMAIL!);
  await page.getByLabel("Пароль").fill(process.env.E2E_USER_PASSWORD!);
  await page.getByRole("button", { name: "Войти" }).click();
  await expect(page).toHaveURL(/\/dashboard/);
});

test("страница статьи открывается при клиентской навигации", async ({ page }) => {
  await page.goto("/forum");
  await page.locator('a[href*="/forum/"]').first().click();
  await expect(page.locator("article")).toBeVisible();
});

Последний тест ловит класс ошибок, которых не видно при прямой загрузке страницы: падения при переходе через <Link>. Тестовый пользователь должен существовать только в тестовой или preview-базе.

Workflow для схемы A

# .github/workflows/deploy.yml
name: test-and-deploy
on:
  push:
    branches: [main]

jobs:
  e2e-deploy:
    runs-on: ubuntu-latest
    env:
      VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
      VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci
      - run: npm i -g vercel@latest

      - run: vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}
      - run: vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}

      - run: npm run build
      - run: npx playwright install --with-deps chromium
      - run: npx playwright test
        env:
          E2E_USER_EMAIL: ${{ secrets.E2E_USER_EMAIL }}
          E2E_USER_PASSWORD: ${{ secrets.E2E_USER_PASSWORD }}

      - uses: actions/upload-artifact@v4
        if: failure()
        with:
          name: playwright-report
          path: playwright-report/
          retention-days: 7

      - run: vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}

vercel pull загружает настройки проекта и переменные окружения, vercel build собирает вывод в .vercel/output, а deploy --prebuilt отправляет его без повторной сборки на стороне Vercel. Шаг деплоя выполняется только если все предыдущие прошли.

Здесь приложение собирается дважды: vercel build для деплоя и npm run build для локального запуска. Если тестовая сборка ходит в продакшен-базу, это опасно — используйте для npm run build и next start отдельные тестовые переменные окружения.

Отличия схемы B

Вместо локального сервера задайте E2E_BASE_URL адресом preview-деплоя (vercel deploy --token=... печатает его в stdout). Preview обычно закрыт Deployment Protection; для автоматизации включите в настройках проекта Protection Bypass for Automation и передавайте секрет в заголовке x-vercel-protection-bypass — конфиг выше уже это делает. После успешных тестов выполните vercel promote <url> --token=....

Как разбирать падения

  • Скачайте артефакт playwright-report и откройте npx playwright show-report. Трассировка показывает DOM, сеть и консоль на каждом шаге.
  • Тест падает только в CI: чаще всего виноваты таймауты при холодном старте или разный часовой пояс. Сравните TZ и locale в use.
  • Нестабильный тест не лечится увеличением retries. Ищите ожидание через waitForTimeout и заменяйте на проверку состояния через expect.

Когда это лишнее

Для статического сайта без форм и авторизации хватит сборки и проверки ссылок. Если тесты занимают больше 10–15 минут, разделите их: короткий smoke-набор блокирует деплой, полный набор идёт по расписанию.

Обсуждение (0)

Ещё на vbcd4u.com