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

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

news 2026/5/11 14:15:39

简介

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” 是密钥名称，可自定义。

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路径下。

#!/bin/bash# 非常重要，参看：https://hezhongying.blog.csdn.net/article/details/158044582exportBUILD_ID=dontKillMeAPP_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"];thenOLD_PID=$(cat"$PID_FILE")ifps-p$OLD_PID>/dev/null;thenecho"停止进程$OLD_PID..."kill$OLD_PIDsleep3ifps-p$OLD_PID>/dev/null;thenkill-9$OLD_PIDfifirm-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"