ci-cd-and-automation

CI/CD 与自动化

概览

把质量门禁自动化，确保任何改动在通过测试、lint、类型检查和构建之前，都不能进入生产环境。CI/CD 是其他所有 skill 的执行保障机制，它能稳定地捕捉人类和 agent 都会漏掉的问题，而且对每一次改动一视同仁。

Shift Left： 尽量在流水线更前面发现问题。一个在 lint 阶段发现的 bug，代价可能只是几分钟；同样的问题到了生产环境，代价可能是几小时。要把检查前移，静态分析早于测试，测试早于 staging，staging 早于 production。

越快越安全： 更小的改动批次和更频繁的发布，并不会增加风险，反而会降低风险。只有 3 个改动的部署，比带着 30 个改动的部署更容易调试。频繁发布也会增强团队对发布流程本身的信心。

何时使用

• 为新项目搭建 CI 流水线
• 增加或修改自动化检查
• 配置部署流水线
• 某项改动应该触发自动验证时
• 调试 CI 失败

质量门禁流水线

每一个改动在合并前都必须通过这些门禁：

Pull Request Opened
    │
    ▼
┌─────────────────┐
│   LINT CHECK     │  eslint, prettier
│   ↓ pass         │
│   TYPE CHECK     │  tsc --noEmit
│   ↓ pass         │
│   UNIT TESTS     │  jest/vitest
│   ↓ pass         │
│   BUILD          │  npm run build
│   ↓ pass         │
│   INTEGRATION    │  API/DB tests
│   ↓ pass         │
│   E2E (optional) │  Playwright/Cypress
│   ↓ pass         │
│   SECURITY AUDIT │  npm audit
│   ↓ pass         │
│   BUNDLE SIZE    │  bundlesize check
└─────────────────┘
    │
    ▼
  Ready for review

任何门禁都不能跳过。 Lint 失败就修 lint，不要关规则。测试失败就修代码，不要跳过测试。

GitHub Actions 配置

基础 CI 流水线

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

on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Lint
        run: npm run lint

      - name: Type check
        run: npx tsc --noEmit

      - name: Test
        run: npm test -- --coverage

      - name: Build
        run: npm run build

      - name: Security audit
        run: npm audit --audit-level=high

带数据库集成测试

  integration:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_DB: testdb
          POSTGRES_USER: ci_user
          POSTGRES_PASSWORD: ${{ secrets.CI_DB_PASSWORD }}
        ports:
          - 5432:5432
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'
      - run: npm ci
      - name: Run migrations
        run: npx prisma migrate deploy
        env:
          DATABASE_URL: postgresql://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
      - name: Integration tests
        run: npm run test:integration
        env:
          DATABASE_URL: postgresql://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb