Nervcode. Notes
系统

静态站发布:把上传和切换分成两步

先把新版本放完整,再切换一个目录入口,保留上版方便回退。

让未上传完的文件保持不可见

直接向生产目录覆盖文件时,访问者可能拿到新 HTML 和旧样式,也可能在内页上传前遇到 404。即使单个文件写入很快,一组互相引用的文件仍不是同时更新的。

把每次构建产物放到独立的版本目录。发布程序在这个目录完成链接检查,确认首页和样式都能读到。检查失败时,旧站仍从原目录服务,用户看不到半成品。

正式入口只做一次切换

在 Linux 上可让 Web 服务指向一个名为 current 的符号链接,再用同一文件系统内的重命名替换这个链接。先建 next 链接、再重命名,比先删 current 再重建少一个入口不存在的窗口。

版本目录之外的状态需要另算。数据库结构、证书和后台任务并不会跟着符号链接回退。纯静态站能用这个方法,是因为所有页面和资源都在同一份产物里。

ln -s releases/20261118 current.next
mv -T current.next current

切换后检查客户端实际拿到的内容

发布完用新请求读首页、内页和错误路径。若 CSS 使用长期缓存,文件名最好带内容哈希,避免客户端继续套用上一版样式。还可以保留前一版的哈希资源,供切换前发出的 HTML 请求使用。

回滚的价值取决于它能否在压力下执行。上线记录里写清前一版链接的目标和验证 URL;确认回退操作走的是同一条切换路径。

同主题:正在运行的 SQLite,怎样确认备份可用?