GitHub Actions-da dramaturg E2E Vercel-ga joylashtirishdan oldin majburiy qadam sifatida
Standart joylashtirish bilan bog'liq muammo
GitHub-ga ulangan Vercel loyihasi main dagi har bir surishni to'g'ridan-to'g'ri ishlab chiqarishga qo'llaydi. GitHub Actions-dagi testlar parallel ravishda ishlaydi va agar ular muvaffaqiyatsiz bo'lsa, buzilgan versiya allaqachon foydalanuvchilarga xizmat qiladi. Bizga tartib kerak: avval sinovlar, keyin joylashtirish va aynan sinovdan o'tgan yig'ilishni joylashtirish.
Ikkita ish sxemasi mavjud.
Sxema A. CI ilovani yaratadi, uni mahalliy darajada boshqaradi, Dramaturgni boshqaradi va agar muvaffaqiyatli bo'lsa, CLI orqali yig'ilgan artefaktni Vercelga yuboradi.
Sxema B. Vercel oldindan ko‘rish joylashtirishni yaratadi, CI uni URL orqali sinab ko‘radi va agar muvaffaqiyatli bo‘lsa, xuddi shu joylashtirish ishlab chiqarishga o‘tkaziladi.
A sxemasini sozlash osonroq va oldindan ko'rish mavjudligiga bog'liq emas. B sxemasi haqiqiy Vercel infratuzilmasini sinovdan o'tkazadi (o'rta dastur, chekka funktsiyalar, oldindan ko'rish muhiti o'zgaruvchilari). Quyida A sxemasining to'liq versiyasi va B uchun farqlar keltirilgan.
Git-dan avtomatik joylashtirishni o'chirib qo'ying
vercel.json ichida:
{
"git": {
"deploymentEnabled": false
}
}Faqat alohida filiallar uchun o‘chirib qo‘yish mumkin: "deploymentEnabled": { "main": false }. Keyin tortishish so'rovlari uchun oldindan ko'rish avtomatik ravishda yaratilishi davom etadi.
Dramaturg konfiguratsiyasi
// 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 tasodifiy qilingan test.only boshqa testlarni oʻtkazib yuborishning oldini oladi. trace: "on-first-retry" shishib ketishining oldini olish uchun faqat beqaror testlar uchun izlarni saqlaydi.
Nimani sinab ko'rish kerak
Joylashtirishdan oldin E2E to'liq qamrab olish uchun joy emas. Pul yoki foydalanuvchilarni buzish uchun stsenariylarni oling:
// 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();
});Oxirgi test sahifani to'g'ridan-to'g'ri yuklashda ko'rinmaydigan xatolar sinfini aniqlaydi: <Link> orqali o'tishda ishdan chiqadi. Sinov foydalanuvchisi faqat test yoki oldindan ko'rish ma'lumotlar bazasida mavjud bo'lishi kerak.
A diagrammasi uchun ish jarayoni
# .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 loyiha sozlamalari va muhit oʻzgaruvchilarini yuklaydi, vercel build chiqishni .vercel/output ga toʻplaydi va deploy --prebuilt uni Vercel tomonida qayta yigʻmasdan yuboradi. Joylashtirish bosqichi faqat avvalgilari o'tgan bo'lsa amalga oshiriladi.
Bu yerda ilova ikki marta qurilgan: joylashtirish uchun vercel build va mahalliy ishga tushirish uchun npm run build. Agar sinov majmuasi ishlab chiqarish ma'lumotlar bazasiga kirsa, bu xavfli - npm run build va next start uchun alohida sinov muhiti o'zgaruvchilaridan foydalaning.
B sxemasidagi farqlar
Mahalliy server oʻrniga E2E_BASE_URL ni oldindan koʻrishni joylashtirish manzili bilan oʻrnating (vercel deploy --token=... uni stdout’da chop etadi). Ko'rib chiqish odatda Deployment Protection tomonidan yopiladi; avtomatlashtirish uchun loyiha sozlamalarida Avtomatlashtirish uchun himoyani aylanib o'tishni yoqing va sirni x-vercel-protection-bypass sarlavhasiga o'tkazing - yuqoridagi konfiguratsiya allaqachon buni amalga oshiradi. Muvaffaqiyatli sinovlardan so'ng, vercel promote <url> --token=... ni ishga tushiring.
Avariyalar bilan qanday kurashish kerak
playwright-reportartefaktini yuklab oling vanpx playwright show-reportni oching. Iz har bir qadamda DOM, tarmoq va konsolni ko'rsatadi.- Sinov faqat CIda ishlamay qoladi: ko'pincha aybdor sovuq boshlash yoki turli vaqt zonalarida vaqt o'tishi hisoblanadi.
useichidagiTZvalocaleni solishtiring. - Stabil bo'lmagan test
retriesmiqdorini oshirish orqali davolanmaydi.waitForTimeoutorqali kutishni qidiring va uniexpectorqali holat tekshiruvi bilan almashtiring.
Keraksiz bo'lganda
Shakllar va ruxsatsiz statik sayt uchun havolalarni yaratish va tekshirish kifoya. Agar testlar 10-15 daqiqadan ko'proq vaqt talab qilsa, ularni ajrating: qisqa tutun to'plami joylashtirishni bloklaydi, to'liq to'plam rejalashtirilgan tarzda davom etadi.