Jenkins外掛程式管理與疑難排解

– 10 分鐘閱讀

在 CI/CD 流程中，Jenkins 扮演著重要的自動化角色，而外掛程式則賦予 Jenkins 更多彈性與功能。管理 Jenkins 外掛程式，包含安裝、更新、解除安裝等，是確保 Jenkins 環境穩定且有效率的關鍵。本文將深入探討如何有效管理 Jenkins 外掛程式，並提供一些常見問題的解決方案，例如網路連線問題、憑證錯誤和版本不相容等。此外，我們也會探討如何設定代理伺服器，讓 Jenkins 在受限網路環境中也能正常運作，並說明如何組態 JDK 和 Maven 等全域性工具，以滿足不同專案的建置需求。

Jenkins外掛程式管理

安裝外掛程式

Jenkins的安裝外掛程式頁面顯示了您Jenkins伺服器中安裝的所有外掛程式清單，包括每個外掛程式的版本號碼。若要解除安裝現有的外掛程式，請在安裝外掛程式頁面中搜尋要解除安裝的外掛程式，然後勾選該外掛程式的核取方塊，最後按下解除安裝按鈕。您也可以透過從JENKINS_HOME/plugins目錄中刪除.hpi檔案來解除安裝外掛程式。

停用外掛程式是退役外掛程式的一種方式。Jenkins會將外掛程式視為已安裝，但不會啟動它或載入它所提供的任何擴充功能。要停用外掛程式，請在管理Jenkins頁面的安裝外掛程式頁面中取消勾選該外掛程式的核取方塊。

進階設定

通常，網際網路存取是透過代理伺服器進行控制的。當代理伺服器組態時，機器無法直接發出網際網路請求。網際網路請求應該傳送到代理伺服器，然後才能到達網際網路。如果您的組織有代理伺服器，Jenkins無法存取網際網路，這意味著無法下載原始碼，也無法從更新中心下載Jenkins外掛程式。您需要在Jenkins中組態代理設定，以便在代理後面執行Jenkins。

您需要向IT部門詢問代理伺服器的詳細資訊，然後在HTTP代理組態部分（見圖5-4）中組態這些詳細資訊。

HTTP代理組態

讓我們逐一檢視此部分的不同欄位：

  • 伺服器：在伺服器欄位中輸入您的代理伺服器的IP地址。
  • 埠：輸入代理伺服器機器的埠號。
  • 使用者名稱：如果代理伺服器啟用了身份驗證，請在使用者名稱欄位中輸入憑據的使用者名稱。如果沒有啟用身份驗證，請保持此欄位空白。
  • 密碼：如果代理伺服器啟用了身份驗證，請在密碼欄位中輸入憑據的密碼。如果沒有啟用身份驗證，請保持此欄位空白。
  • 不代理主機：指定不應透過代理伺服器存取的IP地址或主機名稱模式。此設定用於指定可以直接存取（無需透過代理伺服器）的伺服器。

輸入所有必要詳細資訊後，按下提交按鈕。

圖表翻譯：

此圖表展示了組態Jenkins中的代理伺服器的步驟。首先，您需要開始組態代理伺服器，然後輸入代理伺服器的詳細資訊，包括IP地址、埠號、使用者名稱和密碼等。輸入所有必要資訊後，提交組態並測試連線，以確保代理伺服器組態正確。

內容解密：

上述程式碼展示瞭如何組態Jenkins中的代理伺服器。首先，您需要輸入代理伺服器的IP地址和埠號，然後輸入使用者名稱和密碼。如果代理伺服器啟用了身份驗證，您需要輸入正確的憑據。最後，提交組態並測試連線，以確保代理伺服器組態正確。

Jenkins外掛程式管理與更新

Jenkins外掛程式的管理是Jenkins功能強大的關鍵之一。透過外掛程式，可以擴充套件Jenkins的功能，提高工作效率。然而，在安裝和更新外掛程式的過程中，可能會遇到一些問題。在本章中，我們將探討如何管理Jenkins外掛程式、如何更新外掛程式，以及如何解決安裝過程中遇到的常見問題。

下載和安裝特定版本的外掛程式

在某些情況下，您可能需要安裝特定版本的外掛程式。這時，您可以手動下載外掛程式的.HPI檔案，並透過Jenkins的管理介面進行安裝。以下是步驟：

  1. 下載所需版本的外掛程式.HPI檔案。
  2. 進入Jenkins管理介面，點選「管理Jenkins」＞「管理外掛程式」。
  3. 點選「高階」標籤，然後點選「上傳」按鈕。
  4. 選擇下載的.HPI檔案，然後點選「上傳」按鈕。

