使用Jenkins部署后端项目（Maven）

简介

Jenkins，是一款自动化部署的工具，使用它可以直接在控制台完成代码拉取、构建和部署，是大多数公司都具备的开发工具。

本文介绍如何使用 Jenkins 来部署后端项目。

配置环境

Jenkins 搭建完成，需配置 Maven、Git、JDK。在 全局工具配置 中，如下，

有些设置需要插件支持，没有安装插件可能没有对应的设置。可参考下面这篇博客，导入博主使用的插件。

Jenkins如何导入/导出插件

（1）Maven配置

有两处地方，第一处是 Maven 配置，设置 settings 路径。

第二处 Maven安装，设置成服务器 Maven 所安装的路径。

（2）Git配置

设置成系统 Git 可执行程序所在的路径，注意是 git 程序的路径，不是安装目录。

（3）JDK配置

设置成服务器 JDK 所在目录，不用到 bin 层级。

构建项目

以上配置完成，可以开始构建项目，以 Github 上的这个代码仓库（https://github.com/HeZhongYing/no_database_demo）为例。

Step1：创建任务

创建任务，如果是Maven项目，可选择 构建一个maven项目，否则，可选择 流水线 或 构建一个自由风格的软件项目。

点 确定，进入下一步。

Step2：详细设置

其实 Jenkins 只做三件事，1）拉代码；2）Maven构建；3）执行部署脚本。

所以在这个详细界面也就是配置做这些事所需要的设置，先来设置 Git。

点 Credentials 右侧的 添加，添加一个凭证。

选择 SSH 方式，这里也可以选择账号密码的方式（填 Git 仓库的账号密码）。

SSH 密钥对，可以在服务器上敲下面的命令生成，其中 ed25519 是密钥类型，"jenkins@centos7" 是密钥名称，可自定义。

shell 复制代码

ssh-keygen -t ed25519 -C "jenkins@centos7"

敲完后，连续敲三个回车，会在 ~/.ssh 目录下生成一对SSH密钥。

其中，

id_ed25519（密钥）：配置在 Jenkins 上；
id_ed25519.pub（公钥）：配置到代码仓库里；

配置完 Git，现在构建就能拉代码。接着对 Maven 进行配置，构建时使用 pom.xml 文件，执行 clean package -DskipTests 命令。

现在构建就会拉代码，并且执行 Maven 的 clean package -DskipTests 命令，生成对应的 jar 包。

接下来，在当前服务器上创建启动项目的脚本，这个脚本只做一件事，将前面构建完的 jar 包启动起来。

如下，文件名为 start_app.sh，放到 /home/projects 路径下。

shell 复制代码

#!/bin/bash

# 非常重要，参看：https://hezhongying.blog.csdn.net/article/details/158044582
export BUILD_ID=dontKillMe

APP_NAME="no_database_demo-1.0-SNAPSHOT"
JAR_PATH="/root/.jenkins/workspace/no_database_demo/target/${APP_NAME}.jar"
LOG_PATH="/var/log/${APP_NAME}.log"
PID_FILE="/var/run/${APP_NAME}.pid"  # 新增：定义PID文件路径
JAVA_CMD="/usr/local/dev/jdk-21.0.5/bin/java"

# --- 核心：通过PID文件杀死旧实例 ---
echo "正在停止所有旧的 $APP_NAME 进程..."
if [ -f "$PID_FILE" ]; then
    OLD_PID=$(cat "$PID_FILE")
    if ps -p $OLD_PID > /dev/null; then
        echo "停止进程 $OLD_PID..."
        kill $OLD_PID
        sleep 3
        if ps -p $OLD_PID > /dev/null; then
            kill -9 $OLD_PID
        fi
    fi
    rm -f $PID_FILE  # 删除旧PID文件
fi

# --- 启动新进程并写入PID文件 ---
echo "启动 $APP_NAME..."
nohup "$JAVA_CMD" -jar "$JAR_PATH" > "$LOG_PATH" 2>&1 &
NEW_PID=$!
echo $NEW_PID > $PID_FILE  # 写入新PID到文件
echo "启动成功，PID: $NEW_PID"