编写后端JAR包蓝绿发布脚本
前端发布脚本的功能
- 保留每一个发布版本,防止新版本异常,方便回撤
- 用户无感知,防止发布过程中的宕机
原理:
发布的JAR包只是一个软连接,新的JAR启动正常后,切换软连接指向即可。蓝绿JAR包绑定端口不同,所以nginx也需要修改反向代理指向路径
发布逻辑
- 上传新JAR包文件到指定目录
- 将新JAR包重命名为日期_时间.JAR
- 通过命令,运行日期_时间.JAR
- 通过spring-boot-actuator健康判断来判断 日期_时间.JAR 是否运行正常
- 运行正常,切换软连接指向 + 更改nginx反向代理配置端口
脚本执行代码:
注意:充分测试脚本后再上生产环境,禁止使用root账号执行脚本,强制要求切换到deploy用户,不熟悉脚本的请手动操作
deploy用户创建,可以查看文章 生成环境项目目录规划
看懂脚本最好也结合 生成环境项目目录规划 来看
#!/usr/bin/env bash
set -euo pipefail# ---- 仅允许 deploy 执行 ----
RUN_AS="$(id -un || true)"
if [[ "$RUN_AS" != "deploy" ]]; thenecho "❌ 本脚本仅允许 deploy 用户执行。当前用户:$RUN_AS"echo " 请使用:su - deploy"exit 126
fi# ===== 固定配置 =====
JAR_SRC="/www/wwwroot/mes_saas/api/upload/mes-saas.jar" # 固定上传路径
BASE="/www/wwwroot/mes_saas"
REL="${BASE}/api/releases" # 版本库根
NGX_BACKEND="${BASE}/nginx/backend.conf" # 切流文件
PORTS=("16888" "16889")
HEALTH_PATH="/actuator/health"
HEALTH_WAIT=25# 外部程序绝对路径(按你的机器确认)
SUDO="/usr/bin/sudo"
JAVA_SERVICE="/usr/bin/java-service"
NGINX="/usr/bin/nginx"
CURL="/usr/bin/curl"
SS="/usr/sbin/ss"
PGREP="/usr/bin/pgrep"
TEE="/usr/bin/tee"
# ====================# 0) 基础校验
[[ -f "$JAR_SRC" ]] || { echo "❌ 未找到上传的 jar 包: $JAR_SRC"; exit 1; }
real_in_prefix() { [[ "$(realpath -m "$1")" == "$(realpath -m "$2")"* ]]; }
real_in_prefix "$REL" "$BASE" || { echo "❌ releases 路径越界:$REL"; exit 1; }
real_in_prefix "$NGX_BACKEND" "$BASE" || { echo "❌ backend.conf 路越界:$NGX_BACKEND"; exit 1; }# 工具函数
listening_by_java() {local port="$1"$SS -lntp 2>/dev/null | grep -q ":$port " && $PGREP -f "java .*--server.port=$port" >/dev/null
}
health_ok() {local port="$1"$CURL -fsS "http://127.0.0.1:${port}${HEALTH_PATH}" | grep -q '"status":"UP"'
}
start_or_restart() {local port="$1"if listening_by_java "$port"; then$SUDO "$JAVA_SERVICE" "mes_saas_${port}" restartelse$SUDO "$JAVA_SERVICE" "mes_saas_${port}" startfi
}
stop_port() { local p="$1"; $SUDO "$JAVA_SERVICE" "mes_saas_${p}" stop || true; }# 1) 检测当前线上端口 ACTIVE
ACTIVE=""
for p in "${PORTS[@]}"; doif listening_by_java "$p"; then ACTIVE="$p"; break; fi
done
[[ -z "$ACTIVE" ]] && ACTIVE="${PORTS[0]}"# 2) 选择目标端口 TARGET(另一个)
TARGET="${PORTS[0]}"
[[ "$ACTIVE" == "${PORTS[0]}" ]] && TARGET="${PORTS[1]}"echo "当前线上端口: $ACTIVE -> 目标端口: $TARGET"# 3) 准备版本目录与软链(给 TARGET)
mkdir -p "${REL}/${TARGET}"
TAG="$(date +%Y%m%d_%H%M%S)"
VER_JAR="${REL}/${TARGET}/mes-saas-${TAG}.jar"
LINK_JAR="${REL}/${TARGET}/mes-saas.jar"mv "$JAR_SRC" "$VER_JAR"
ln -sfn "$VER_JAR" "$LINK_JAR"
echo "已更新 ${LINK_JAR} -> $(basename "$VER_JAR")"# 4) 先启动/重启 目标端口(旧版本仍在线上承载)
echo "启动(或重启) 目标端口 ${TARGET}"
start_or_restart "$TARGET"# 5) 健康检查(未通过就终止,不切流,旧版本继续在线)
echo -n "健康检查: http://127.0.0.1:${TARGET}${HEALTH_PATH} ..."
for i in $(seq 1 "$HEALTH_WAIT"); doif health_ok "$TARGET"; then echo " OK"; break; fisleep 1if [[ $i -eq $HEALTH_WAIT ]]; thenecho " 失败,保持 $ACTIVE 在线,不切换"exit 1fi
done# 6) 健康通过后,切 Nginx 到 TARGET(再 reload)
echo "set \$mes_backend http://127.0.0.1:${TARGET};" | $SUDO $TEE "$NGX_BACKEND" >/dev/null
$SUDO "$NGINX" -t
$SUDO "$NGINX" -s reload
echo "Nginx 已切到端口: ${TARGET}"# 7) 最后再停止旧端口(ACTIVE)
if [[ "$ACTIVE" != "$TARGET" ]]; thenecho "停止旧端口 ${ACTIVE}"stop_port "$ACTIVE"
fiecho "✅ 发布完成。线上端口: ${TARGET}"
最后注意
nignx这里有一个坑,查看文章:nginx采用反向代理的时候使用变量的坑