SpringBoot项目部署之启动脚本

一、启动脚本方案

1. 基础启动方式

1.1 直接运行JAR

java -jar your-app.jar --spring.profiles.active=prod
  • 优点:简单直接,适合快速测试
  • 缺点:终端关闭即终止进程

1.2 后台运行

nohup java -jar your-app.jar > app.log 2>&1 &
  • 参数说明
    • nohup:忽略挂断信号,后台运行
    • > app.log:标准输出重定向
    • 2>&1:错误输出重定向
    • &:后台运行

2. Shell脚本封装

注:chmod 777 start.sh

start.sh

#!/bin/bash

# 使用参数传入 JAR 文件名和应用名称
JAR_NAME=wkl-business.jar
APP_NAME=wkl-business

# 启动命令(保留原逻辑)
nohup java -jar -Dfile.encoding=UTF-8 $JAR_NAME $APP_NAME &
echo "Started $APP_NAME with command: java -jar $JAR_NAME $APP_NAME"


二、关闭脚本方案

1. 基础关闭方式

# 通过进程ID关闭
kill $(lsof -t -i:8080)

# 强制终止
kill -9 <PID>

2. Shell脚本封装

注:chmod 777 stop.sh

stop.sh

#!/bin/bash

# 使用参数传入应用名称
APP_NAME=wkl-business

# 原停止逻辑(仅提取 PID 方式)
pid=$(ps ax | grep -i "$APP_NAME" | grep java | grep -v grep | awk '{print $1}')
if [ -z "$pid" ]; then
  echo "No $APP_NAME running."
  exit -1
fi

echo "The $APP_NAME ($pid) is running..."
kill $pid
echo "Send shutdown request to $APP_NAME ($pid) OK"

三、完整示例脚本1

  • jar包同级目录下创建logs文件夹
  • 注:记得给脚本增加权限:chmod 777 start.sh、chmod 777 stop.sh
  • 脚本如下:

start.sh

#!/bin/bash
BASEPATH=$(cd "$(dirname "$0")"; pwd)
APP_NAME="demo.jar"
JAR_PATH=$BASEPATH/$APP_NAME
LOG_DIR=$BASEPATH/logs/${APP_NAME%.*}/nohup.out  # 日志路径示例
PID_FILE=$BASEPATH/$APP_NAME.pid
JAVA_OPTS="-Xms1g -Xmx2g -Dspring.profiles.active=prod"

# 创建日志目录
mkdir -p $(dirname $LOG_DIR)

# 检查运行状态
if [ -f "$PID_FILE" ]; then
  PID=$(cat "$PID_FILE")
  if ps -p $PID > /dev/null 2>&1; then
    echo "Application is already running with PID: $PID. Exiting..."
    exit 1
  else
    echo "PID file exists but process not found. Cleaning up..."
    rm -f "$PID_FILE"
  fi
fi

# 启动应用
nohup java $JAVA_OPTS -jar "$JAR_PATH" >> "$LOG_DIR" 2>&1 &

# 记录进程ID
echo $! > "$PID_FILE"
echo "Application started with PID: $(cat "$PID_FILE")"

# 查看日志
tail -100f "$LOG_DIR"

stop.sh

#!/bin/bash
BASEPATH=$(cd "$(dirname "$0")"; pwd)
APP_NAME="demo.jar"
PID_FILE="$BASEPATH/$APP_NAME.pid"

if [ -f "$PID_FILE" ]; then
  PID=$(cat "$PID_FILE")
  
  # 验证进程是否存在且为 Java 进程
  if ps -p "$PID" > /dev/null 2>&1 && [[ "$(ps -p "$PID" -o comm=)" == *"java"* ]]; then
    echo "Stopping application with PID: $PID..."
    kill -15 "$PID"
    
    # 等待进程终止(最多30秒)
    for i in {1..30}; do
      if ! ps -p "$PID" > /dev/null 2>&1; then
        break
      fi
      sleep 1
    done
    
    # 强制终止(如果仍存在)
    if ps -p "$PID" > /dev/null 2>&1; then
      echo "Force killing PID: $PID..."
      kill -9 "$PID"
      sleep 1
    fi
  else
    echo "PID $PID is invalid. Cleaning up..."
  fi
  
  # 清理 PID 文件
  rm -f "$PID_FILE"
else
  echo "PID file not found. Application is not running."
fi

echo "Application stopped"

四、完整示例脚本2

  • jar包同级目录下创建logs文件夹
  • jar包同级目录下创建config文件夹,包含application.yml 和logback.xml (非必须)文件,给777权限
  • 脚本如下:
# 该脚本为Linux下启动java程序的脚本
# 特别注意:
# 该脚本使用系统kill命令来强制终止指定的java程序进程。
# 所以在杀死进程前,可能会造成数据丢失或数据不完整。如果必须要考虑到这类情况,则需要改写此脚本,
# 
# 根据实际情况来修改以下配置信息 ##################################

