当前位置：首页 > 科技 > 软件

离线部署 Jenkins 填坑指南

来源：责编：时间：2024-06-05 17:42:49 247观看

导读本文目录如下：一、背景在实际项目中，通过这些实践，目前已经稳定运行了两个月，现在又有了一个新项目也是需要用 Jenkins 来实现自动化部署，但新项目的部署环境是 Linux 离线环境，所以我需要在离线环境上再部署一遍。因为部署

本文目录如下：

一、背景

在实际项目中，通过这些实践，目前已经稳定运行了两个月，现在又有了一个新项目也是需要用 Jenkins 来实现自动化部署，但新项目的部署环境是 Linux 离线环境，所以我需要在离线环境上再部署一遍。

因为部署 Jenkins 的机器上没有网络，所以部署的过程中遇到了很多坑，本篇文章也是为了记录期间遇到的坑，以及解决方案。

二、依赖项

部署后端项目时需要依赖 Java、Maven、Git，对应的离线包版本如下表所示。

序号	依赖项	版本
1	Linux 服务器	建议 ubuntu 20 以上
2	Jenkins 离线 war 包	2.426.1（当前最新版本）
3	Java 离线包，后端部署需要	Java 11, Java 17 or Java 21
4	Maven 离线安装，后端部署需要	Maven 3.8.8
5	Git 离线包，拉取代码	2.9.5（当前最新版本）

关于离线部署前端项目会放到下一讲。

三、下载 Jenkins 安装包

安装包路径：

https://get.jenkins.io/war-stable/

选择版本：2.426.1

图片

下载完是一个 war 包，后续用 Java 启动这个 war 包即可。

图片

四、安装 Java

下载 Java 17 安装包

图片

创建目标目录：

sudo mkdir -p /usr/local/java

复制安装包到目标目录：

sudo cp /path/to/jdk-17_linux-x64_bin.tar.gz /usr/local/java

解压安装包：

cd /usr/local/javasudo tar -xvzf jdk-17_linux-x64_bin.tar.gz

移除压缩包：

sudo rm jdk-17_linux-x64_bin.tar.gz

配置环境变量：

sudo vim /etc/profileexport PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/binexport JAVA_HOME=/usr/local/javaexport PATH=$PATH:$JAVA_HOME/bin

加载环境变量：

source /etc/profile

检查 Java 版本：

java -version

java 版本

五、启动 Jenkins

启动方式分为两种：

直接启动
后台静默启动

直接启动 jenkins

执行启动的命令：

java -jar jenkins.war --httpPort=8082

后台静默启动

执行启动的命令：

nohup java -jar jenkins.war --httpPort=8082 >nohup.out 2>&1 &

打开 Jenkins 站点

打开 Jenkins 站点 http://<你的服务器ip>:8082。

遇到异常，提示如下：

图片

java.lang.RuntimeException: Fontconfig head is null, check your fonts or fonts configuration

解决方案：

将安装了 java8 的 fontconfig.bfc 文件拷贝到 jenkins 那台服务器上的 java lib 目录下fontconfig.bfc 示例路径：C:/Program Files/Java/jre1.8.0_191/lib/fontconfig.bfc拷贝到 /usr/local/java/lib/ 目录

再次启动，运行成功。另外有一个提示无法访问 jenkins 更新网站的错误，可以忽略，因为该服务器没联网所以访问不到。

图片

jenkins 运行目录

另外还需要从打印的日志找到 jenkins 的运行目录，后续会用到。

如下图所示，在 /home/xxx/.jenkins 目录。

jenkins 运行目录

该目录下有一个非常重要的目录：plugins，我们可以拷贝一些插件到这个目录里面，这样 jenkins 就可以启动这些插件了。

图片

六、配置 maven

下载地址：

https://maven.apache.org/download.cgi

解压文件夹：

