CI/CD / 系统课时
规划服务器部署目录
规划服务器部署目录
服务器部署最容易出问题的地方,不是复制文件本身,而是版本、配置、日志和“当前运行版本”混在一起。本课把这些职责拆开,用不可变版本目录加 current 软链接形成可回滚的目录结构,并给出可直接验证的初始化命令。
学习目标
- 区分版本目录、共享配置、共享日志和当前版本链接的职责。
- 创建支持原子切换与快速回滚的服务器部署目录。
- 验证
current始终指向一个明确的不可变版本。
先固定目录职责
推荐把应用根目录设为一个稳定位置,例如 /srv/myapp。版本制品只写入 releases/<ID>,部署完成后不再原地修改;跨版本复用的配置放在 shared/config,运行日志放在 shared/logs;current 只负责指向当前生效版本。
| 路径 | 职责 | 是否随版本变化 |
|---|---|---|
/srv/myapp/releases/<ID> |
单次发布的应用制品 | 是 |
/srv/myapp/shared/config |
服务器级共享配置 | 否 |
/srv/myapp/shared/logs |
持久化运行日志 | 否 |
/srv/myapp/current |
指向当前版本的软链接 | 指向目标会变化 |

创建目录并切换当前版本
下面命令用于首次初始化。将 <ID> 替换为当前发布的不可变版本标识,例如构建号或提交哈希。示例使用 /srv/myapp,实际环境可以替换为团队约定的应用根目录。
APP_ROOT="/srv/myapp"
RELEASE_ID="<ID>"
sudo install -d -m 0755 "$APP_ROOT/releases/$RELEASE_ID"
sudo install -d -m 0755 "$APP_ROOT/shared/config"
sudo install -d -m 0755 "$APP_ROOT/shared/logs"
sudo ln -sfn "$APP_ROOT/releases/$RELEASE_ID" "$APP_ROOT/current"
readlink -f "$APP_ROOT/current"预期输出:
/srv/myapp/releases/<ID>ln -sfn 只切换链接本身,不需要覆盖旧版本目录,因此回滚时可以把 current 再指回上一个已验证版本。实际生产中还应在切换前确认新版本文件完整、权限正确,并在切换后重启或重载对应服务。
让版本目录保持不可变
发布流程应先把制品完整解压或复制到新的 releases/<ID>,再做配置引用、权限检查和健康检查。只有这些步骤通过后,才修改 current。不要在 current 指向的目录里执行增量覆盖,因为这会让正在运行的版本处于半更新状态。
共享配置可以通过启动参数显式指定,例如让应用读取 /srv/myapp/shared/config/application.yaml;日志同样应直接写入 /srv/myapp/shared/logs,或交给 systemd/journald 等日志系统统一接管。核心原则是:版本制品可替换,共享状态不随版本删除。
为回滚和清理留出空间
保留最近若干个已验证版本,可以在新版本异常时快速回切。回滚动作只需要把 current 指向旧版本,再按应用要求重启服务;不要重新下载或重新打包旧制品,否则回滚路径本身也会引入不确定性。
清理旧版本时必须先解析 current 的真实目标,并至少保留当前版本和一个可用的前一版本。目录规划一旦把“不可变版本”和“共享状态”分开,后续自动部署、健康检查与回滚都会变得更简单,也更容易审计。