5 Commits

Author SHA1 Message Date
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
liufumingren
3c252a65d3 feat(deploy): 证书同步脚本支持站点个性化配置外置(customDir 契约)
生成的 server 块不再内联 location /,改为只含证书骨架(listen / server_name /
ssl_certificate*),尾部以 include <customDir>/<domain>/*.conf 收口;站点级
location / root / 伪静态等个性化配置由运维放进该目录,脚本绝不内联、绝不覆盖。
默认目录 <confDir>/custom(生产 /www/wwwroot/nginx_config/custom、开发
D:/wms/nginx_config/custom),位于部署根上一级之外,发布回退不会触碰。

配置入口:新增 `--custom-dir` 参数、`CERT_SYNC_CUSTOM_DIR` 环境变量与配置键 customDir,
缺省即 <confDir>/custom;--help、参数解析默认值与启动日志同步补充。

目录维护(ensureCustomConf,幂等且绝不覆盖用户文件):
- 递归创建 <customDir>/<domain>/(0755),保证 server 块 include 的通配符始终合法
  (目录不存在 / 目录为空 / 目录有文件 三种情况 nginx -t 均通过,已在生产 nginx 1.28.0 实测);
- 目录内已有其它 *.conf → 视为用户自定义配置:不写默认文件,并删除脚本自产的
  00-default.conf(避免两个 location / 触发 nginx duplicate location);
- 目录内无其它 *.conf → 首次原子写默认文件 00-default.conf(0644,首行带脚本标记),
  已存在(无论是否被运维改过)一律不覆盖;
- 只有带脚本标记的文件才可能被删除,无标记文件一律不动;dry-run 只打印计划、不落盘。

其它:
- server 块内容校验放宽为「upstreamInclude 或 customGlobPath 命中即可」(upstream
  include 现在位于外置文件内,不再直接出现在 server 块里);
- 旧域名下线仍只删 confDir 根层的 server 块,custom/<domain>/ 目录保留不删
  (旧块删除后其 include 已失效,残留目录无副作用,可被运维移作他用)。
2026-09-27 03:13:21 +08:00
liufumingren
0a31b3aab1 feat(deploy): 证书同步脚本新增 retired_domain 旧域名下线清理与孤儿兜底清理
- warehouse-cert-sync.cjs 消费 wms_warehouse_front_config.retired_domain:
  新增 --cleanup-only / --dry-run 能力,删除旧域名 nginx server 块与证书/私钥文件后
  把 retired_domain 置 NULL;另含 certDir/confDir 目录内孤儿兜底清理
  (路径前缀校验 + 命名白名单双闸门,删除失败只告警不中断;未执行迁移时降级跳过)
- deploy-cert-sync.cjs 新增 cleanup-dry-run / cleanup 远端命令,用与 crontab
  相同的 flock 锁文件串行化执行(缺 flock 时告警降级不加锁,不阻断运维)
- package.json 补充 deploy:cert-sync:cleanup-dry-run / deploy:cert-sync:cleanup 脚本
- 顺带为 precheck/install/status/config-check 4 个函数补齐中文 @param JSDoc

注:为 frontConfig 两阶段切域(3f5eb49)的配套下线闭环,生产库迁移 20260924180000
已先行执行(属 orphan meta 补齐入库)。
2026-09-25 23:42:01 +08:00
liufumingren
52181c44bd feat(frontConfig): 前端独立部署域名验证(DNS TXT 校验 + 验证闸门),frontConfig 接口从 setting.warehouse 迁移至独立 service(getInfo/getCert/saveInfo/saveCert/setDomain/getDomain/checkDomain) 2026-09-24 03:26:15 +08:00
liufumingren
b1000fd0e8 chore(deploy): 证书同步双环境配置发布约定落地
- 发布/回退链路新增固定文件排除与保护:warehouse-cert-sync 两份环境配置不进发布包、清理时暂存/放回,服务器副本不被覆盖/删除(deploy-lib 独立常量 + 共用守卫函数)

- deploy-cert-sync 新增 config-check 只读核对;install 对 prod 配置首次放置一次、之后永不覆盖;dev 配置永不上传生产

- 薄包装简化:nginx 二进制/upstream/reload 全部收敛到 prod 配置,包装仅保留 cwd+依赖+DB 运行时引导

- 新增 warehouse-cert-sync.cjs 与 dev/prod 双环境配置;package.json 增加 deploy:cert-sync:config-check
2026-09-08 04:26:39 +08:00