Repository navigation
v0.5.2:剥 BOM + mirror 切换前的三个坑
修掉两个会让部署通道「哑掉」的坑
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 → 健康检查链路跑通。