GitHub әрекеттеріндегі драматург E2E Vercel қолданбасына орналастыру алдындағы міндетті қадам ретінде
Әдепкі орналастыру мәселесі
GitHub жүйесіне қосылған Vercel жобасы main ішіндегі әрбір итеруді тікелей өндіріске орналастырады. GitHub әрекеттеріндегі сынақтар параллель орындалады және олар сәтсіз болса, бұзылған нұсқа пайдаланушыларға әлдеқашан қызмет етеді. Бізге тәртіп қажет: алдымен сынақтар, содан кейін орналастыру және дәл сыналған жинақты орналастыру.
Екі жұмыс схемасы бар.
А схемасы. CI қолданбаны құрастырады, оны жергілікті түрде іске қосады, Playwright бағдарламасын іске қосады және сәтті болса, жиналған артефактты Vercelге CLI арқылы жібереді.
В схемасы. Vercel алдын ала қарау орналастыруын жасайды, CI оны URL мекенжайы арқылы сынайды және сәтті болса, бірдей орналастыру өндіріске көтеріледі.
А схемасын конфигурациялау оңай және алдын ала қарау мүмкіндігіне байланысты емес. B схемасы нақты Vercel инфрақұрылымын (орталық бағдарламалық құрал, шеткі функциялар, алдын ала қарау ортасының айнымалы мәндері) тексереді. Төменде А схемасының толық нұсқасы және В үшін айырмашылықтар берілген.
Git-тен автоматты орналастыруды өшіріңіз
vercel.json ішінде:
{
"git": {
"deploymentEnabled": false
}
}Жеке филиалдар үшін ғана өшіруге болады: "deploymentEnabled": { "main": false }. Содан кейін тарту сұраулары үшін алдын ала қарау автоматты түрде жасала береді.
Драматург конфигурациясы
// 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> арқылы өту кезінде бұзылады. Сынақ пайдаланушысы тек сынақ немесе алдын ала қарау дерекқорында болуы керек.
А диаграммасының жұмыс барысы
# .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 үшін бөлек сынақ ортасының айнымалы мәндерін пайдаланыңыз.
В схемасындағы айырмашылықтар
Жергілікті сервердің орнына алдын ала қарауды орналастыру мекенжайымен E2E_BASE_URL орнатыңыз (vercel deploy --token=... оны stdout ішіне басып шығарады). Алдын ала қарау әдетте Deployment Protection арқылы жабылады; автоматтандыру үшін жоба параметрлерінде Автоматтандыру үшін қорғауды айналып өту мүмкіндігін қосыңыз және құпияны x-vercel-protection-bypass тақырыбына жіберіңіз - жоғарыдағы конфигурация мұны жасайды. Сәтті сынақтардан кейін vercel promote <url> --token=... іске қосыңыз.
Апаттармен қалай күресуге болады
playwright-reportартефактісін жүктеп алып,npx playwright show-reportашыңыз. Бақылау әр қадамда DOM, желі және консольді көрсетеді.- Сынақ тек CI-де бұзылады: көбінесе кінәлі - суық бастау немесе әртүрлі уақыт белдеулері кезінде күту уақыты.
useішіндегіTZжәнеlocaleсалыстырыңыз. - Тұрақсыз сынақ
retriesкөбейту арқылы өңделмейді.waitForTimeoutарқылы күтуді іздеңіз және оныexpectарқылы күйді тексерумен ауыстырыңыз.
Бұл қажетсіз болған кезде
Пішіндері мен рұқсаты жоқ статикалық сайт үшін сілтемелерді құру және тексеру жеткілікті. Сынақтар 10–15 минуттан астам уақытты алса, оларды бөліңіз: қысқа түтін жинағы орналастыруды блоктайды, толық жиынтық жоспарланғандай орындалады.