當前位置：首頁 > 科技 > 軟件

離線部署 Jenkins 填坑指南

來源：責編：時間：2024-06-05 17:42:49 138觀看

導讀本文目錄如下：一、背景在實際項目中，通過這些實踐，目前已經穩定運行了兩個月，現在又有了一個新項目也是需要用 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.tebozhan.com/showinfo-26-92123-0.html離線部署 Jenkins 填坑指南

聲明：本網頁內容旨在傳播知識，若有侵權等問題請及時與本網聯系，我們將在第一時間刪除處理。郵件：2376512515@qq.com

上一篇：解決消息隊列中的關鍵問題：消息丟失、順序消費、消息積壓與重復消費

下一篇：前端構建工具大盤點

標簽：

熱門焦點

MIX Fold3包裝盒泄露新機本月登場

小米的全新折疊屏旗艦MIX Fold3將于本月發布，近日該機的真機包裝盒在網上泄露。從圖上來看，新的MIX Fold3包裝盒在外觀設計方面延續了之前的方案，變化不大，這也是目前小米旗艦
中興AX5400Pro+上手體驗：再升級雙2.5G網口+USB 3.0這次全都有

2021年11月的時候，中興先后發布了兩款路由器產品，中興AX5400和中興AX5400 Pro，從產品命名上就不難看出這是隸屬于同一系列的，但在外觀設計上這兩款產品可以說是完全沒一點關系
容量越大越不壞？24萬塊硬盤故障率報告公布這些產品零故障

8月5日消息，云存儲服務商Backblaze發布了最新的硬盤故障率報告，年故障率有所上升。Backblaze發布的硬盤季度統計數據，其中包括故障率等重要方面。這些結
28個SpringBoot項目中常用注解，日常開發、求職面試不再懵圈

前言在使用SpringBoot開發中或者在求職面試中都會使用到很多注解或者問到注解相關的知識。本文主要對一些常用的注解進行了總結，同時也會舉出具體例子，供大家學習和參考。注解
學習JavaScript的10個理由...

作者 | Simplilearn編譯 | 王瑞平當你決心學習一門語言的時候，很難選擇到底應該學習哪一門，常用的語言有Python、Java、JavaScript、C/CPP、PHP、Swift、C#、Ruby、Objective-
如何使用JavaScript創建一只圖像放大鏡？

譯者 | 布加迪審校 | 重樓如果您曾經瀏覽過購物網站，可能遇到過圖像放大功能。它可以讓您放大圖像的特定區域，以便瀏覽。結合這個小小的重要功能可以大大改善您網站的用戶體驗
2納米決戰2025

集微網報道從三強爭霸到四雄逐鹿，2nm的廝殺聲已然隱約傳來。無論是老牌勁旅臺積電、三星，還是誓言重回先進制程領先地位的英特爾，甚至初成立不久的新
半導體需求下滑三星電子DS業務部門今年營業虧損預計超10萬億韓元

7月17日消息，據外媒報道，去年下半年開始的半導體需求下滑，影響到了三星電子、SK海力士、英特爾等諸多廠商，營收明顯下滑，部分廠商甚至出現了虧損。作為
AI藝術欣賞體驗會在上海梅賽德斯奔馳中心音樂俱樂部上演

光影交錯的鏡像世界，虛實幻化的視覺奇觀，虛擬偶像與真人共同主持，這些場景都出現在2019世界人工智能大會的舞臺上。8月29日至31日，“AI藝術欣賞體驗會”在上海

離線部署 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 小時

解決方案

十一、總結

最新推薦

猜你喜歡

熱門推薦

相關資訊