CI/CD 从构建到部署

持续集成的目标不是「自动化一切」,而是让每次变更都能以可重复的方式验证与交付。

一条最小流水线

steps:
  - install
  - typecheck
  - test
  - build
  - deploy

每一阶段都应该有明确的失败条件,失败后立即停止,避免把问题带到下一阶段。

安装阶段

  • 使用锁文件:pnpm install --frozen-lockfile
  • 缓存包管理器存储目录,缩短安装时间
  • 固定 Node 版本,避免本地与 CI 行为不一致
- uses: pnpm/action-setup@v4
  with:
    version: 9
- uses: actions/setup-node@v4
  with:
    node-version: 22
    cache: pnpm
- run: pnpm install --frozen-lockfile

校验阶段

pnpm typecheck
pnpm lint
pnpm test
  • 类型检查不能只依赖编辑器
  • 测试至少覆盖核心业务路径
  • lint 与格式检查放在同一阶段,减少往返

构建阶段

pnpm build

构建产物应作为后续部署的唯一输入,避免「构建一次、部署多次」导致内容漂移。

部署阶段

静态站点常见方案:

  1. 构建产物上传到对象存储(COS / S3)
  2. 配置 CDN 与自定义域名
  3. HTML 不缓存,静态资源长缓存
  4. 发布后做一次线上冒烟检查
# 示例:上传构建产物
pnpm deploy

密钥通过 CI 的环境变量注入,不要写进仓库。

缓存策略

资源 缓存
HTML 不缓存
带哈希的 JS / CSS 一年 immutable
图片 / 字体 一天到一周
接口 按业务决定

回滚

  • 保留最近若干个版本
  • 静态资源带哈希,可安全回滚 HTML
  • 数据库或接口变更需要单独的迁移与回滚方案
  • 回滚操作必须可一键执行

质量门槛

建议在 CI 中至少包含:

  1. 依赖锁文件未变化
  2. 类型检查通过
  3. 单元测试通过
  4. 构建成功且产物体积在阈值内
  5. 部署后首页与关键页面返回 200

常见问题

  1. CI 与本地结果不一致:Node 版本、环境变量或锁文件不同
  2. 密钥泄漏:把 Secret 写进配置文件并提交
  3. 部署成功但页面空白:静态资源路径或 base 配置错误
  4. 缓存导致旧页面:HTML 被 CDN 缓存
  5. 构建时间过长:缺少依赖缓存或全量重复构建

实践建议

  • 流水线步骤保持线性、可读
  • 每个阶段输出清晰日志,失败时能快速定位
  • 部署前做一次 dry-run,确认将上传的文件
  • 把「发布」与「验证」绑定,避免只发布不检查