Java 部署脚本，支持回滚

Java 部署脚本
Java Sprintboot jar 项目启动、停止脚本：https://www.cnblogs.com/vipsoft/p/15952112.html
SpringBoot 不同的环境，打不同的包名： https://www.cnblogs.com/vipsoft/p/18577679
deploy.sh

1. #!/bin/bash
4. # 应用配置
5. RUN_JAR_NAME="vipsoft-gateway-1.0.1.jar"
6. NEW_JAR_NAME="vipsoft-gateway-1.0.2.jar"
7. BACK_JAR_NAME="vipsoft-gateway-1.0.1.jar1229"
10. # 使用说明
11. usage() {
12.     echo "使用说明:"
13.     echo "  ./deploy.sh deploy <新jar包>      # 部署新版本，默认使用文件里写好的"
14.     echo "  ./deploy.sh rollback <版本号>     # 回滚到指定版本（格式: 20241229_1430），默认使用文件里写好的"
15.     echo "  ./deploy.sh stop                  # 停止应用"
16.     echo "  ./deploy.sh start                 # 启动应用"
17.     echo "  ./deploy.sh restart               # 重启应用"
18.     echo "  ./deploy.sh status                # 查看状态"
19.     echo "  ./deploy.sh logs [行数]           # 查看日志（默认50行），默认为 tail -f"
20.     echo "  ./deploy.sh backup                # 备份当前版本"
21.     echo ""
22.     echo "示例:"
23.     echo "  ./deploy.sh deploy app-1.27.1.jar1229"
24.     echo "  ./deploy.sh rollback vipsoft-gateway-1.0.1.jar1229"
25. }
28. JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC -Dlogging.config=./logback.xml"
29. SPRING_OPTS="--spring.profiles.active=test"
30. LOG_DIR="./logs"
31. PID_FILE="./app.pid"
32. TIMESTAMP=$(date +%Y%m%d_%H%M%S)
34. # 创建日志目录
35. mkdir -p $LOG_DIR
37. # 颜色输出
38. RED='\033[0;31m'
39. GREEN='\033[0;32m'
40. YELLOW='\033[1;33m'
41. NC='\033[0m' # No Color
43. # 打印带颜色的消息
44. print_info() {
45.     echo -e "${GREEN}[INFO]${NC} $1"
46. }
48. print_warn() {
49.     echo -e "${YELLOW}[WARN]${NC} $1"
50. }
52. print_error() {
53.     echo -e "${RED}[ERROR]${NC} $1"
54. }
57. # 部署新版本
58. deploy_jar() {
59.     local new_jar="$1"
60.     if [ ! -z "$1" ]; then
61.         NEW_JAR_NAME=$new_jar
62.     fi
64.     # 检查文件是否以 .jar 结尾
65.     if [[ ! "$NEW_JAR_NAME" =~ \.jar$ ]]; then
66.         print_error "文件名必须以 .jar 结尾: ${NEW_JAR_NAME}"
67.         exit 1
68.     fi
70.     if [ ! -f "$NEW_JAR_NAME" ]; then
71.         print_error "部署版本不存在: ${NEW_JAR_NAME}"
72.         exit 1
73.     fi
74.     print_info "部署: ${NEW_JAR_NAME}"
76.     # 停止应用
77.     stop
78.    
79.     # 替换jar包
80.     if [ -f "$RUN_JAR_NAME" ]; then
81.         #mv "$RUN_JAR_NAME" "${RUN_JAR_NAME}.${TIMESTAMP}"
82.         mv "$RUN_JAR_NAME" "${BACK_JAR_NAME}"        
83.         print_info "备份: ${RUN_JAR_NAME} => ${BACK_JAR_NAME}"
84.     fi
85.    
86.     #mv "$new_jar" "$RUN_JAR_NAME"
88.     RUN_JAR_NAME=$NEW_JAR_NAME
90.     # 启动应用
91.     start
92. }
95. # 回滚到指定版本
96. rollback_version() {
97.     local backup_jar="$1"
98.     if [ ! -z "$1" ]; then
99.         BACK_JAR_NAME=$backup_jar
100.     fi
101.     if [ ! -f "$BACK_JAR_NAME" ]; then
102.         print_error "备份版本不存在: ${BACK_JAR_NAME}"
103.         echo "可用的备份版本:"
104.         ls -l ${NEW_JAR_NAME}.* 2>/dev/null || echo "暂无备份"
105.         exit 1
106.     fi
108.     # 停止应用
109.     stop
110.      
111.     if [ -f "$RUN_JAR_NAME" ]; then
112.         #mv "$RUN_JAR_NAME" "${RUN_JAR_NAME}.${TIMESTAMP}"
113.         mv "$RUN_JAR_NAME" "${BACK_JAR_NAME}"        
114.         print_info "备份: ${RUN_JAR_NAME}"
115.     fi
117.     mv "$BACK_JAR_NAME" "$RUN_JAR_NAME"
119.     print_info "回滚到版本: ${BACK_JAR_NAME}"
120.     #deploy_jar "$backup_jar"
122.     #RUN_JAR_NAME=$NEW_JAR_NAME
124.     # 启动应用
125.     start
126. }
128. # 备份当前jar包
129. backup_current_jar() {
130.     if [ -f "$JAR_NAME" ]; then
131.         # 创建备份目录
132.         mkdir -p $BACKUP_DIR
133.         
134.         local backup_name="${JAR_NAME}.${TIMESTAMP}"
135.         print_info "备份当前版本: $backup_name"
136.         cp "$JAR_NAME" "$BACKUP_DIR/$backup_name"
137.         
138.         # 清理旧备份，保留最近5个
139.         (cd $BACKUP_DIR && ls -t ${JAR_NAME}.* 2>/dev/null | tail -n +6 | xargs rm -f 2>/dev/null || true)
140.     else
141.         print_warn "当前jar包不存在，无需备份"
142.     fi
143. }
145. start() {
146.     # 1. 创建日志目录
147.     print_info "检查日志目录: ${LOG_DIR}"
148.     if [ ! -d "$LOG_DIR" ]; then
149.         print_info "创建目录: ${LOG_DIR}"
150.         mkdir -p "$LOG_DIR"
151.         
152.         if [ $? -ne 0 ]; then
153.             print_error "创建目录失败: ${LOG_DIR}"
154.             print_error "请检查权限: sudo mkdir -p ${LOG_DIR}"
155.             print_error "或者修改 LOG_DIR 配置"
156.             exit 1
157.         fi
158.         print_info "目录创建成功"
159.     else
160.         print_info "目录已存在"
161.     fi
162.    
163.     # 2. 检查目录权限
164.     if [ ! -w "$LOG_DIR" ]; then
165.         print_error "目录不可写: ${LOG_DIR}"
166.         print_error "请设置权限: sudo chmod 755 ${LOG_DIR}"
167.         print_error "或者设置所有者: sudo chown \$USER ${LOG_DIR}"
168.         exit 1
169.     fi
170.        
171.     if [ -f $PID_FILE ] && kill -0 $(cat $PID_FILE) 2>/dev/null; then
172.         echo "${RUN_JAR_NAME} 应用已经在运行，PID: $(cat $PID_FILE)"
173.         exit 1
174.     fi
175.    
176.     echo "正在启动应用 ${RUN_JAR_NAME}..."
177.     nohup java $JAVA_OPTS -jar $RUN_JAR_NAME $SPRING_OPTS > $LOG_DIR/app.out 2>&1 &
178.     echo $! > $PID_FILE
179.     echo "应用启动成功 ${RUN_JAR_NAME}，PID: $(cat $PID_FILE)"
180.     show_logs
181. }
183. stop() {
184.     if [ ! -f $PID_FILE ]; then
185.         echo "PID文件不存在，应用可能未运行"
186.         return 1
187.     fi
188.    
189.     PID=$(cat $PID_FILE)
190.     echo "正在停止应用 ${RUN_JAR_NAME}，PID: ${PID}"
191.    
192.     # 优雅停止
193.     kill $PID 2>/dev/null
194.    
195.     # 等待最多30秒
196.     for i in {1..30}; do
197.         if kill -0 $PID 2>/dev/null; then
198.             sleep 1
199.         else
200.             echo "应用已停止 ${RUN_JAR_NAME}"
201.             rm -f $PID_FILE
202.             return 0
203.         fi
204.     done
205.    
206.     # 强制停止
207.     echo "强制停止应用 ${RUN_JAR_NAME}..."
208.     kill -9 $PID 2>/dev/null
209.     rm -f $PID_FILE
210.     echo "应用已强制停止 ${RUN_JAR_NAME}"
211. }
213. restart() {
214.     stop
215.     sleep 2
216.     start
217. }
219. status() {
220.     if [ -f $PID_FILE ] && kill -0 $(cat $PID_FILE) 2>/dev/null; then
221.         echo "应用正在运行，PID: $(cat $PID_FILE)"
222.         ps -p $(cat $PID_FILE) -o pid,cmd,lstart
223.     else
224.         echo "应用未运行"
225.     fi
226. }
228. # 查看日志
229. show_logs() {
230.     local logFile=$LOG_DIR/debug.log
231.     if [ -z "$1" ]; then
232.         tail -f $logFile
233.     elif [ -f "$logFile" ]; then
234.         local lines=${1:-50}
235.         tail -n $lines $logFile
236.     else
237.         print_warn "日志文件不存在：${logFile}"
238.     fi
239. }
241. # 主函数
242. main() {
243.     case "$1" in
244.         deploy)
245.             # if [ -z "$2" ]; then
246.             #     print_error "请指定要部署的jar包"
247.             #     usage
248.             #     exit 1
249.             # fi
250.             deploy_jar "$2"
251.             ;;
252.         rollback)
253.             # if [ -z "$2" ]; then
254.             #     print_error "请指定要回滚的版本号"
255.             #     usage
256.             #     exit 1
257.             # fi
258.             rollback_version "$2"
259.             ;;
260.         start)
261.             start
262.             ;;
263.         stop)
264.             stop
265.             ;;
266.         restart)
267.             restart
268.             ;;
269.         status)
270.             status
271.             ;;
273.         logs)
274.             show_logs "$2"
275.             ;;
276.         *)
277.             echo "使用说明: $0 {start|stop|restart|status}"
278.             exit 1
279.             ;;
280.     esac
281. }   
283. # 脚本入口
284. if [ $# -eq 0 ]; then
285.     usage
286.     exit 1
287. fi
289. main "$@"

复制代码

说明

1. if [[ ! "$NEW_JAR_NAME" =~ \.jar$ ]]; then
2.     print_error "文件名必须以 .jar 结尾: ${NEW_JAR_NAME}"
3.     exit 1
4. fi
5. # =~ 是bash的正则匹配操作符
6. # \.jar 中的 \. 表示匹配实际的点号（正则中点是特殊字符）
7. # $ 表示字符串结尾
8. # 双中括号 [[ ]] 支持正则匹配，单中括号 [ ] 不支持

复制代码

为什么有时候 $后面加 {} 有时候不加
这是Shell中变量引用的不同方式，主要区别在于明确变量边界和使用数组
1. 基本规则：什么时候需要 {}

需要 {} 的情况：

1. # 1. 变量名后面紧跟其他字符（没有空格分隔）
2. name="world"
3. echo "Hello, ${name}!"      # ✅ 正确: Hello, world!
4. echo "Hello, $name!"        # ⚠️ 有风险: 会被解释为 $name! 变量
6. # 2. 数组元素访问
7. files=("a.txt" "b.txt")
8. echo "${files[0]}"          # ✅ 正确: a.txt
9. echo "$files[0]"            # ❌ 错误: 只会输出 a.txt[0]
11. # 3. 特殊参数扩展
12. echo "${#name}"             # ✅ 输出字符串长度: 5
13. echo "$#name"               # ❌ 错误: 输出参数个数+name
15. # 4. 变量默认值
16. echo "${JAR_NAME:-default.jar}"  # ✅ 如果JAR_NAME为空，使用默认值

复制代码

不需要 {} 的情况：

1. # 1. 变量名后面是空格或换行
2. name="world"
3. echo "Hello, $name"         # ✅ 正确: Hello, world
5. # 2. 变量名后面是特殊字符（会被shell识别为终止）
6. echo "Value: $name."        # ✅ 正确: Value: world.
7. echo "File: $name.txt"      # ✅ 正确（但如果有变量$nametxt会出错）
9. # 3. 简单变量引用
10. JAR_NAME="app.jar"
11. echo "检测到的Jar包: $JAR_NAME"  # ✅ 正确

复制代码

2. 数组的特殊性

这是你问题中的关键区别：

1. # 数组变量必须使用 ${}
2. missing=("java" "git" "mvn")
4. # ✅ 正确：使用 ${missing[*]} 或 ${missing[@]}
5. echo "缺少命令: ${missing[*]}"      # 输出: 缺少命令: java git mvn
6. echo "缺少命令: ${missing[@]}"      # 同上（但在循环中有区别）
8. # ❌ 错误：不加 {} 会被当成普通变量
9. echo "缺少命令: $missing[*]"        # 输出: 缺少命令: java[*]
10. echo "缺少命令: $missing[@]"        # 输出: 缺少命令: java[@]

复制代码

3. 具体对比分析

你的例子1：数组必须用 ${}

1. missing=("java" "git")
3. # 正确示例
4. echo "缺少命令: ${missing[*]}"  # ✅ 输出: 缺少命令: java git
5. echo "缺少命令: ${missing[@]}"  # ✅ 输出: 缺少命令: java git
7. # 错误示例
8. echo "缺少命令: $missing[*]"    # ❌ 输出: 缺少命令: java[*]
9. echo "缺少命令: $missing"       # ❌ 输出: 缺少命令: java（只显示第一个元素）

复制代码

你的例子2：普通变量可以不用 {}

1. JAR_NAME="app-1.27.jar"
3. # 都可以，但第一种更安全
4. echo "检测到的Jar包: ${JAR_NAME}"  # ✅ 推荐
5. echo "检测到的Jar包: $JAR_NAME"    # ✅ 可接受

复制代码

4. 完整示例展示区别

1. #!/bin/bash
3. # 场景1：普通变量
4. APP_NAME="myapp"
5. VERSION="1.27"
7. # 正确但可能有问题
8. echo "应用: $APP_NAME$VERSION"      # ✅ 输出: myapp1.27
9. echo "应用: ${APP_NAME}${VERSION}"  # ✅ 输出: myapp1.27（更明确）
11. # 有问题的情况
12. echo "应用: $APP_NAME_$VERSION"    # ❌ 尝试访问 $APP_NAME_ 变量
13. echo "应用: ${APP_NAME}_$VERSION"  # ✅ 正确: myapp_1.27
15. # 场景2：数组变量
16. commands=("start" "stop" "restart")
18. echo "命令: ${commands[*]}"         # ✅ 正确: start stop restart
19. echo "命令: $commands[*]"           # ❌ 错误: start[*]
20. echo "命令: $commands"              # ❌ 错误: start（只取第一个）
22. # 场景3：带特殊字符
23. file="data"
24. echo "文件: $file.txt"              # ⚠️ 可能出错：如果存在 $filetxt 变量
25. echo "文件: ${file}.txt"            # ✅ 安全: data.txt

复制代码

5. 最佳实践建议

总是使用 {}（推荐）

1. # 始终使用 ${}，这样最安全
2. echo "${variable}"
3. echo "${array[@]}"
4. echo "${JAR_NAME}"

复制代码

安全引用表格

场景推荐写法风险写法说明普通变量${VAR} | $VAR加{}总是安全的变量拼接${VAR}text | $VARtext避免歧义数组所有元素${ARRAY[@]} | $ARRAY普通引用只取第一个数组特定元素${ARRAY[0]} | $ARRAY[0]必须加{}带特殊字符${VAR}_suffix | $VAR_suffix避免错误解析6. 高级用法：变量扩展

{} 还能实现强大的变量扩展功能：

1. # 1. 默认值
2. echo "${NAME:-无名氏}"      # 如果NAME为空，显示"无名氏"
3. echo "$NAME"                # 如果NAME为空，显示空
5. # 2. 变量长度
6. name="hello"
7. echo "长度: ${#name}"       # 输出: 5
8. echo "长度: $#name"         # 错误: 输出参数个数
10. # 3. 字符串切片
11. str="abcdefg"
12. echo "${str:0:3}"          # 输出: abc（从0开始取3个）
13. echo "${str: -3}"          # 输出: efg（最后3个）
15. # 4. 模式替换
16. path="/home/user/file.txt"
17. echo "${path/file/doc}"    # 输出: /home/user/doc.txt
18. echo "${path//\// }"       # 输出:  home user file.txt（替换所有/）

复制代码

7. 你的具体问题解答

1. # 你的代码中：
2. echo "缺少命令: ${missing[*]}"  # ✅ 必须加{}，因为missing是数组
3. echo "检测到的Jar包: $JAR_NAME"  # ✅ 可以不加，但加了更安全
5. # 更好的写法（总是加{}）：
6. echo "缺少命令: ${missing[*]}"     # 明确表示是数组
7. echo "检测到的Jar包: ${JAR_NAME}"   # 安全，避免后续修改带来的问题

复制代码

总结

• 数组变量必须用 ${}：${array[@]} 或 ${array
  
• }
  
• 普通变量建议用 ${}：更安全，更明确
  
• 变量名边界模糊时用 ${}：${var}_suffix
  
• 使用高级功能时用 ${}：默认值、字符串操作等
  

黄金规则：当有疑问时，总是使用 ${}，这样永远不会出错。多两个字符能避免很多难以调试的问题。
在Shell脚本中，return 1 和 exit 1 有重要的区别：
核心区别

特性return 1exit 1作用范围函数内部整个脚本执行后返回调用处继续执行立即终止脚本可捕获会被函数调用者接收整个进程退出退出状态设置 $? 为1脚本以状态码1退出详细解释

1. return 1 - 函数返回值

1. #!/bin/bash
3. test_return() {
4.     echo "函数开始"
5.     if [ $1 -eq 0 ]; then
6.         return 0  # 成功
7.     else
8.         return 1  # 失败
9.     fi
10. }
12. test_return 0
13. echo "返回值: $?"  # 输出: 0
15. test_return 1
16. echo "返回值: $?"  # 输出: 1
17. echo "脚本继续执行..."  # 这行会执行

复制代码

2. exit 1 - 退出脚本

1. #!/bin/bash
3. test_exit() {
4.     echo "函数开始"
5.     if [ $1 -eq 0 ]; then
6.         return 0
7.     else
8.         echo "发生错误，退出脚本"
9.         exit 1  # 整个脚本立即终止！
10.     fi
11. }
13. test_exit 0
14. echo "这行会执行"  # 会执行
16. test_exit 1
17. echo "这行永远不会执行"  # 不会执行

复制代码

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

yyds。多谢分享