Linux 与服务器运维 / 系统课时

写发布脚本完成版本切换

写发布脚本完成版本切换

本课把一次发布拆成“准备版本目录、校验产物、切换软链接、验证当前版本”四个明确动作。最终得到一个可重复执行的 Bash 发布脚本,线上目录始终指向完整版本,而不是在原目录中边覆盖文件边运行。

学习目标

  • 用独立版本目录保存每次发布产物,避免覆盖正在运行的版本
  • 使用原子软链接切换让 current 指向目标版本,并保留可审计的版本边界
  • 在切换前后执行校验,避免不完整版本进入线上入口

用版本目录隔离每次发布

直接把新文件复制到正在运行的目录有一个明显问题:复制过程中,目录可能同时包含旧文件和新文件。如果服务此时重启或进程读取到一半更新的资源,就可能进入无法复现的混合状态。

更稳妥的布局是让每个版本拥有独立目录,再通过固定软链接暴露当前版本。例如应用根目录 /opt/demo-app 可以维护 releases 和 current:

text
/opt/demo-app/
  releases/
    20260914-001/
    20260914-002/
  current -> /opt/demo-app/releases/20260914-002

业务进程、Nginx 配置或启动脚本只访问 /opt/demo-app/current。发布时先完整创建新的版本目录,确认它可以使用后,再一次性修改 current 指向。

基于版本目录与软链接的发布切换流程

这种结构把“上传文件”和“让线上使用新版本”分成两个阶段。即使上传失败,current 仍指向旧版本;只有完整版本通过检查后,才真正进入线上入口。

编写可重复执行的发布脚本

下面脚本假设发布包已经解压到一个临时目录。它接收版本号和源目录两个参数,把内容复制到独立版本目录,再使用 ln -sfn 更新软链接。示例面向常见 GNU/Linux 环境。

bash
#!/usr/bin/env bash
set -Eeuo pipefail

APP_ROOT="/opt/demo-app"
RELEASES_DIR="$APP_ROOT/releases"
CURRENT_LINK="$APP_ROOT/current"

VERSION="${1:-}"
SOURCE_DIR="${2:-}"

if [[ -z "$VERSION" || -z "$SOURCE_DIR" ]]; then
  echo "Usage: $0 <version> <source-dir>" >&2
  exit 2
fi

if [[ ! -d "$SOURCE_DIR" ]]; then
  echo "Source directory not found: $SOURCE_DIR" >&2
  exit 3
fi

TARGET_DIR="$RELEASES_DIR/$VERSION"

if [[ -e "$TARGET_DIR" ]]; then
  echo "Release already exists: $TARGET_DIR" >&2
  exit 4
fi

mkdir -p "$RELEASES_DIR"
mkdir "$TARGET_DIR"

# 先复制成完整版本,任何失败都会在切换 current 之前终止。
cp -a "$SOURCE_DIR"/. "$TARGET_DIR"/

if [[ ! -f "$TARGET_DIR/app.jar" ]]; then
  echo "Required artifact missing: app.jar" >&2
  rm -rf "$TARGET_DIR"
  exit 5
fi

# 先创建临时链接,再原子替换 current,避免暴露半完成入口。
ln -s "$TARGET_DIR" "$APP_ROOT/current.next"
mv -Tf "$APP_ROOT/current.next" "$CURRENT_LINK"

echo "Release switched successfully"
echo "version=$VERSION"
echo "current=$(readlink "$CURRENT_LINK")"

执行前准备一个最小发布目录:

bash
mkdir -p /tmp/demo-release
printf 'demo artifact\n' > /tmp/demo-release/app.jar
sudo bash deploy.sh 20260914-002 /tmp/demo-release

预期输出如下;实际安装路径应按服务器环境调整:

text
Release switched successfully
version=20260914-002
current=/opt/demo-app/releases/20260914-002

这里没有采用“先删除 current,再创建新链接”的写法,因为两个命令之间会出现短暂空窗。脚本先创建 current.next,然后用同一文件系统内的 mv -T 替换入口,发布边界更清晰。

切换后验证线上入口

脚本返回成功只说明文件和链接操作完成,还要确认 current 指向的确是目标版本。最直接的验证是同时检查软链接和关键文件:

bash
readlink /opt/demo-app/current
find /opt/demo-app/current -maxdepth 1 -type f -printf '%f\n' | sort

预期结果至少包含目标版本路径和发布产物:

text
/opt/demo-app/releases/20260914-002
app.jar

如果应用支持版本接口,还应让构建过程把版本号写入产物,并在发布后通过接口读取。这样审计记录中的版本号、目录名和实际运行版本可以互相核对,而不是只相信软链接名称。

保留清晰的失败边界

发布脚本最重要的设计不是命令数量,而是失败发生在哪一步时,线上状态是否仍然明确。创建目录、复制文件和产物校验都发生在切换之前,因此这些步骤失败时不应影响 current。软链接成功切换则意味着新版本已经正式进入线上入口,后续健康检查失败就应该进入回滚流程,而不是继续修改同一个版本目录。

不要在发布后继续向已经启用的版本目录追加文件,也不要复用同一个版本号重新覆盖内容。一个版本目录一旦进入线上,就应当视为不可变发布单元。这样才能根据目录、版本号和发布日志准确回答“现在运行的是哪一版,以及这次发布究竟改变了什么”。

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

目录与阅读设置

阅读设置

17

记录一个想法

写发布脚本完成版本切换

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

登录哪都通