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

Hành động GitHub dành cho Next.js: bộ đệm, lint, đánh máy, kiểm tra và bảo vệ chính

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

Цель

Ни один коммит не попадает в main, если не прошли линтер, проверка типов и тесты. Проверки идут быстро за счёт кэша и не жгут минуты на устаревших пушах. Ниже workflow и настройки репозитория, которые превращают его из рекомендации в обязательное условие.

Workflow

# .github/workflows/ci.yml
name: CI

on:
  pull_request:
  push:
    branches: [main]

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

permissions:
  contents: read

jobs:
  quality:
    name: lint-typecheck-test
    runs-on: ubuntu-latest
    timeout-minutes: 15
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version-file: .nvmrc
          cache: npm

      - run: npm ci

      - name: Lint
        run: npm run lint

      - name: Typecheck
        run: npx tsc --noEmit

      - name: Unit tests
        run: npm test -- --run

  build:
    name: build
    runs-on: ubuntu-latest
    needs: quality
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version-file: .nvmrc
          cache: npm
      - run: npm ci
      - uses: actions/cache@v4
        with:
          path: .next/cache
          key: nextjs-${{ runner.os }}-${{ hashFiles('package-lock.json') }}-${{ hashFiles('**/*.ts', '**/*.tsx') }}
          restore-keys: |
            nextjs-${{ runner.os }}-${{ hashFiles('package-lock.json') }}-
      - run: npm run build

Что здесь важно

`concurrency` с `cancel-in-progress`. Три пуша подряд в одну ветку запускают три прогона, нужен только последний. Группа по github.ref отменяет предыдущие для той же ветки или PR, но не трогает другие.

`permissions: contents: read`. По умолчанию GITHUB_TOKEN может получить права на запись. Для проверок они не нужны, и при компрометации зависимости, которая выполняется в CI, токен с минимальными правами ограничивает ущерб.

Кэш npm. setup-node с cache: npm кэширует глобальный кэш пакетов по хешу lock-файла. npm ci при этом всё равно ставит node_modules с нуля, но без скачивания из сети. Кэшировать сам node_modules не стоит: при смене версии Node нативные модули окажутся несовместимыми.

Кэш `.next/cache`. Next.js переиспользует результаты прошлой сборки. Ключ включает хеш исходников, а restore-keys позволяет взять самый свежий кэш с тем же lock-файлом, если точного совпадения нет. Без этого кэша next build в CI выводит предупреждение об его отсутствии.

`.nvmrc`. Одна версия Node локально и в CI. Расхождение версий — частая причина «у меня работает».

Скрипты в package.json

{
  "scripts": {
    "lint": "eslint .",
    "typecheck": "tsc --noEmit",
    "test": "vitest",
    "build": "next build"
  }
}

Команда next lint в новых версиях Next.js объявлена устаревшей, поэтому линтер вызывается напрямую. next build сам проверяет типы, но отдельный шаг tsc --noEmit в первой задаче падает раньше и не тратит время на сборку.

Защита main

Workflow без правил репозитория — просто индикатор. Настройте ruleset (Settings → Rules → Rulesets) или классическую защиту ветки:

  1. 1.Require a pull request before merging — прямые пуши в main запрещены.
  2. 2.Require status checks to pass — добавьте проверки lint-typecheck-test и build. Имена берутся из поля name задачи; если переименовать задачу, правило будет ждать проверку, которая больше никогда не придёт, и PR застрянет.
  3. 3.Require branches to be up to date — PR проверяется с последним состоянием main, а не с тем, от которого его когда-то отвели.
  4. 4.Block force pushes и запрет удаления ветки.
  5. 5.Не добавляйте себя в обход правил «на всякий случай»: обход используется именно в тот вечер, когда тесты падают.

Безопасность workflow

  • Событие pull_request для PR из форков запускается без доступа к секретам — это правильно. Не меняйте его на pull_request_target ради секретов: там workflow выполняется в контексте базовой ветки с правами, и checkout кода из PR даёт чужому коду доступ к ним.
  • Сторонние actions закрепляйте по полному SHA коммита, а не по тегу: тег можно перевесить. Официальные actions/* по мажорной версии — разумный компромисс.
  • Секреты для деплоя держите в Environments с обязательным подтверждением, а не в общих секретах репозитория.

Диагностика

  • PR không hợp nhất, kiểm tra là “Dự kiến ​​- Đang chờ trạng thái”. Tên của kiểm tra được yêu cầu không khớp với tên của nhiệm vụ hoặc quy trình làm việc không bắt đầu do bộ lọc paths. Nếu quy trình làm việc với bộ lọc đường dẫn chưa bắt đầu thì việc kiểm tra bắt buộc sẽ vẫn đang chờ xử lý.
  • Bộ nhớ đệm không được khôi phục. Bộ nhớ đệm được cách ly theo các nhánh: một PR nhìn thấy bộ nhớ đệm của nhánh và bộ đệm cơ sở của nó, nhưng không thấy các PR lân cận. Lần chạy đầu tiên ở chi nhánh mới luôn rất lạnh.
  • Bài kiểm tra bị treo cho đến khi hết thời gian chờ. Vitest ở chế độ quan sát chờ thay đổi. Trong CI, biến CI=true được đặt tự động và Vitest tính đến điều này, nhưng biến --run rõ ràng thì đáng tin cậy hơn.

##Khi nào đủ và khi nào không

Đối với một nhóm gồm một vài người, bộ này bao gồm những điều cơ bản. Các bài kiểm tra E2E trên Playwright được thêm dưới dạng một nhiệm vụ riêng biệt với needs: build khi các tình huống quan trọng của người dùng xuất hiện. Nếu CI mất hơn mười phút, hãy chia các bài kiểm tra thành các phần thông qua ma trận thay vì vô hiệu hóa chúng.

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

Ещё на vbcd4u.com