Linux下Jenkins怎樣配置

一、Linux下Jenkins安裝準備

1. 系統要求：確保Linux系統為Ubuntu、CentOS等主流發行版；內存≥256MB，磁盤≥1GB（建議SSD提升構建速度）。
2. Java環境：Jenkins依賴Java運行，需安裝JDK 8或11（推薦OpenJDK）?？赏ㄟ^java -version驗證，未安裝則執行：
   • Ubuntu/Debian：sudo apt update && sudo apt install openjdk-11-jdk
   • CentOS/Fedora：sudo yum install java-11-openjdk-devel。

二、Jenkins安裝步驟

1. 添加官方倉庫（Ubuntu/Debian為例）：
   • 導入GPG密鑰：wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
   • 添加軟件源：sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
   • 更新包列表：sudo apt update。
2. 安裝Jenkins：執行sudo apt install jenkins（CentOS/Fedora替換為sudo yum install jenkins），安裝過程中確認依賴項安裝。
3. 啟動與開機自啟：
   • 啟動服務：sudo systemctl start jenkins
   • 設置開機自啟：sudo systemctl enable jenkins
   • 檢查狀態：sudo systemctl status jenkins（顯示“active (running)”即為成功）。

三、初始配置

1. 獲取初始密碼：首次訪問需輸入管理員密碼，執行sudo cat /var/lib/jenkins/secrets/initialAdminPassword復制密碼。
2. 完成向導：
   • 訪問http://<服務器IP>:8080，粘貼密碼進入向導。
   • 安裝插件：推薦選擇“安裝建議的插件”（包含Git、Maven、Pipeline等常用插件）；若網絡慢，可進入“Manage Jenkins→Manage Plugins→Advanced”，修改Update Site為國內鏡像（如http://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json）。
   • 創建管理員用戶：填寫用戶名、密碼、郵箱等信息，點擊“保存并完成”。
3. 配置全局工具（關鍵步驟）：
   • 進入“Manage Jenkins→Global Tool Configuration”：
     • JDK：添加JDK路徑（若已安裝，Jenkins會自動檢測；否則手動指定JAVA_HOME，如/usr/lib/jvm/java-11-openjdk-amd64）。
     • Git：配置Git可執行文件路徑（若已安裝，Jenkins會自動檢測；否則手動指定/usr/bin/git）。
     • Maven/Gradle（可選）：添加安裝路徑或選擇自動安裝。

四、常用配置優化

1. 修改端口/工作目錄：
   • 編輯配置文件（Ubuntu/Debian為/etc/default/jenkins，CentOS為/etc/sysconfig/jenkins）：
     • 修改端口：JENKINS_PORT="8081"（避免與現有服務沖突）。
     • 修改工作目錄：JENKINS_HOME="/var/lib/jenkins"（默認路徑，可自定義，需確保權限正確）。
   • 重啟服務生效：sudo systemctl restart jenkins。
2. 配置HTTPS（生產環境必選）：
   • 生成SSL證書（可使用Let’s Encrypt免費證書）：sudo certbot certonly --standalone -d yourdomain.com
   • 啟動時指定證書路徑：java -jar jenkins.war --httpsPort=8443 --httpsKeyStore=/etc/letsencrypt/live/yourdomain.com/fullchain.pem --httpsKeyStorePassword=yourpassword
   • 或通過系統服務配置（修改JENKINS_OPTS參數）。
3. 調整JVM內存：
   • 編輯配置文件（同上），添加JAVA_OPTS="-Xms512m -Xmx2048m -Djava.awt.headless=true"（初始堆內存512MB，最大堆內存2048MB，無頭模式運行）。

五、安全配置

1. 限制監聽地址：修改配置文件，設置JENKINS_LISTEN_ADDRESS="127.0.0.1"（僅本地訪問）或內網IP（如192.168.1.100），避免暴露在公網。
2. 禁用CSRF保護（測試環境可選）：啟動時添加--disable-hudson.security.csrf.CrumbIssuer參數，生產環境建議保持開啟。
3. 定期更新：通過“Manage Jenkins→Manage Plugins→Available”檢查插件更新，及時升級Jenkins核心及插件（避免安全漏洞）。

六、常見問題解決

1. 端口沖突：執行netstat -tulpn | grep 8080查看端口占用，修改Jenkins端口或停止占用服務。
2. 插件安裝慢：更換國內鏡像源（如清華鏡像），修改/var/lib/jenkins/updates/default.json（替換updates.jenkins.io為mirrors.tuna.tsinghua.edu.cn/jenkins）。
3. 權限問題：確保JENKINS_HOME目錄權限正確（chown -R jenkins:jenkins /var/lib/jenkins，jenkins為用戶）。