解決安裝問題

在安裝Jenkins外掛程式的過程中，可能會遇到一些問題。以下是其中一些常見問題及其解決方法：

問題1：外掛程式安裝失敗

錯誤訊息：下載的檔案/var/lib/jenkins/plugins/不匹配預期的SHA-1值。

原因：Jenkins更新中心與Jenkins伺服器之間的同步問題。

解決方法：

  1. 進入Jenkins管理介面，點選「管理Jenkins」＞「管理外掛程式」。
  2. 點選「高階」標籤，然後滾動到「更新站點」部分。
  3. 點選「立即檢查」按鈕，以同步Jenkins伺服器與更新中心。
  4. 重新啟動Jenkins伺服器，然後嘗試再次安裝外掛程式。

問題2：代理伺服器設定問題

如果您正在代理伺服器後面執行Jenkins，您需要組態代理伺服器設定。

解決方法：

  1. 進入Jenkins管理介面，點選「管理Jenkins」＞「管理外掛程式」。
  2. 點選「高階」標籤，然後滾動到「代理設定」部分。
  3. 如果代理伺服器沒有設定身份驗證，請留空使用者名稱和密碼欄位。
  4. 點選「高階」按鈕，輸入Jenkins更新中心的URL到「測試URL」欄位，然後點選「驗證代理」按鈕。
  5. 成功驗證代理伺服器後，點選「提交」按鈕。
內容解密：

以上步驟和方法都是根據實際經驗和技術知識總結出來的。透過這些步驟和方法，您可以更好地管理您的Jenkins伺服器，提高工作效率。同時，瞭解如何解決安裝問題，可以幫助您快速地解決可能遇到的問題，從而提高您的工作效率。

@startuml
skinparam backgroundColor #FEFEFE

title Jenkins外掛程式管理與疑難排解

|開發者|
start
:提交程式碼;
:推送到 Git;

|CI 系統|
:觸發建置;
:執行單元測試;
:程式碼品質檢查;

if (測試通過?) then (是)
    :建置容器映像;
    :推送到 Registry;
else (否)
    :通知開發者;
    stop
endif

|CD 系統|
:部署到測試環境;
:執行整合測試;

if (驗證通過?) then (是)
    :部署到生產環境;
    :健康檢查;
    :完成部署;
else (否)
    :回滾變更;
endif

stop

@enduml

圖表翻譯：

此圖表展示了安裝Jenkins外掛程式的流程。首先，下載所需版本的.HPI檔案。然後，上傳.HPI檔案到Jenkins伺服器。接下來，安裝外掛程式。如果遇到安裝問題，則需要解決問題。可能需要組態代理伺服器設定，並同步Jenkins伺服器與更新中心。最後，重新啟動Jenkins伺服器，以確保外掛程式正確安裝和執行。

解決Jenkins外掛安裝錯誤

在安裝Jenkins外掛的過程中，可能會遇到一些錯誤。其中一個常見的錯誤是sun.security.provider.certpath.SunCertPathBuilderException，這個錯誤通常是由於Jenkins Update Center URL設定為HTTPS URL，而JDK缺乏對應的安全證書所致。

錯誤原因

JDK內建了一份可信任的證書授權機構（CA）證書列表，存放在cacerts檔案中。然而，這份列表可能不包含最新的安全證書，導致Jenkins無法驗證Update Center URL的身份。

解決方案

有三種方法可以解決這個問題：

方法1：修改Update Center URL

  1. 進入Jenkins管理介面，選擇「Manage Jenkins」＞「Manage Plugins」。
  2. 切換到「Advanced」標籤。
  3. 滾動到頁面底部，找到「Update Site」區段。
  4. 修改Update Center URL為HTTP協定（例如，將https://改為http://）。
  5. 嘗試重新安裝外掛。

方法2：更新Java版本

  1. 下載並安裝最新版本的Java。
  2. 將最新安裝的Java的bin目錄新增到系統的PATH環境變數中。
  3. 儲存環境變數修改並重新啟動Jenkins伺服器。
  4. 嘗試重新安裝外掛。

注意：如果您更新Java版本為非1.8或1.11版本，啟動Jenkins伺服器時需要新增--enable-future-java旗標。例如，啟動Jenkins的命令為java -jar D:\Jenkins\Jenkins.war --enable-future-java。

