Linux 与服务器运维 / 系统课时
写发布脚本完成版本切换
写发布脚本完成版本切换
本课把一次发布拆成“准备版本目录、校验产物、切换软链接、验证当前版本”四个明确动作。最终得到一个可重复执行的 Bash 发布脚本,线上目录始终指向完整版本,而不是在原目录中边覆盖文件边运行。
学习目标
- 用独立版本目录保存每次发布产物,避免覆盖正在运行的版本
- 使用原子软链接切换让
current指向目标版本,并保留可审计的版本边界 - 在切换前后执行校验,避免不完整版本进入线上入口
用版本目录隔离每次发布
直接把新文件复制到正在运行的目录有一个明显问题:复制过程中,目录可能同时包含旧文件和新文件。如果服务此时重启或进程读取到一半更新的资源,就可能进入无法复现的混合状态。
更稳妥的布局是让每个版本拥有独立目录,再通过固定软链接暴露当前版本。例如应用根目录 /opt/demo-app 可以维护 releases 和 current:
/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 环境。
#!/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")"执行前准备一个最小发布目录:
mkdir -p /tmp/demo-release
printf 'demo artifact\n' > /tmp/demo-release/app.jar
sudo bash deploy.sh 20260914-002 /tmp/demo-release预期输出如下;实际安装路径应按服务器环境调整:
Release switched successfully
version=20260914-002
current=/opt/demo-app/releases/20260914-002这里没有采用“先删除 current,再创建新链接”的写法,因为两个命令之间会出现短暂空窗。脚本先创建 current.next,然后用同一文件系统内的 mv -T 替换入口,发布边界更清晰。
切换后验证线上入口
脚本返回成功只说明文件和链接操作完成,还要确认 current 指向的确是目标版本。最直接的验证是同时检查软链接和关键文件:
readlink /opt/demo-app/current
find /opt/demo-app/current -maxdepth 1 -type f -printf '%f\n' | sort预期结果至少包含目标版本路径和发布产物:
/opt/demo-app/releases/20260914-002
app.jar如果应用支持版本接口,还应让构建过程把版本号写入产物,并在发布后通过接口读取。这样审计记录中的版本号、目录名和实际运行版本可以互相核对,而不是只相信软链接名称。
保留清晰的失败边界
发布脚本最重要的设计不是命令数量,而是失败发生在哪一步时,线上状态是否仍然明确。创建目录、复制文件和产物校验都发生在切换之前,因此这些步骤失败时不应影响 current。软链接成功切换则意味着新版本已经正式进入线上入口,后续健康检查失败就应该进入回滚流程,而不是继续修改同一个版本目录。
不要在发布后继续向已经启用的版本目录追加文件,也不要复用同一个版本号重新覆盖内容。一个版本目录一旦进入线上,就应当视为不可变发布单元。这样才能根据目录、版本号和发布日志准确回答“现在运行的是哪一版,以及这次发布究竟改变了什么”。