- 站点内容外置为单一片段(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 补「发布与运维」章节(目录硬约定 / 定时任务 / 命令清单)
12 lines
1.8 KiB
JSON
12 lines
1.8 KiB
JSON
{
|
||
"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"
|
||
}
|