Vercel にデプロイする前の必須ステップとしての GitHub Actions での Playwright E2E
Проблема с деплоем по умолчанию
Подключённый к 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-набор блокирует деплой, полный набор идёт по расписанию.