1.8 KiB
1.8 KiB
11.1 部署 Checklist
:::tip 概述 生产上线前逐项核对。本章各页是展开说明，本页是可打印的检查清单。 :::
上线前
- 生产数据库已初始化（种子脚本或 migrator 搬迁），账号最小权限
- Redis 就绪且设置了密码（生产禁用空密码）
app.prod=true（触发启动红线校验）- JWT 密钥已更换且长度足够（非默认值）
generator.enable=false（生成器关闭）captcha.bypassCode为空（无万能码）api.docs=false（或网关封锁 /swagger、/api.json）api.metrics按需关闭或内网保护cors.allowOrigin收敛到实际前端域名api.proxyIps与真实反代拓扑一致（未配 0.0.0.0/0）file.domainUrl为 https 域名且 nginx 已配置直供- 上传目录、日志目录磁盘容量评估完成
- 日志保留天数（job.logRetentionDays）符合合规要求
make check通过（fmt + vet + test-short + check-config）- 前端
pnpm build产物部署、history 回退配置完成 - HTTPS 证书就绪（Nginx 终止 TLS）
- 备份策略就绪（数据库 + upload 目录，见 11.9）
上线后
curl /api/health返回正常- 登录 → 菜单 → 核心页面冒烟通过
- 错误日志无启动告警（WireCheck / Redis 降级）
- 监控接入（/metrics 抓取或应用内监控页）
- 操作日志正常落库
- 定时任务调度器运行（任务管理页 DaemonStatus）
回滚预案
- 上一版本二进制/镜像可回滚
- 数据库变更（如有）有回滚脚本
- 回滚演练完成