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
构建产物应作为后续部署的唯一输入,避免「构建一次、部署多次」导致内容漂移。
部署阶段
静态站点常见方案:
- 构建产物上传到对象存储(COS / S3)
- 配置 CDN 与自定义域名
- HTML 不缓存,静态资源长缓存
- 发布后做一次线上冒烟检查
# 示例:上传构建产物
pnpm deploy
密钥通过 CI 的环境变量注入,不要写进仓库。
缓存策略
| 资源 | 缓存 |
|---|---|
| HTML | 不缓存 |
| 带哈希的 JS / CSS | 一年 immutable |
| 图片 / 字体 | 一天到一周 |
| 接口 | 按业务决定 |
回滚
- 保留最近若干个版本
- 静态资源带哈希,可安全回滚 HTML
- 数据库或接口变更需要单独的迁移与回滚方案
- 回滚操作必须可一键执行
质量门槛
建议在 CI 中至少包含:
- 依赖锁文件未变化
- 类型检查通过
- 单元测试通过
- 构建成功且产物体积在阈值内
- 部署后首页与关键页面返回 200
常见问题
- CI 与本地结果不一致:Node 版本、环境变量或锁文件不同
- 密钥泄漏:把 Secret 写进配置文件并提交
- 部署成功但页面空白:静态资源路径或 base 配置错误
- 缓存导致旧页面:HTML 被 CDN 缓存
- 构建时间过长:缺少依赖缓存或全量重复构建
实践建议
- 流水线步骤保持线性、可读
- 每个阶段输出清晰日志,失败时能快速定位
- 部署前做一次 dry-run,确认将上传的文件
- 把「发布」与「验证」绑定,避免只发布不检查