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,实际环境可以替换为团队约定的应用根目录。

bash
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"

预期输出:

text
/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 的真实目标,并至少保留当前版本和一个可用的前一版本。目录规划一旦把“不可变版本”和“共享状态”分开,后续自动部署、健康检查与回滚都会变得更简单,也更容易审计。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

规划服务器部署目录

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通