Linux中使用shell腳本管理Java應用程序

更新時間：2024年06月15日 11:18:37 作者：BigDataMagician

在日常開發(fā)和運維工作中,管理基于Java的應用程序是一項基礎且頻繁的任務,本文將通過一個示例腳本,展示如何利用Shell腳本簡化這一流程,實現Java應用的一鍵式啟動、停止與重啟操作,本腳本不僅提升了工作效率,還確保了操作的標準化與可靠性

在日常開發(fā)和運維工作中，管理基于Java的應用程序是一項基礎且頻繁的任務。本文將通過一個示例腳本，展示如何利用Shell腳本簡化這一流程，實現Java應用的一鍵式啟動、停止與重啟操作。本腳本不僅提升了工作效率，還確保了操作的標準化與可靠性。

前言

Shell 是一個用 C 語言編寫的程序，它是用戶使用 Linux 的橋梁。Shell 既是一種命令語言，又是一種程序設計語言。Shell 是指一種應用程序，這個應用程序提供了一個界面，用戶通過這個界面訪問操作系統(tǒng)內核的服務。Ken Thompson 的 sh 是第一種 Unix Shell，Windows Explorer 是一個典型的圖形界面 Shell。

一、目錄結構

這是一個典型的Java項目部署結構，其中user_defined目錄用于存放管理應用的各種腳本，其下細分有多個子目錄以組織不同的資源。

.
├─user_defined     # 使用者自定義目錄名      
│  ├─bin           # 腳本存放目錄
│  ├─conf          # 配置文件目錄
│  ├─lib           # 應用依賴的jar包存放目錄
│  ├─log           # 應用日志輸出目錄
│  ├─pid           # 存放進程ID文件的目錄
│  └─sql           # SQL腳本或數據相關文件

二、腳本實現

1. 腳本內容

#!/bin/bash

# 檢查腳本是否被傳遞了有效的命令
if [ -z "$1" ]; then
  echo "Usage: $0 {start|stop|restart}"
  exit 1
fi

# jar包名稱，不帶.jar后綴
JAR_NAME='example'
# 獲取當前腳本所在的目錄
SCRIPT_BIN="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# jar包主目錄
JARPACKAGE_HOME="$SCRIPT_BIN/.."

# 設置jar包的路徑
JAR_PATH="$JARPACKAGE_HOME/lib/$JAR_NAME.jar"

# 檢查當前目錄下是否存此jar文件
if [ ! -f "$JAR_PATH" ]; then
  echo "Error: $JAR_NAME.jar not found."
  exit 1
fi

# 定義運行的Java命令
JAVA_CMD="java -jar $JAR_PATH"

# 創(chuàng)建pid目錄，如果不存在
PID_DIR="$JARPACKAGE_HOME/pid"
mkdir -p "$PID_DIR"

# 啟動jar包
start() {
  echo "Starting jar package..."
  # nohup $JAVA_CMD > /dev/null 2>&1 &
  # 使用nohup在后臺運行jar包，并將日志輸出到文件
  nohup $JAVA_CMD > $JARPACKAGE_HOME/log/${JAR_NAME}.log 2>&1 &
  echo $! > "$PID_DIR/$JAR_NAME.pid"
  echo "Jar package is started. pid is saved in $PID_DIR/$JAR_NAME.pid"
}

# 停止jar包
stop() {
  echo "Stopping jar package..."
  PID=$(cat "$PID_DIR/$JAR_NAME.pid")
  if [ -n "$PID" ]; then
    kill $PID
    echo "Jar package has been stopped"
    yes | rm "$PID_DIR/$JAR_NAME.pid"
  else
    echo "Error: Jar package is not running."
  fi
}

# 重啟jar package
restart() {
  echo "Restarting jar package..."
  stop
  sleep 3
  start
}

# 根據傳入的參數調用相應的方法
case "$1" in
  start)
    start
    ;;
  stop)
    stop
    ;;
  restart)
    restart
    ;;
  *)
    echo "Error: Invalid command. Use {start|stop|restart}."
    exit 1
    ;;
esac

exit 0

2. 使用說明

2.1 配置腳本

修改腳本以適配你的應用：打開提供的Shell腳本模板，找到JAR_NAME變量，將其值更改為你的Java應用程序jar包名稱（不包含.jar后綴）。如果Java應用運行時需要額外參數，可以在JAVA_CMD變量中追加這些參數。

2.2 腳本部署

保存腳本：將修改后的腳本保存為.sh文件，推薦命名為與你的應用相關的易于識別的名字，如myapp-manager.sh。
構建目錄結構：依據之前提到的目錄結構圖，在你的工作目錄下創(chuàng)建相應的目錄。確保bin目錄下存放著你的Shell腳本，而lib目錄內則需放入對應的jar包。

2.3 操作你的Java應用

啟動應用：通過終端切換到腳本所在的bin目錄，然后運行以下命令啟動應用：
```
./myapp-manager.sh start
```
這將會后臺啟動你的Java應用，并將輸出信息保存到log目錄下.log結尾的日志文件中，同時在pid目錄下生成一個包含應用進程ID的文件。
停止應用：當需要關閉應用時，執(zhí)行：
```
./myapp-manager.sh stop
```
此命令會讀取PID文件，發(fā)送終止信號給應用進程，并清理PID文件。
重啟應用：如果需要重啟應用以應用最新更改，僅需輸入：
```
./myapp-manager.sh restart
```
這個操作會自動完成停止和再次啟動的全過程，中間包含短暫的等待時間以確保平穩(wěn)過渡。