Jenkins 是一個開源的自動化部署工具，廣泛用于持續(xù)集成（CI）和持續(xù)交付（CD）流程。它支持自動化構(gòu)建、測試和部署應(yīng)用程序。以下是 Jenkins 的安裝與配置的詳細(xì)教程。

1. 安裝 Jenkins

以下步驟適用于 Linux 系統(tǒng)（以 Ubuntu 和 CentOS 為例），并包含安裝必要的依賴環(huán)境。

1.1 安裝 Jenkins 的前置條件

(1) 安裝 Java

Jenkins 需要 Java 環(huán)境，推薦使用 Java 11 或更高版本。

Ubuntu/Debian 系統(tǒng)：

sudo apt update
sudo apt install openjdk-11-jdk -y
java -version

CentOS/RHEL 系統(tǒng)：

sudo yum update
sudo yum install java-11-openjdk -y
java -version

確保 Java 安裝成功，執(zhí)行 java -version 確認(rèn)版本。

1.2 添加 Jenkins 倉庫并安裝

(1) 在 Ubuntu/Debian 系統(tǒng)上安裝 Jenkins

1. 添加 Jenkins 官方倉庫：

   bash

    

   curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
   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 > /dev/null

2. 更新包列表并安裝 Jenkins：

   bash

    

   sudo apt update
   sudo apt install jenkins -y

(2) 在 CentOS/RHEL 系統(tǒng)上安裝 Jenkins

1. 添加 Jenkins 官方倉庫：

   bash

    

   sudo yum install -y wget
   wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
   rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

2. 安裝 Jenkins 和依賴：

   bash

    

   sudo yum install jenkins -y

1.3 啟動 Jenkins 服務(wù)

啟動 Jenkins 并設(shè)置開機(jī)自啟：

Ubuntu/Debian 系統(tǒng)：

sudo systemctl start jenkins
sudo systemctl enable jenkins

CentOS/RHEL 系統(tǒng)：

sudo systemctl start jenkins
sudo systemctl enable jenkins

檢查 Jenkins 的運行狀態(tài)：

sudo systemctl status jenkins

1.4 配置防火墻（可選）

如果服務(wù)器啟用了防火墻，需要開放 Jenkins 默認(rèn)端口 8080。

Ubuntu/Debian 系統(tǒng)：

sudo ufw allow 8080
sudo ufw reload

CentOS/RHEL 系統(tǒng)：

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

2. 初始配置 Jenkins

2.1 訪問 Jenkins

1. 打開瀏覽器，訪問 Jenkins：

    

    

   http://<服務(wù)器IP>:8080

   如果是在本地安裝，則訪問：

    

    

   http://localhost:8080

2. 進(jìn)入 Jenkins 解鎖頁面，系統(tǒng)會提示輸入初始管理員密碼。

2.2 獲取初始管理員密碼

1. 在終端中查看初始密碼：

   bash

    

   sudo cat /var/lib/jenkins/secrets/initialAdminPassword

2. 將輸出的密碼復(fù)制到瀏覽器頁面，點擊 Continue。

2.3 安裝推薦插件

1. 在插件安裝頁面，選擇 Install suggested plugins（安裝推薦插件）。
2. 等待插件安裝完成（可能需要幾分鐘）。

2.4 創(chuàng)建管理員賬戶

1. 輸入管理員用戶名、密碼和郵箱地址。
2. 點擊 Save and Continue 保存。

2.5 配置實例 URL

1. 設(shè)置 Jenkins 的訪問 URL（如 http://<服務(wù)器IP>:8080）。
2. 點擊 Save and Finish 完成配置。

3. 配置 Jenkins

3.1 配置全局工具

Jenkins 支持集成多種開發(fā)工具（如 Git、Maven、Gradle 等），需要初始化配置。

1. 進(jìn)入全局工具配置頁面：

   • 在 Jenkins 主頁面，點擊 Manage Jenkins > Global Tool Configuration。

