当前位置：首页 > news >正文

jenkins springCloud项目优雅下线

news 2025/7/29 4:14:41

文章目录

- 场景
- 解决
- 下线请求效果如图
- 贴一个可用的部署脚本

场景

在 Spring Cloud 项目的微服务实例关闭时，需要首先从注册中心设置为下线，避免该服务的消费者继续请求该服务实例，导致请求失败
如果我们在服务实例从注册中心取消注册后，立即销毁其它 Spring Bean 的话，会导致当前在处理的请求，又或者服务消费者因为注册中心延迟期间继续打进来的请求，产生处理失败的情况
在 Spring 容器关闭时，Spring Cloud 内置的 AbstractAutoServiceRegistration 会将当前实例从注册中心取消注册，但是并不能保证这个步骤最先执行，在所有 Bean 的销毁之前。同时，虽然当前服务实例已经从注册中心取消注册，但是服务消费者从注册中心中拉取到最新的注册信息，是存在延迟的，只是长短的差别。

解决

通过actuator/service-registry/ 接口完成接口下线
sleep 30秒之后再进行微服务jar包的启停
进行健康检查

下线请求效果如图

在这里插入图片描述

贴一个可用的部署脚本

#!/bin/bash
set -e# 基础
# export JAVA_HOME=/work/programs/jdk/jdk1.8.0_181
# export PATH=PATH=$PATH:$JAVA_HOME/bin
# export CLASSPATH=$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jarDATE=$(date +%Y%m%d%H%M)
# 基础路径
BASE_PATH=/home/vagrant/data/workProjects/JenkinsSpringCloudDemo
# 编译后 jar 的地址。部署时，Jenkins 会上传 jar 包到该目录下
SOURCE_PATH=$BASE_PATH/build
# 服务名称。同时约定部署服务的 jar 包名字也为它。
SERVER_NAME=JenkinsSpringCloudDemo
# 环境
PROFILES_ACTIVE=prod
# 健康检查 URL
HEALTH_CHECK_URL=http://127.0.0.1:8078/actuator/health/
# 修改状态 URL
STATUS_URL=http://127.0.0.1:8078/actuator/service-registry/# heapError 存放路径
HEAP_ERROR_PATH=$BASE_PATH/heapError
# JVM 参数
JAVA_OPS="-Xms1024m -Xmx1024m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=$HEAP_ERROR_PATH"
# JavaAgent 参数。可用于配置 SkyWalking 等链路追踪
JAVA_AGENT=# 备份
function backup() {# 如果不存在，则无需备份if [ ! -f "$BASE_PATH/$SERVER_NAME.jar" ]; thenecho "[backup] $BASE_PATH/$SERVER_NAME.jar 不存在，跳过备份"# 如果存在，则备份到 backup 目录下，使用时间作为后缀elseecho "[backup] 开始备份 $SERVER_NAME ..."cp $BASE_PATH/$SERVER_NAME.jar $BASE_PATH/backup/$SERVER_NAME-$DATE.jarecho "[backup] 备份 $SERVER_NAME 完成"fi
}# 最新构建代码 移动到项目环境
function transfer() {echo "[transfer] 开始转移 $SERVER_NAME.jar"# 删除原 jar 包if [ ! -f "$BASE_PATH/$SERVER_NAME.jar" ]; thenecho "[transfer] $BASE_PATH/$SERVER_NAME.jar 不存在，跳过删除"elseecho "[transfer] 移除 $BASE_PATH/$SERVER_NAME.jar 完成"rm $BASE_PATH/$SERVER_NAME.jarfi# 复制新 jar 包echo "[transfer] 从 $SOURCE_PATH 中获取 $SERVER_NAME.jar 并迁移至 $BASE_PATH ...."cp $SOURCE_PATH/$SERVER_NAME.jar $BASE_PATHecho "[transfer] 转移 $SERVER_NAME.jar 完成"
}# 停止
function stop() {echo "[stop] 开始停止 $BASE_PATH/$SERVER_NAME"PID=$(ps -ef | grep $BASE_PATH/$SERVER_NAME | grep -v "grep" | awk '{print $2}')# 如果 Java 服务启动中，则进行关闭if [ -n "$PID" ]; then# 从注册中心下线echo "[stop] 从注册中心下线当前实例，并 sleep 20 秒"curl -X POST $STATUS_URL -d '{"status": "DOWN"}' -H 'content-type: application/json'sleep 20# 正常关闭echo "[stop] $BASE_PATH/$SERVER_NAME 运行中，开始 kill [$PID]"kill -15 $PID# 等待最大 60 秒，直到关闭完成。for ((i = 0; i < 60; i++))dosleep 1PID=$(ps -ef | grep $BASE_PATH/$SERVER_NAME | grep -v "grep" | awk '{print $2}')if [ -n "$PID" ]; thenecho -e ".\c"elseecho '[stop] 停止 $BASE_PATH/$SERVER_NAME 成功'breakfidone# 如果正常关闭失败，那么进行强制 kill -9 进行关闭if [ -n "$PID" ]; thenecho "[stop] $BASE_PATH/$SERVER_NAME 失败，强制 kill -9 $PID"kill -9 $PIDfi# 如果 Java 服务未启动，则无需关闭elseecho "[stop] $BASE_PATH/$SERVER_NAME 未启动，无需停止"fi
}# 启动
function start() {# 开启启动前，打印启动参数echo "[start] 开始启动 $BASE_PATH/$SERVER_NAME"echo "[start] JAVA_OPS: $JAVA_OPS"echo "[start] JAVA_AGENT: $JAVA_AGENT"echo "[start] PROFILES: $PROFILES_ACTIVE"# 开始启动BUILD_ID=dontKillMe nohup java -server $JAVA_OPS $JAVA_AGENT -jar $BASE_PATH/$SERVER_NAME.jar --spring.profiles.active=$PROFILES_ACTIVE &echo "[start] 启动 $BASE_PATH/$SERVER_NAME 完成"
}# 健康检查
function healthCheck() {# 如果配置健康检查，则进行健康检查if [ -n "$HEALTH_CHECK_URL" ]; then# 健康检查最大 60 秒，直到健康检查通过echo "[healthCheck] 开始通过 $HEALTH_CHECK_URL 地址，进行健康检查";for ((i = 0; i < 60; i++))do# 请求健康检查地址，只获取状态码。result=`curl -I -m 10 -o /dev/null -s -w %{http_code} $HEALTH_CHECK_URL || echo "000"`# 如果状态码为 200，则说明健康检查通过if [ "$result" == "200" ]; thenecho "[healthCheck] 健康检查通过";break# 如果状态码非 200，则说明未通过。sleep 1 秒后，继续重试elseecho -e ".\c"sleep 1fidone# 健康检查未通过，则异常退出 shell 脚本，不继续部署。if [ ! "$result" == "200" ]; thenecho "[healthCheck] 健康检查不通过，可能部署失败。查看日志，自行判断是否启动成功";tail -n 10 nohup.outexit 1;# 健康检查通过，打印最后 10 行日志，可能部署的人想看下日志。elsetail -n 10 nohup.outfi# 如果未配置健康检查，则 slepp 60 秒，人工看日志是否部署成功。elseecho "[healthCheck] HEALTH_CHECK_URL 未配置，开始 sleep 60 秒";sleep 60echo "[healthCheck] sleep 60 秒完成，查看日志，自行判断是否启动成功";tail -n 50 nohup.outfi
}# 部署
function deploy() {cd $BASE_PATH# 备份原 jarbackup# 停止 Java 服务stop# 部署新 jartransfer# 启动 Java 服务start# 健康检查healthCheck
}deploy