如何自定義Debian Jenkins設置

以下是自定義Debian Jenkins設置的關鍵步驟，涵蓋安裝、配置、插件及界面等方面：

一、基礎安裝與初始化

1. 安裝Java環境

   sudo apt update && sudo apt install openjdk-11-jdk  
   

   驗證：java -version。

2. 添加Jenkins倉庫并安裝

   wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -  
   echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list  
   sudo apt update && sudo apt install jenkins  
   

   啟動服務：sudo systemctl enable --now jenkins。

3. 首次配置
   訪問 http://服務器IP:8080，輸入初始密碼（路徑：/var/lib/jenkins/secrets/initialAdminPassword），安裝推薦插件（如Pipeline、Git）。

二、核心配置

1. 修改默認端口
   編輯 /etc/default/jenkins，找到 HTTP_PORT 修改為所需端口（如9090），重啟服務生效。

2. 權限與用戶管理

   • 禁用匿名訪問：Manage Jenkins → Security → Enable security，選擇“Logged-in users can do anything”。
   • 創建管理員用戶：Manage Jenkins → Manage Users，添加新用戶并分配權限。

3. 插件管理

   • 安裝插件：Manage Jenkins → Manage Plugins → Available 搜索安裝（如Docker、Kubernetes插件）。
   • 上傳自定義插件：可通過 Advanced 選項手動上傳插件包。

三、界面與主題自定義

1. 更換主題

   • 下載主題CSS文件（如Jenkins Material Theme），上傳至 /var/jenkins_home/userContent/ 目錄。
   • Manage Jenkins → Configure System → Theme，添加CSS文件路徑，重啟Jenkins。

2. 修改Jenkins主目錄
   編輯 /etc/default/jenkins，修改 JENKINS_HOME 路徑（需確保目錄權限正確），重啟生效。

四、高級配置

1. 配置Git/SVN倉庫

   • 在Job中選擇“Source Code Management”，添加倉庫地址及憑證（SSH密鑰需提前在 Manage Jenkins → Manage Credentials 中配置）。
   • 啟用Webhook觸發構建：GitHub Webhook URL 格式為 http://服務器IP:端口/github-webhook/。

2. 環境變量設置

   • 全局變量：Manage Jenkins → Configure System → Global properties，添加變量（如 JAVA_HOME）。
   • 項目級變量：在Pipeline腳本中使用 environment 指令定義。

3. 日志與存儲管理

   • 修改構建日志留存天數：Manage Jenkins → Configure System → Build history，設置 Max # of builds to keep。
   • 調整工作空間路徑：編輯 config.xml，修改 workspaceDir 路徑（需重啟）。

五、驗證與維護

• 重啟Jenkins：sudo systemctl restart jenkins，確保配置生效。
• 檢查插件狀態：Manage Jenkins → Manage Plugins → Installed，更新或修復異常插件。

參考來源：