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

Playwright E2E у GitHub Actions як обов'язковий крок перед деплоєм на Vercel

@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 хвилин, розділіть їх: короткий набір блокує деплой, повний набір йде за розкладом.

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

Ещё на vbcd4u.com