# JAVA应用程序的名称
APP_NAME=xxxx系统
#获取脚本所在目录的绝对路径。
BASEPATH=$(cd "$(dirname "$0")"; pwd)
# jar包名称-记得更改
JAR_NAME=demo.jar
# PID 代表是PID文件(改进:使用绝对路径避免目录混乱)
JAR_PID="$BASEPATH/$JAR_NAME.pid"
# java虚拟机启动参数
JAVA_OPTS="-Xms512m -Xmx2048m -XX:MetaspaceSize=512m -XX:MaxMetaspaceSize=512m -XX:ParallelGCThreads=16 -XX:+PrintGCDateStamps -XX:+PrintGCDetails -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=utf-8"
LOG_DIR="$BASEPATH/logs"

# 根据实际情况来修改以上配置信息 ##################################

# ######### Shell脚本中$0、$?、$!、$$、$*、$#、$@等的说明 #########
# $$ Shell本身的PID(ProcessID,即脚本运行的当前 进程ID号)
# $! Shell最后运行的后台Process的PID(后台运行的最后一个进程的 进程ID号)
# $? 最后运行的命令的结束代码(返回值)即执行上一个指令的返回值 (显示最后命令的退出状态。0表示没有错误,其他任何值表明有错误)
# $- 显示shell使用的当前选项,与set命令功能相同
# $* 所有参数列表。如"$*"用「"」括起来的情况、以"$1 $2 … $n"的形式输出所有参数,此选项参数可超过9个。
# $@ 所有参数列表。如"$@"用「"」括起来的情况、以"$1" "$2" … "$n" 的形式输出所有参数。
# $# 添加到Shell的参数个数
# $0 Shell本身的文件名
# $1~$n 添加到Shell的各参数值。$1是第1参数、$2是第2参数…。
# ######### 说明结束 #########

# 检查程序是否处于运行状态(改进:使用pgrep精确匹配进程)
is_exist() {
  # 改进:使用pgrep替代ps/grep组合,避免误判
  pid=$(pgrep -f "$JAR_NAME" | grep -v "$$")  # 排除当前脚本进程
  if [ -n "$pid" ]; then
    return 0  # 存在返回0(符合Shell习惯)
  else
    return 1  # 不存在返回1
  fi
}

# 服务启动方法
start() {
  is_exist
  if [ $? -eq 0 ]; then
    echo "$APP_NAME is already running (PID: $(cat "$JAR_PID"))"
    return 1
  fi

  # 创建日志目录(原脚本未处理)
  

  # jar服务启动脚本(改进:验证启动是否成功)
  nohup java $JAVA_OPTS -jar -Dlogging.config=./config/logback.xml "$BASEPATH/$JAR_NAME" >> "$LOG_DIR/nohup.out" 2>&1 &
  pid=$!
  
  # 验证进程是否存活再记录PID
  if ps -p $pid > /dev/null 2>&1; then
    echo "$pid" > "$JAR_PID"
    echo "Start success, PID: $pid"
    tail -100f "$LOG_DIR/nohup.out"
  else
    echo "Failed to start $APP_NAME"
    exit 1
  fi
}

# 服务停止方法(改进:优雅终止+超时处理)
stop() {
  if [ ! -f "$JAR_PID" ]; then
    echo "PID file not found. Application is not running."
    return 1
  fi

  pid=$(cat "$JAR_PID")
  # 验证PID有效性
  if ! ps -p $pid > /dev/null 2>&1; then
    echo "Process $pid does not exist. Cleaning up."
    rm -f "$JAR_PID"
    return 1
  fi

  # 优雅终止(SIGTERM)
  echo "Stopping $APP_NAME (PID: $pid)..."
  kill $pid

  # 等待最多30秒
  for i in {1..30}; do
    if ! ps -p $pid > /dev/null 2>&1; then
      rm -f "$JAR_PID"
      echo "Stopped gracefully."
      return 0
    fi
    sleep 1
  done

  # 超时后强制终止(SIGKILL)
  echo "Force-stopping $APP_NAME..."
  kill -9 $pid
  sleep 1
  if ps -p $pid > /dev/null 2>&1; then
    echo "Failed to stop $APP_NAME."
    return 1
  else
    rm -f "$JAR_PID"
    echo "Force-stopped."
    return 0
  fi
}

# 服务运行状态查看方法
status() {
  is_exist
  if [ $? -eq 0 ]; then
    echo "$APP_NAME is running (PID: $(cat "$JAR_PID"))"
  else
    echo "$APP_NAME is not running"
  fi
}

# 重启服务方法
restart() {
  stop && start
}

# 帮助说明,用于提示输入参数信息
usage() {
    echo "Usage: sh $0 {start|stop|restart|status}"
    exit 1
}

###################################
# 读取脚本的第一个参数($1),进行判断
# 参数取值范围:{ start | stop | restart | status }
# 如参数不在指定范围之内,则打印帮助信息
###################################
case "$1" in
  start)
    start
    ;;
  stop)
    stop
    ;;
  restart)
    restart
    ;;
  status)
    status
    ;;
  *)
    usage
    ;;
esac
exit 0


五、注意事项

  1. 端口冲突处理

    # 检查端口占用
    lsof -i :8080
    
  2. 内存配置优化

    • 根据服务器配置调整-Xms-Xmx
    • 启用G1垃圾回收器:-XX:+UseG1GC
  3. 服务监控

    • 集成Prometheus监控
    • 配置邮件/SMS告警
  4. 滚动更新策略

    • 使用蓝绿部署
    • 配置Kubernetes滚动更新策略
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

苍煜

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值