方法3：使用最新Java版本啟動Jenkins

  1. 安裝最新版本的Java。
  2. 開啟命令提示符，切換到最新Java版本的安裝目錄下的lib\security目錄。
  3. 啟動Jenkins伺服器使用最新Java版本。

例如，如果您已經安裝了JDK 15，則可以在命令提示符中切換到D:\JDK15\jdk-15.0.2\lib\security目錄，並啟動Jenkins伺服器。

管理Jenkins外掛

在Jenkins中，外掛是擴充套件其功能的重要組成部分。透過外掛，Jenkins可以支援更多的工具和技術，從而提高其適用性和靈活性。然而，管理外掛可能會遇到一些問題，例如安裝失敗或版本不相容等。在本章中，我們將討論如何使用Jenkins的外掛管理器來安裝、更新和解除安裝外掛，並且提供了一些解決常見問題的方法。

安裝外掛

要安裝一個外掛，首先需要進入Jenkins的管理介面。登入Jenkins後，點選左側選單中的「管理Jenkins」，然後選擇「管理外掛」。在外掛管理頁面中，可以搜尋和選擇要安裝的外掛。安裝過程通常需要重新啟動Jenkins服務。

更新外掛

當外掛有新的版本時，Jenkins會在管理介面中提示更新。更新外掛的步驟與安裝類別似，點選「更新」按鈕即可開始更新過程。

解除安裝外掛

如果某個外掛不再需要，可以透過解除安裝它來移除。選擇要解除安裝的外掛，然後點選「解除安裝」按鈕。解除安裝後，重新啟動Jenkins服務以確保變化生效。

解決安裝問題

在安裝外掛時，可能會遇到一些問題，例如Java版本不相容等。為瞭解決這些問題，可以嘗試以下方法：

  1. 檢查Java版本：確保Jenkins執行的Java版本與外掛要求相符。
  2. 更新Jenkins：確保Jenkins是最新版本，因為新版本可能已經解決了一些已知問題。
  3. 重新啟動Jenkins：有時，重新啟動Jenkins服務可以解決一些暫時性的問題。

全域性工具組態

除了管理外掛外，Jenkins還提供了一個全域性工具組態頁面，用於組態如Java、Maven、Git等工具。這些工具對於專案的構建和佈署是非常重要的。

組態JDK

  1. 登入Jenkins，進入管理介面。
  2. 點選「全域性工具組態」。
  3. 在JDK組態部分，點選「新增JDK」。
  4. 選擇JDK版本，填寫名稱和路徑，然後儲存。

組態Maven

  1. 登入Jenkins，進入管理介面。
  2. 點選「全域性工具組態」。
  3. 在Maven組態部分，點選「新增Maven」。
  4. 選擇Maven版本，填寫名稱和路徑，然後儲存。

從技術架構視角來看，Jenkins 外掛程式管理機制是其高度可擴充套件性和靈活性的根本。本文深入探討了外掛程式的安裝、更新、解除安裝，以及代理設定、版本相容性等關鍵議題，並提供了詳盡的解決方案，涵蓋了從修改 Update Center URL、更新 Java 版本到組態全域性工具等多個層面。

分析顯示，雖然外掛程式機制賦予 Jenkins 強大的功能，但也引入了潛在的複雜性。版本不相容、代理設定錯誤、證書問題等都可能導致外掛程式安裝失敗，影響 CI/CD 流程的順暢執行。技術團隊需要重視這些挑戰，並採取積極的預防和解決措施，例如定期檢查外掛程式更新、組態正確的代理設定、以及採用穩定的 Java 版本。此外，善用 Jenkins 的全域性工具組態功能，可以有效地管理專案所需的各種工具，確保構建環境的一致性和穩定性。

展望未來，隨著雲原生技術的普及，Jenkins 外掛程式生態系統將持續發展，更多根據容器化和微服務架構的外掛程式將湧現。同時，Jenkins 的外掛程式管理機制也將不斷演進，提供更便捷、更安全的管理方式，例如自動化的版本管理和相容性檢查。

玄貓認為，掌握 Jenkins 外掛程式管理的最佳實務，對於提升 CI/CD 效率至關重要。技術團隊應積極探索新的外掛程式和管理策略，並將其融入到實際工作流程中，才能充分發揮 Jenkins 的強大功能，打造高效、穩定的自動化交付Pipeline。

玄貓 BlackCat

玄貓 BlackCat

技術愛好者，專注於分享程式開發、雲端技術與 AI 應用的心得體會。