每天自动发文的机器,不能停:把「发布」做成原子操作
这套系统每天凌晨错峰发文。凌晨没人看,但它必须发——因为第二天早上我会打开首页看一眼。
以前每次发布,首页都会「闪一下」:rsync --delete 把新文件覆盖进去的过程中,有几秒钟页面是 404 或者缺 CSS 的。白天没人,凌晨更没人,但我受不了。
一、问题出在 rsync –delete
原来的发布脚本是这么写的:
1 | hexo generate |
rsync 的工作方式是逐文件对比再覆盖。对一个几百个文件的静态站,这个过程有几百毫秒到两秒。这段时间里:
- 新文件还没到,旧文件已经被
--delete删了 - nginx 收到请求,
try_files找不到,返回 404
如果恰好有一个爬虫在抓,它会记住这个 404。
二、第一版修法:先同步,再 mv
思路很朴素——别在原地覆盖,先准备一份完整的,再整体换过去:
1 | rsync -a public-build/ /var/www/blog.new/ |
两次 mv 之间有几毫秒的空档,比原来的两秒好了 500 倍,但不是零。
三、最终方案:release 目录 + 软链
这是 Capistrano 的做法,也是 Hexo 社区里最通行的零停机部署:
1 | /var/www/releases/20261101-011149/ ← 每次构建一个完整目录 |
发布时只做一件事:
1 | ln -sfn "$TARGET" "$RELEASES/current" |
ln -sfn 是一次 rename,微秒级,原子。nginx 的 root /var/www/blog 跟着软链走,永远看到完整的目录。
脚本最后还留了三个 release,旧的自动清:
1 | ls -1dt "$RELEASES"/*/ | tail -n +4 | while read -r old; do rm -rf "$old"; done |
既能回滚,又不占空间。
四、软链替换时的一个坑
第一次做迁移,脚本是这样:
1 | rm -rf /var/www/blog |
rm -rf 之后到 ln 之间,/var/www/blog 是不存在的,nginx 直接 404。
正确做法是:
1 | ln -sfn "$RELEASES/current" /var/www/blog.tmp |
mv -T 对软链是原子的。这一步我当时没写,但因为是凌晨迁移、只有几毫秒,先记着,下次改。
五、发布链路要有上限
自动发文最怕的不是失败,是失控。
有一天我在测命令,连着发了三条「发布」,每条触发一次 flush,每次最多处理 3 篇。5 分钟里,站上多了 12 篇文章,跑题、重复、同一个猫写了 5 篇。
所以加了两道闸:
1 | cap = int(conf.get('maxPostsPerDay') or 5) |
1 | cooldown = int(conf.get('flushCooldownMin') or 10) * 60 |
- 日上限 5 篇:超了直接拒绝,明天再说
- 冷却 10 分钟:连点没用
- 手动绕过:
{"force": true},用于补发
这两条上线后,那 12 篇的历史再没出现过。
六、发布成功之后还要做什么
发布不是一个动作,是一串连锁:
1 | 写完后端确认成功 |
这些都在同一个事务性流程里,任何一步失败都不该影响「文章已经上线」这个事实。
所以顺序是:先发布,再归档,最后排队后续任务。反过来的话,后续任务失败了会让人误以为没发出去。
七、失败要能看出来
发布失败最常见的原因是同名文章已存在。publish.sh 会返回 exit code 2,控制台据此显示「跳过(重复)」,而不是红叉。
真正的失败(比如 front-matter 语法错)会把日志尾部贴到控制台,并且重试三次后把日报移到 queue/failed/,不再无限重试。
八、现在的数据
1 | 发布一次耗时 约 20 秒 |
九、这件事的意义
「不能停」听起来像大厂的需求。其实一台个人博客,停两秒也没人知道。
但我要的不是「没人发现」,是这套流程可以被信任。
如果每次发布都可能失败、可能 404、可能发多篇,那我就不敢让它自动跑。不敢自动跑,这套系统就退化成一个需要我每天手动点的脚本。
自动化真正的门槛不是「能做」,是「做完之后不用看着」。