cd /usr/localtar -zvxf /usr/local/maven/apache-maven-3.8.8-bin.tar.gzmv  apache-maven-3.8.8/* mavensudo rm -rf apache-maven-3.8.8sudo rm -rf /usr/local/maven/apache-maven-3.8.8-bin.tar.gz

添加环境变量：

sudo vim /etc/profile

配置信息：

export M2_HOME=/usr/local/mavenexport MAVEN_HOME=/usr/local/mavenexport PATH=${M2_HOME}/bin:${PATH}

加载配置

source /etc/profile

查看 maven 配置是否生效：

mvn -version

图片

七、配置 Git

下载安装包

网站路径：https://mirrors.edge.kernel.org/pub/software/scm/git/

拷贝到这个目录下 /usr/local/git/，如果没有 git 目录则新建一个。

sudo mkdir -p /usr/local/git

图片

解压 git 安装包

sudo tar -xvzf /usr/local/git/git-2.9.5.tar.gz -C /usr/local/git

编译 git

cd /usr/local/git./configure --prefix=/usr/local/gitmake && make install

提示没有 gcc 编译器：

图片

解决方案：离线安装依赖包。

下载依赖的安装包

下载地址：https://pkgs.org/search/?q=libnl-genl

安装依赖的安装包

dpkg -i xxx.deb

再次编译，提示编译成功

图片

添加 git 环境变量：

export PATH=$PATH:/usr/local/git/binsource /etc/profile

查看 git 版本：

git --version

八、安装 Jenkins 插件

离线环境下，不能通过直接选择插件安装的方式，所以需要将插件的离线包导入到 plugins 目录下。

方式一：在线下载插件离线包并导入到 Jenkins 后台。
方式二：批量拷贝同版本 Jenkins 在线安装的插件。

方式一：下载插件并导入

以下两个站点都可以在线下载插件。

https://plugins.jenkins.io/

http://updates.jenkins-ci.org/download/plugins/

安装 Git 插件

图片

可能会提示依赖的插件不存在，如下所示：

- Plugin is missing: structs (308.v852b473a2b8c) - Plugin is missing: workflow-scm-step (2.13) - Plugin is missing: scm-api (595.vd5a_df5eb_0e39) - Plugin is missing: mailer (408.vd726a_1130320) - Plugin is missing: credentials (2.6.1) - Plugin is missing: git-client (3.11.0) - Plugin is missing: script-security (1131.v8b_b_5eda_c328e) - Plugin is missing: workflow-step-api (622.vb_8e7c15b_c95a_) - Plugin is missing: credentials-binding (1.27.1) - Plugin is missing: ssh-credentials (1.19)

因为有些插件依赖其他插件，所以需要先将其他插件安装，如果再安装的过程中又遇到缺失其他的插件，都按这种方式处理。

方式二：批量拷贝已安装的插件

先在有网的机器上部署相同的版本的 Jenkins，然后在线安装所需插件，最后批量拷贝插件到离线的 Jenkins 插件目录下。

插件所在的目录一般在这里：

/home/<user>/.jenkins/plugins/

拷贝之后，重启 Jenkins 就会自动安装这些插件了。

九、配置全局工具

配置 Maven settings

在 Jenkins 后台系统管理->全局工具配置中添加 Maven settings 配置，如下图所示。

路径为 Maven setting 的文件路径：/usr/local/maven/conf/settings.xml。

图片

配置 Maven 安装

在 Jenkins 后台系统管理->全局工具配置中添加 Maven 安装配置，如下图所示。

路径为 Maven 的安装路径：/usr/local/maven/。

图片

配置 Java JDK

在 Jenkins 后台系统管理->全局工具配置中添加 Java 配置，如下图所示：

路径为 Java 的安装路径：/usr/local/java/。

JDK 路径配置

配置 Git

在 Jenkins 后台系统管理->全局工具配置中添加 Git 配置，如下图所示：

路径为 Java 的安装路径：/usr/bin/git。

图片

十、问题

问题 1、pipeline 输入框没有显示出来

F12 调试工具可以报错信息如下：

jenkins workflow-editor.js Ajax is not defined ReferenceError: Ajax is not defined

原因

插件有问题。

解决方案

替换所有插件文件。安装一个同样版本的 jenkins，并在线下载插件，并删除原 jenkins 的插件目录，然后替换全部插件文件。

问题 2、bat 命令不识别

java.io.IOException: Batch scripts can only be run on Windows nodes

原因

当前 Jenkins 部署在 Linux 系统中，所以不能识别 bat 命令。因为 bat 命令是 windows 系统使用的命令，而 sh 命令才是 linux 系统使用的命令。

解决方案

将 bat 改为 sh。

问题 3、执行 sudo 命令需要密码

SSH: EXEC: STDOUT/STDERR from command [sudo docker service update --force job-executor] ...SSH: EXEC: connectedsudo: no tty present and no askpass program specified

原因

由于 jenkins 帐号并没有开启免密码导致的。

解决方法

给jenkins添加不用密码使用sudo的权限。

sudo vi /etc/sudoers

在sudoers文件中加一行：

jenkins ALL=(ALL) NOPASSWD:ALL

问题 4、RoleBasedAuthorizationStrategy 插件问题

报错信息

SEVERE  jenkins.InitReactorRunner$1#onTaskFailed: Failed Loading global configcom.thoughtworks.xstream.mapper.CannotResolveClassException: com.michelin.cio.hudson.plugins.rolestrategy.RoleBasedAuthorizationStrategy

原因

jenkins 插件安装有问题导致无法启动 jenkins

解决方案

修改 /home/xxx/.jenkins/config 文件

<authorizationStrategy class="hudson.security.FullControlOnceLoggedInAuthorizationStrategy">  <denyAnonymousReadAccess>true</denyAnonymousReadAccess></authorizationStrategy>

问题 5、需要更新插件版本

部分插件由于缺少依赖无法加载。要恢复这些插件提供的功能，需要修复这些问题并重启 Jenkins。

图片

原因

缺少插件或版本不正确。

解决方案

将对应的版本的插件 xxx.jpi 下载后，在后台上传，部署插件完成后，勾选重启 jenkins 服务。

问题 6、Git 拉取代码提示证书问题

报错信息：

server certificate verification failed. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile:

原因

缺少证书。

解决方案

跳过 Git 的证书验证。

git config --global http.sslVerify false

问题 7、配置环境变量后，找不到 sudo 命令

报错信息：

Command 'sudo' is available in '/usr/bin/sudo'

原因

环境变量配置有问题，找不到

解决方案

使用以下命令重新打开 /etc/profile 文件

/usr/bin/sudo /usr/bin/vim /etc/profile

把以下环境变量配置到 profile 中的其他环境变量之前

export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

图片

问题 8、Jenkins 时区问题相差 8 小时

解决方案

进入 Jenkins 的系统管理页面。
点击“脚本命令行”。
执行以下命令以设置时区为北京时间：

System.setProperty('org.apache.commons.jelly.tags.fmt.timeZone', 'Asia/Shanghai')

确保时区设置正确以便任务构建和定时构建按照北京时间触发。

十一、总结

本篇讲解了在离线环境下如何部署 Jenkins、Jenkins 插件、Maven、Java、Git 工具。

在部署的过程中遇到了很多坑，遇到一个解决一个，希望大家在以后遇到类似问题时，能根据本文档缩短排查问题的时间。

本文链接：http://www.28at.com/showinfo-26-92123-0.html离线部署 Jenkins 填坑指南

声明：本网页内容旨在传播知识，若有侵权等问题请及时与本网联系，我们将在第一时间删除处理。邮件：2376512515@qq.com

上一篇：解决消息队列中的关键问题：消息丢失、顺序消费、消息积压与重复消费

下一篇：前端构建工具大盘点

标签：

热门焦点

7月安卓手机性能榜：红魔8S Pro再夺榜首

7月份的手机市场风平浪静，除了红魔和努比亚带来了两款搭载骁龙8Gen2领先版处理器的新机之外，别的也想不到有什么新品了，这也正常，通常6月7月都是手机厂商修整的时间，进入8月份之
2023年Q2用户偏好榜：12+256G版本成新主流

3月份的性能榜、性价比榜和好评榜之后，就要轮到2023年的第二季度偏好榜了，上半年的新机潮已经过去，最明显的肯定就是大内存和存储的机型了，另外部分中端机也取消了屏幕塑料支架
6月iOS设备性能榜：M2稳居榜首 A系列只能等一手3nm来救

没有新品发布，自然iOS设备性能榜的上榜设备就没有什么更替，仅仅只有跑分变化而产生的排名变动，毕竟苹果新品的发布节奏就是这样的，一年下来也就几个移动端新品，不会像安卓厂商，一
服务存储设计模式：Cache-Aside模式

Cache-Aside模式一种常用的缓存方式，通常是把数据从主存储加载到KV缓存中，加速后续的访问。在存在重复度的场景，Cache-Aside可以提升服务性能，降低底层存储的压力，缺点是缓存和底
得物效率前端微应用推进过程与思考

一、背景效率工程随着业务的发展，组织规模的扩大，越来越多的企业开始意识到协作效率对于企业团队的重要性，甚至是决定其在某个行业竞争中突围的关键，是企业长久生存的根本。得物
从零到英雄：高并发与性能优化的神奇之旅

作者 | 波哥审校 | 重楼作为公司的架构师或者程序员，你是否曾经为公司的系统在面对高并发和性能瓶颈时感到手足无措或者焦头烂额呢？笔者在出道那会为此是吃尽了苦头的，不过也得
共享单车的故事讲到哪了？

来源丨海克财经与共享充电宝相差不多，共享单车已很久没有被国内热点新闻关照到了。除了一再涨价和用户直呼用不起了。近日多家媒体再发报道称，成都、天津、郑州等地多个共享单
认真聊聊东方甄选：如何告别低垂的果实

来源：山核桃作者：财经无忌爆火一年后，俞敏洪和他的东方甄选依旧是颇受外界关心的“网红”。7月5日至9日，为期5天的东方甄选“甘肃行”首次在自有App内直播，
信通院：小米、华为等11家应用商店基本完成APP签名及验签工作

中国信通院表示，目前，小米、华为、OPPO、vivo、360手机助手、百度手机助手、应用宝、豌豆荚和努比亚等9家应用商店，以及抖音和快手2家新型应用分发平

离线部署 Jenkins 填坑指南

一、背景

二、依赖项

三、下载 Jenkins 安装包

四、安装 Java

下载 Java 17 安装包

五、启动 Jenkins

直接启动 jenkins

后台静默启动

打开 Jenkins 站点

jenkins 运行目录

六、配置 maven

七、配置 Git

下载安装包

解压 git 安装包

编译 git

八、安装 Jenkins 插件

方式一：下载插件并导入

安装 Git 插件

方式二：批量拷贝已安装的插件

九、配置全局工具

配置 Maven settings

配置 Maven 安装

配置 Java JDK

配置 Git

十、问题

问题 1、pipeline 输入框没有显示出来

原因

解决方案

问题 2、bat 命令不识别

原因

解决方案

问题 3、执行 sudo 命令需要密码

原因

解决方法

问题 4、RoleBasedAuthorizationStrategy 插件问题

原因

解决方案

问题 5、需要更新插件版本

原因

解决方案

问题 6、Git 拉取代码提示证书问题

原因

解决方案

问题 7、配置环境变量后，找不到 sudo 命令

原因

解决方案

问题 8、Jenkins 时区问题相差 8 小时

解决方案

十一、总结

最新推荐

猜你喜欢

热门推荐

相关资讯