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

Playwright E2E en GitHub Actions como paso obligatorio antes de la implementación en Vercel

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

Problema con la implementación predeterminada

El proyecto Vercel conectado a GitHub implementa cada inserción en main directamente en producción. Las pruebas en GitHub Actions se ejecutan en paralelo y, si fallan, la versión defectuosa ya está disponible para los usuarios. Necesitamos orden: primero pruebas, luego implementación e implementar exactamente el ensamblaje que se probó.

Hay dos esquemas de trabajo.

Esquema A. CI crea la aplicación, la ejecuta localmente, ejecuta Playwright y, si tiene éxito, envía el artefacto ensamblado a Vercel a través de la CLI.

Esquema B. Vercel crea una implementación de vista previa, CI la prueba por URL y, si tiene éxito, la misma implementación se promueve a producción.

El esquema A es más fácil de configurar y no depende de la disponibilidad de la vista previa. El circuito B prueba la infraestructura real de Vercel (middleware, funciones perimetrales, variables de entorno de vista previa). A continuación se muestra la versión completa del esquema A y las diferencias para B.

Deshabilitar la implementación automática desde Git

En vercel.json:

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

Solo se puede deshabilitar para ramas individuales: "deploymentEnabled": { "main": false }. Luego, las vistas previas de las solicitudes de extracción se seguirán creando automáticamente.

Configuración del dramaturgo

// 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 evitará que un test.only cometido accidentalmente se salte otras pruebas. trace: "on-first-retry" solo guarda rastros de pruebas inestables para evitar artefactos hinchados.

Qué probar

E2E antes del despliegue no es el lugar para una cobertura completa. Tomemos escenarios que cuesten dinero o que los usuarios rompan:

// 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();
});

La última prueba detecta una clase de errores que no son visibles al cargar la página directamente: fallas al pasar por <Link>. Un usuario de prueba debe existir solo en la base de datos de prueba o vista previa.

Flujo de trabajo para el diagrama 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 carga la configuración del proyecto y las variables de entorno, vercel build recopila la salida en .vercel/output y deploy --prebuilt la envía sin volver a ensamblarla en el lado de Vercel. El paso de implementación se ejecuta solo si se han pasado todos los anteriores.

Aquí la aplicación se construye dos veces: vercel build para implementación y npm run build para lanzamiento local. Si un ensamblaje de prueba va a la base de datos de producción, esto es peligroso: use variables de entorno de prueba separadas para npm run build y next start.

Diferencias en el esquema B

En lugar del servidor local, configure E2E_BASE_URL con la dirección de la implementación de vista previa (vercel deploy --token=... la imprime en la salida estándar). La protección de implementación suele cerrar la vista previa; para la automatización, habilite la omisión de protección para la automatización en la configuración del proyecto y pase el secreto en el encabezado x-vercel-protection-bypass; la configuración anterior ya hace esto. Después de las pruebas exitosas, ejecute vercel promote <url> --token=....

Cómo lidiar con fallas

  • Descargue el artefacto playwright-report y abra npx playwright show-report. El seguimiento muestra el DOM, la red y la consola en cada paso.
  • La prueba falla solo en CI: la mayoría de las veces el culpable son los tiempos de espera durante un arranque en frío o diferentes zonas horarias. Compare TZ y locale en use.
  • La prueba inestable no se trata aumentando retries. Busque una espera a través de waitForTimeout y reemplácela con una verificación de estado a través de expect.

Cuando es innecesario

Para un sitio estático sin formularios ni autorización, basta con crear y comprobar enlaces. Si las pruebas duran más de 10 a 15 minutos, divídalas: una serie corta de humo bloquea el despliegue, una serie completa continúa según lo programado.

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

Ещё на vbcd4u.com