2. 常見工具配置：

   • Git：
     • 點擊 Git > Add Git。
     • 指定 Git 可執(zhí)行文件路徑（如 /usr/bin/git）。
   • Maven（可選）：
     • 如果需要構(gòu)建 Java 項目，點擊 Maven > Add Maven。
     • 填寫 Maven 名稱（如 Maven3），并選擇自動安裝。
   • JDK：
     • Jenkins 會自動檢測 Java 環(huán)境。

3.2 配置憑據(jù)

Jenkins 使用憑據(jù)來安全地存儲訪問代碼倉庫（如 GitHub、GitLab）的認(rèn)證信息。

1. 添加憑據(jù)：

   • 在 Jenkins 主頁面，點擊 Manage Jenkins > Manage Credentials。
   • 點擊 (global) > Add Credentials。
   • 選擇憑據(jù)類型：
     • 用戶名和密碼：用于私有倉庫的訪問。
     • SSH 密鑰：用于通過 SSH 訪問 Git 倉庫。
   • 保存信息。

2. 使用憑據(jù)：

   • 在創(chuàng)建 Jenkins 項目時，選擇剛添加的憑據(jù)。

3.3 配置郵件通知

1. 在 Jenkins 主頁面，點擊 Manage Jenkins > Configure System。
2. 找到 E-mail Notification 設(shè)置：
   • 輸入 SMTP 服務(wù)器地址（如 smtp.gmail.com）。
   • 配置發(fā)送郵箱和認(rèn)證信息。
3. 測試郵件通知功能。

4. 創(chuàng)建 Jenkins 項目

4.1 創(chuàng)建自由風(fēng)格項目

1. 點擊 New Item 創(chuàng)建新項目。

2. 輸入項目名稱，選擇 Freestyle project，點擊 OK。

3. 配置項目：

   • 源碼管理：
     • 選擇 Git，填寫代碼倉庫地址。
     • 添加憑據(jù)（如果是私有倉庫）。
   • 構(gòu)建觸發(fā)器：
     • 配置觸發(fā)條件（如定時觸發(fā)、代碼變更觸發(fā)）。
   • 構(gòu)建步驟：
     • 添加構(gòu)建步驟（如執(zhí)行 Shell 腳本、調(diào)用 Maven 構(gòu)建）。
   • 構(gòu)建后操作：
     • 配置構(gòu)建結(jié)果通知或發(fā)布操作。

4. 保存配置，點擊 Build Now 開始構(gòu)建。

4.2 配置流水線項目（Pipeline）

1. 點擊 New Item，選擇 Pipeline。
2. 在 Pipeline 配置中，使用腳本定義流水線：
   groovy

    

   pipeline {
       agent any
       stages {
           stage('Build') {
               steps {
                   echo 'Building...'
               }
           }
           stage('Test') {
               steps {
                   echo 'Testing...'
               }
           }
           stage('Deploy') {
               steps {
                   echo 'Deploying...'
               }
           }
       }
   }

3. 保存后運行流水線。

5. 常見問題與解決方法

5.1 無法訪問 Jenkins

• 檢查 Jenkins 服務(wù)狀態(tài)：
  bash

   

  sudo systemctl status jenkins

• 確保防火墻開放了端口 8080。

5.2 插件安裝失敗

• 檢查網(wǎng)絡(luò)連接是否正常。
• 手動更新插件源：
  • 在 Manage Jenkins > Plugin Manager 中，切換到其他插件鏡像（如 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/）。

5.3 構(gòu)建失敗

• 檢查 Jenkins 是否安裝了所需工具（如 Maven、Git）。
• 查看控制臺輸出日志，定位錯誤原因。

6. 總結(jié)

通過以上步驟，您可以成功安裝和配置 Jenkins，并創(chuàng)建自動化構(gòu)建和部署任務(wù)。以下是關(guān)鍵點總結(jié)：

1. 安裝 Jenkins 和配置 Java 環(huán)境。
2. 初始化 Jenkins：安裝推薦插件、創(chuàng)建管理員賬戶、配置全局工具。
3. 創(chuàng)建項目：支持自由風(fēng)格項目和流水線項目。
4. 集成工具：如 Git、Maven 和郵件通知。

Jenkins 的強(qiáng)大功能可以大幅提高軟件開發(fā)和部署的效率，適用于個人開發(fā)者和企業(yè)級項目。