WMS_MAIN/script/warehouse-cert-sync.config.prod.json
liufumingren 0918f2d572 feat(deploy): 证书同步改为单片段 include + ver 命名 + 声明式自愈与差集下线
- 站点内容外置为单一片段(upstreamInclude,运维维护):生成的 server 块 = 证书骨架 +
  一行 include <片段>,撤掉此前的 customDir 多片段方案;并强制 include 必须是绝对路径
  且文件已存在(nginx 解析相对 include 的基准是 nginx prefix,不是脚本 cwd,写相对路径
  会让 nginx -t 失败并回滚整轮变更),不满足直接 exit 1(dry-run 下仅告警)
- conf 命名加版本位 <domain>-<ver>.conf:轮转只改配置的 ver,旧命名自动清理并 reload
- 声明式对账自愈:证书 / 私钥 / server 块缺失或被改坏,按库内内容原子重建后统一
  nginx -t + reload(内容一致时零写入、零 reload);失败态(sync_status=2)同样参与
  收敛并在校验通过后回到 1;nginx -t / reload 属全局失败,只落 last_sync_error 下轮
  重试,不再把行写成 2 卡死
- 域名下线改为配置差集驱动:以「已配置 + 已验证 + 证书就绪」的期望集合为准(同一仓库
  只取 id 最小的一条),目录中属于本系统命名规则但配置里已无该域名的 conf / 证书直接
  删除并 reload;不再消费 retired_domain(该列仅作应用侧审计留痕)
- 证书未配置的行不写 conf 也不作为文件保留依据(遗留产物由差集回收,避免 conf 引用
  不存在的证书导致 nginx -t 全局失败),行状态回写 sync_status=0 待同步;证书非空但
  非法、域名形态非法才记行级失败(2)
- cert-sync 部署命令瘦身为 install / uninstall;新增 watchdog 部署命令(precheck /
  install / status / dry-run / run),安装路径统一到 script/;deploy-lib 保护生产运行时
  配置不被发布覆盖;README 补「发布与运维」章节(目录硬约定 / 定时任务 / 命令清单)
2026-09-28 01:02:23 +08:00

12 lines
1.8 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"description": "生产环境配置(Linux 服务器 / 宝塔构建 nginx,systemd 管理)。脚本以部署根 /www/wwwroot/qimen 为 cwd 运行;证书与生成的 server 块固定放在【工程目录内】:certDir=<部署根>/.ssl、confDir=<部署根>/nginx_config(相对 cwd 解析,目录不存在时自动递归创建),与开发环境仓库根的 .ssl / nginx_config 同构。目录名是【硬约定】,改名必须同步改:① nginx 主配置的 include;② 本文件;③ 库表 wms_warehouse_front_config.cert_path/key_path(触发重同步刷新),详见 README「发布与运维」。ver 为 conf 命名版本:生成的 server 块文件名为 <domainSafe><suffix>-<ver>.conf(如 web.wms.gztbyc.com-1.conf);证书/私钥文件名不变。轮转时改本键(或传 --ver / CERT_SYNC_VER),下一轮脚本自动删除旧命名并生成新命名后 reload。站点内容片段路径 = upstreamInclude(生产为 /www/wwwroot/qimen/front.conf,运维维护):生成的 server 块 = 证书骨架 + 一行 include <upstreamInclude>,站点 root / 伪静态 或 反代统一由该片段提供,脚本绝不覆盖,前端个性化在运行时由配置接口按域名完成。【红线】upstreamInclude 必须写绝对路径且片段文件必须先存在(nginx 解析相对 include 的基准是 nginx prefix,如 /www/server/nginx/conf,不是脚本 cwd;写相对路径会让 nginx -t 失败并回滚整轮变更);脚本启动即校验,不满足直接 exit 1。reload 走 systemctl reload nginx,test 直接调 /usr/bin/nginx -t。",
"nginxBin": "/usr/bin/nginx",
"nginxPrefix": "",
"certDir": "./.ssl",
"confDir": "./nginx_config",
"ver": "1",
"upstreamInclude": "/www/wwwroot/qimen/front.conf",
"testCmd": "{nginxBin} -t",
"reloadCmd": "systemctl reload nginx"
}