用途:为 Web 应用运行部署工作流,覆盖预览、预发与生产环境,并在部署前后执行质量门禁与验证。
主要能力:输入仓库根目录、目标环境、可选分支/PR 号、部署服务商与健康检查 URL;输出部署前门禁结果、部署路由与服务商、验证状态,以及需要时的回滚或后续指令。可委托 deployment-composer 发现跨服务商部署路由,委托 release-pr-gates 创建分支晋级 PR,委托 github-fix-ci 修复失败的 GitHub Actions 检查,委托 ec2-backend-deployer 处理 EC2/Docker 部署。
必要用法:每次发布 PR 或部署前,必须本地运行格式、lint、类型检查,可选运行测试与构建。优先使用仓库 package.json 中已有脚本:
1. Format - required
bun run format || npm run format || npx biome check --write .
2. Lint - required
bun run lint || npm run lint || bunx turbo lint
3. Type-check - required
bun run typecheck || bun run type-check || npm run typecheck || npm run type-check || npx tsc --noEmit
4. Tests - run when configured
npm test || bun run test --filter=[changed-package]
5. Build - run when configured
npm run build 格式、lint 或类型检查失败时必须先修复,不得把已知本地失败交给 GitHub Actions。
部署流程:预发需确保主干 CI 通过,从主干触发(无 staging 分支),等待 CI 与预发健康检查通过。生产需预发健康、显式确认后从主干部署,并监控健康端点与错误跟踪 15 分钟。热修从主干拉出 hotfix/xxx 分支,修复后 PR 到主干、合并、部署生产。部署后检查健康端点、错误跟踪(如 Sentry)、关键用户流程与部署日志。失败时回滚合并提交并重新部署。
限制与确认:生产部署、合并发布 PR、回滚命令、强制推送或重写历史前均需确认。可能触发外部部署、创建或更新 GitHub PR、读取日志与监控系统。仅在修复失败门禁前做本地修改,发布 PR 仅通过委托生成。平台细节、AWS 模式、CI/CD 集成与回滚流程见 references/workflow.md。