Skip to content

v0.5.2:剥 BOM + mirror 切换前的三个坑

Choose a tag to compare

@XneoZero XneoZero released this 12 Nov 07:52
· 6 commits to main since this release

修掉两个会让部署通道「哑掉」的坑

1. 配置文件带 BOM 时 deployer 直接起不来

bin/airlock-deployer.mjs 与 bin/airlock-broker.mjs 在解析配置前先剥掉 UTF-8 BOM。
之前用 PowerShell 5.1 的 Set-Content -Encoding utf8 改过 deployer.json,BOM 会让 JSON.parse 抛错,
而这一步发生在握手之前——客户端只看到「部署器没有返回响应」,完全看不出是编码问题。

2. 切 mirror 的三个前置条件写进文档

docs/DEPLOY.md 新增「从 nested 切到 mirror 之前,先处理三条」:

  • install / start 钩子不能再往版本目录里造 junction:镜像同步遇到 junction 会把它当文件复制而失败,
    而 mirror 布局没有回退,失败时网站停在半路;
  • Windows 计划任务的运行主体必须是 SYSTEM:Register-ScheduledTask 不指定 -Principal 时默认
    「只使用交互式」,从 ssh / deployer 这类非交互会话里会静默不执行(任务显示「上次运行时间: N/A」);
  • 配置文件要纯 UTF-8、别带 BOM。

已在生产上实测:qingmang 从 nested 切到 mirror 后,落点目录就是发布源的副本
(117 个文件,不再有 releases/、current、state.json、shared/),
状态与日志移到 <落点父目录>/.airlock/<应用id>/,整条 stop → 同步 → start → 健康检查链路跑通。