Linux离线集成Jenkins实现自动拉取代码并部署到服务器且发送构建结果到邮箱

一、准备工作

开始前服务器需安装JDK、git、maven、node以及项目启动所需的mysql、redis等。插件是Jenkins使用的，需要先安装Kenkins。以下是本文所使用的各个组件版本，使用其他版本可能会有兼容问题续特别注意。【安装过程中遇到问题可先查看目录十二有没有解决办法，大部分问题我都蹚过来了😭😭😭】

工具	版本
JDK	17
jenkins	2.479.3
git	2.47.1
maven	3.9.12
node	16.20.2
gitee插件	1190.v317d91b_3a_4e2
Publish Over SSH插件	390.vb_f56e7405751
nodejs插件	1.6.5
Generic Webhook Trigger插件	2.3.1
Email Extension插件	1876.v28d8d38315b_d

二、下载

War Jenkins Packageshttps://get.jenkins.io/war-stable/Linux下载war包部署。

三、启动

war包传入系统后使用java -jar 命令启动

nohup java -jar jenkins2.479.3.war –httpPort=18080 > /opt/jenkins/logs/jenkins.log 2>&1 &

有防火墙则关闭或开放相应端口

# 开放18080端口
firewall-cmd –permanent –add-port=18080/tcp
firewall-cmd –reload

浏览器输入IP：端口号登录

http://IP:18080

首次登录需输入密码解锁，可输入以下命令查看

cat /root/.jenkins/secrets/initialAdminPassword

四、新手入门

点击选择插件安装

点击无再点击安装即可跳过初始插件安装，后续可离线安装所需插件。

创建一个管理员账户

实例配置默认即可

保存即可完成新手入门

五、配置镜像

如需联网安装插件则需要配置更新中心为国内镜像源，找到Jenkins配置文件

vi /root/.jenkins/hudson.model.UpdateCenter.xml

替换镜像源为国内镜像源

<?xml version='1.0' encoding='UTF-8'?>
<sites>
<site>
<id>default</id>
<!– 阿里镜像 –>
<url>https://mirrors.aliyun.com/jenkins/</url>
<!– <url>https://mirrors.cloud.tencent.com/jenkins/updates/update-center.json</url> –>
</site>
</sites>

重启Jenkins

# 查进程
ps -ef | grep jenkins
# 杀进程
kill -9 [进程ID]
# 重启
nohup java -jar jenkins2.479.3.war –httpPort=18080 > /opt/jenkins/logs/jenkins.log 2>&1 &

另外也可以在管理界面修改镜像源

六、安装插件

这里以gitee插件为例，实现离线安装Jenkins插件、下载离线安装包Jenkins Plugins

去Jenkins管理后台安装

选中安装后重启

七、配置Gitee插件

链接名可自定义，域名固定、令牌根据提示从私人令牌 – Gitee.com获取

点击添加令牌

把刚才生成的令牌填进来

选择刚添加的令牌并测试连接

八、创建项目-后端

项目创建完成后需进行下一步配置，先选中之前创建好的Gitee的连接，然后选Git。

输入Git的相关配置

