发布与运维
生产发布只允许不可变镜像标签,顺序固定为:staging 预检 → migration 预检与备份 → 冒烟测试 → UAT 签字 → 生产备份 → 部署 → /health/live、/health/ready 和公开内容冒烟 → 观察 → 必要时回滚到上一镜像标签。禁止使用 latest。
外部准备
- 私有镜像仓库、TLS 证书和合法域名;生产 MySQL、Redis、私有对象存储。
- 微信 AppID/AppSecret、六类订阅消息模板、合法 HTTPS 域名和真机授权。
- 告警接收渠道、异地备份目标、隐私政策/用户协议/主体资质与 UAT/发布审批人。
执行
- 设置
IMAGE_TAG、REGISTRY_IMAGE及.env.example中所有生产必填环境变量。 ./infra/deploy/preflight.ps1 staging,部署 staging,执行 migration 和smoke.ps1。- 完成
docs/14_RELEASE_CHECKLIST.md中 staging/UAT 项并留存证据。 - 使用
infra/backup/backup-mysql.ps1备份并将 SQL、SHA-256 文件同步到异地加密存储。 ./infra/deploy/preflight.ps1 production,部署固定镜像;执行冒烟并观察 5xx、p95、数据库、磁盘、通知死信和备份告警。- 异常时将
IMAGE_TAG恢复到上一批准版本重新部署。若 migration 不向后兼容,停止发布并按已验证的数据库恢复步骤执行。
备份默认每日一次,保留 30 天;必须每季度在独立数据库做恢复演练并记录表数量、关键行数和耗时。脚本会校验 SHA-256,恢复目标数据库名必须显式提供。