Debian Jenkins與Git如何集成使用

1. 準備工作：安裝Java環境
Jenkins是基于Java的應用程序，需先安裝Java運行環境。在Debian系統上，執行以下命令安裝OpenJDK 11（Jenkins推薦版本）：

sudo apt update
sudo apt install -y openjdk-11-jdk
# 驗證安裝
java -version

確保輸出顯示Java版本為11或更高，否則Jenkins可能無法正常啟動。

2. 安裝Jenkins
通過APT倉庫安裝Jenkins，步驟如下：

• 添加Jenkins官方GPG密鑰和軟件源：

  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 > /dev/null
  

• 更新軟件包索引并安裝Jenkins：

  sudo apt update
  sudo apt install -y jenkins
  

• 啟動Jenkins服務并設置開機自啟：

  sudo systemctl start jenkins
  sudo systemctl enable jenkins
  

• 解鎖Jenkins：訪問http://your_server_ip:8080，輸入/var/lib/jenkins/secrets/initialAdminPassword文件中的初始密碼完成解鎖。

3. 安裝Git及必要插件

• 安裝Git：Jenkins需要Git客戶端拉取代碼，執行以下命令安裝：

  sudo apt install -y git
  # 驗證安裝
  git --version
  

• 安裝Jenkins Git插件：
  • 進入Jenkins管理界面（http://your_server_ip:8080），點擊左側Manage Jenkins > Manage Plugins。
  • 切換至Available標簽頁，搜索“Git Plugin”，勾選后點擊Install without restart（若需立即生效，可選擇Restart Jenkins after installation）。
  • （可選）若使用GitHub/GitLab，可額外安裝對應插件（如“GitHub Integration”“GitLab Plugin”），以支持Webhook觸發等功能。

4. 配置Jenkins全局Git工具
為了讓Jenkins識別Git命令，需在全局工具中配置Git路徑：

• 進入Manage Jenkins > Global Tool Configuration。
• 向下滾動至Git section，檢查“Git installations”是否包含系統安裝的Git（通常會自動檢測）。若未檢測到，點擊Add Git，填寫名稱（如“Default Git”），路徑留空（系統會自動查找/usr/bin/git），點擊Save。

5. 創建Jenkins Job并配置Git源碼管理

• 點擊Jenkins主頁New Item，輸入Job名稱（如“my-git-project”），選擇Freestyle project（或Pipeline，后續會介紹），點擊OK。
• 配置Git源碼管理：
  • 在Source Code Management section，選擇Git。
  • 填寫Repository URL（如GitHub倉庫：https://github.com/your_username/your_repo.git或GitLab倉庫：https://gitlab.com/your_username/your_repo.git）。
  • 若倉庫為私有，點擊Credentials，選擇“Add”添加憑據（支持用戶名/密碼或SSH密鑰，推薦使用SSH密鑰避免密碼泄露）。
• 配置構建觸發器（可選，實現自動構建）：
  • 若使用GitHub，可選擇GitHub hook trigger for GITScm polling（需配合Webhook使用）；
  • 若使用GitLab，可選擇Build when a change is pushed to GitLab；
  • 或選擇Poll SCM，設置定時輪詢（如H/5 * * * *表示每5分鐘檢查一次代碼變更）。

6. 配置構建步驟
根據項目需求添加構建步驟，例如：

• Maven項目：在Build section點擊Add build step > Invoke top-level Maven targets，填寫Maven目標（如clean install），并指定Maven路徑（可在Global Tool Configuration中配置）。
• Shell腳本：點擊Add build step > Execute shell，輸入構建命令（如npm install && npm test，適用于Node.js項目）。

7. （可選）配置Webhook實現自動觸發
若需代碼提交后自動觸發Jenkins構建，需在Git倉庫中配置Webhook：

• 進入Git倉庫設置（如GitHub：Settings > Webhooks；GitLab：Settings > Webhooks）。
• 點擊Add webhook，填寫Payload URL（如http://your_server_ip:8080/github-webhook/（GitHub）或http://your_server_ip:8080/gitlab-webhook/（GitLab））。
• 選擇觸發事件（如Push events），點擊Add webhook。
• 此時，每當有代碼推送到倉庫，Jenkins會自動觸發對應Job的構建。

8. 測試集成

• 保存Job配置（點擊Save）。
• 點擊Build Now手動觸發構建，觀察構建狀態（若為藍色則表示成功）。
• 查看構建日志（點擊構建編號進入詳情頁），確認是否成功從Git拉取代碼并執行構建步驟。

補充：使用Pipeline集成Git（進階）
若需更靈活的自動化流程，可使用Jenkins Pipeline（基于Groovy腳本）。步驟如下：

• 創建Pipeline Job（New Item > Pipeline）。
• 在Pipeline section，選擇Definition為“Pipeline script from SCM”，SCM選擇“Git”。
• 填寫Repository URL、Credentials、Branch（如*/main）。
• 在Script Path中指定Pipeline腳本路徑（如Jenkinsfile，需存放在Git倉庫根目錄）。
• 保存配置后，Jenkins會自動從Git拉取Jenkinsfile并執行其中的流水線步驟（如checkout、build、deploy）。