②为仓库地址
③为全局凭证（添加方式见错误解决-8）
④为触发规则Name字段中输入 origin， Refspec 字段输入 +refs/heads/*:refs/remotes/origin/* +refs/pull/*/MERGE:refs/pull/*/MERGE ，注意新版 jenkins 不再接受多条同时包含 * 通配符的 refs 描述，如只对 push 触发可写前半部分，如只对 PR 触发可只写后半段。

继续往下配置，Branch Specifier的目的相当于监听哪个分支的活动的填写规则要与Refspec对应，现在Refspec配的是单仓库工作流，所以Branch Specifier配origin/dev_smart_energy为仓库中的dev_smart_energy分支。将来只会拉取此分支的代码。Repository browser为显示具体提交记录的配置，默认自动即可。最后的Additional Behaviours是构建前的额外行为例如合并代码等，这里我只是拉取dev_smart_energy分支并构建所以不添加额外的配置。

继续往下配置触发器。使用webhook实现的效果为Gitee检测到代码提交时会主动推送事件到jenkins，此选项要保证服务器可以连接外网。使用Poll SCM的效果是jenkins定时拉取代码，此选项不需要连接外网。这里我使用Poll SCM每5分钟拉取一次(目录十二已实现Gitee主动推送)。

九、自动部署-后端

先安装一个publish over ssh插件，此插件可以把jar包发送到指定服务器并进行后续操作。安装后需配置JDK、Maven、publish over ssh。

配置JDK的目录（地址根据自己的来）

配maven的目录（地址根据自己的来）

配置publish over ssh，操作目录即jar包准备放置在服务器的位置。

以上配置完成后，现在返回项目配置，去配置项目的Build Steps，先添加一个构建mvn项目的步骤，然后配置。

再添加一个publish over ssh提供的步骤，然后配置，Source files即为Jenkins中各项目的工作目录。

# 1. 切换到jar包所在目录（/opt/apps）
cd /opt/apps || exit 1
# 2. 停止原有同名jar包进程（避免端口冲突）
PID=$(ps -ef | grep app.jar | grep -v grep | awk '{print $2}')
[ -n "${PID}" ] && kill -9 ${PID} >/dev/null 2>&1
# 3. 启动jar包（日志输出到/opt/apps/app.log，而非登录目录）
nohup /usr/local/jdk/jdk-17.0.2/bin/java -jar /opt/apps/app.jar > /opt/apps/app.log 2>&1 &
# 4. 输出启动成功提示
echo "Jar包已启动，日志路径：/opt/apps/app.log"

执行验证

查看日志，已拉取到最新的提交且后续会打包并部署到远程。

去服务器查看，自动拉取部署成功。

十、创建项目-前端

跟后端一样配置好gitee，拉取分支即可。

十一、自动部署-前端

先在服务器安装node，后在jenkins安装node插件然后配置。

而后在前端项目配置node构建

其中npmrc file可以用默认的也可以用自己配的，如下配置了一个镜像源（也可在执行脚本中指定）。

配置完Node后继续配置下一步，这里选择shell脚本，此脚本执行后会打包vue项目并把dist压缩。

#!/bin/bash
set -x # 打印执行的命令

echo "======= Node/npm 版本 ======="
node -v
npm -v

echo -e "\\n======= 切换 npm 镜像 ======="
npm config set registry https://registry.npmmirror.com
npm config get registry # 验证镜像切换成功

echo -e "\\n======= 开始安装依赖======="
npm install –verbose

echo -e "\\n======= 删除以前的构建 ======="
rm -rf ./dist

echo -e "\\n======= 开始构建项目 ======="
npm run build:prod

echo -e "\\n======= 压缩 ======="
tar -zcvf ./dist.tar.gz ./dist

继续添加下一步，之前用过publish over ssh插件，所以此处继续使用此插件把dist压缩包传送到服务器指定位置并完后后续操作。由于前后端项目想要存放的文件路径可能不一样，和之前一样先配一个配置publish over ssh。

配置完之后返回项目配置，继续配置下一步。

此脚本会执行换包的操作并重启nginx。nginx需提前配置好。

#!/bin/bash
set -ex

#参数
TARGET_DIR="/usr/share/nginx/html"
KEEP_FILE="dist.tar.gz"
TAR_FILE="${TARGET_DIR}/${KEEP_FILE}"

# 强制切换到目标目录（避免执行目录错误）
cd "${TARGET_DIR}" || { echo "切换到目标目录失败！"; exit 1; }

echo -e "\\n======= 步骤1：验证压缩包是否存在 ======="
if [ ! -f "${TAR_FILE}" ]; then
echo "结果：压缩包不存在！路径：${TAR_FILE}"
ls -l "${TARGET_DIR}"
exit 1
fi
echo "结果：压缩包存在 → ${TAR_FILE}"

echo -e "\\n======= 步骤2：清空部署目录 ======="
find "${TARGET_DIR}" -mindepth 1 -maxdepth 1 ! -name "${KEEP_FILE}" -exec sudo rm -rf {} \\;
echo "结果：部署目录清空成功"

echo -e "\\n======= 步骤3：解压压缩包 ======="
# 仅保留基础解压参数，-C确保解压到目标目录
sudo tar -zxvf "${TAR_FILE}" -C "${TARGET_DIR}"
echo "结果：压缩包解压成功（保留dist外层目录）"
# 验证解压结果：列出目录内容
ls -l "${TARGET_DIR}" | head -10

echo -e "\\n======= 步骤4：删除压缩包 ======="
sudo rm -f "${TAR_FILE}"
echo "结果：压缩包删除成功"

echo -e "\\n======= 步骤5：重启Nginx ======="
sudo nginx -t # 加sudo避免权限不足
if [ $? -eq 0 ]; then
sudo systemctl restart nginx
if systemctl is-active –quiet nginx; then
echo "结果：Nginx重启成功"
else
echo "结果：Nginx重启失败！"
exit 1
fi
else
echo "结果：Nginx配置语法错误，取消重启！"
exit 1
fi

echo -e "\\n======= 最终结果：所有操作执行成功 ======="
exit 0

执行测试，可以看到成功拉取代码，执行install命令，执行build构建，压缩，换包，重启nginx。