如何更改 Jenkins 主目錄？

---

簡介

Jenkins 是一款流行的自動化伺服器，可幫助自動化軟體開發過程中的任務。Jenkins 主目錄，也稱為 JENKINS_HOME，是儲存所有配置檔案、外掛和其他重要檔案的位置。

此目錄在維護 Jenkins 環境的穩定性和效能方面發揮著重要作用。但是，在某些情況下，您可能需要更改 Jenkins 主目錄位置。

準備更改 Jenkins 主目錄

瞭解當前 Jenkins 主目錄位置

在更改 Jenkins 主目錄之前，瞭解其當前位置非常重要。這可以在 Jenkins 配置檔案中找到。

要找到此檔案，請導航到您的當前主目錄並查詢名為“.jenkins”的資料夾。配置檔案位於此資料夾中，名為“config.xml”。

使用文字編輯器開啟檔案，並搜尋讀取“ ”的行。此行後面的路徑顯示您當前 Jenkins 主目錄的位置。

為新的 Jenkins 主目錄位置建立新目錄

確定當前 Jenkins 主目錄的位置後，就可以為新位置建立一個新目錄。此目錄應在具有足夠儲存空間以容納所有資料的位置建立。

建議在任何使用者特定目錄（例如 /home/username/ 或 /Users/username/）之外建立此目錄，因為這些目錄以後可能會導致許可權問題。要建立新目錄，請開啟您的終端或命令提示符並導航到要建立它的位置。

然後使用 mkdir 命令後跟所需的新目錄名稱。例如，如果您想將新目錄命名為“jenkins_home_v2”，則可以使用以下命令 -

mkdir jenkins_home_v2  

現在您已經建立了一個新目錄，是時候將所有資料從當前 Jenkins 主目錄移動到此新位置了。

更改 Jenkins 主目錄位置

停止 Jenkins 服務

更改 Jenkins 主目錄位置的第一步是停止 Jenkins 服務。這很重要，因為您無法在正在執行的應用程式正在使用檔案時移動檔案。要停止服務，請導航到您的終端或命令提示符並輸入：“sudo systemctl stop jenkins.service”（對於 Linux 系統）或“net stop jenkins”（對於 Windows 系統）。

sudo systemctl stop jenkins.service

將當前 Jenkins 主目錄的內容移動到新目錄

停止 Jenkins 服務後，您現在可以將其所有內容移動到新目錄。這包括作業、構建、外掛和其他配置檔案。

最簡單的方法是使用檔案管理器（如 Windows 系統上的“FileZilla”或“WinSCP”）或 Linux 系統上的“rsync”命令。確保所有檔案都已完全移動，然後再繼續執行下一步。

使用新位置資訊更新配置檔案

更改 Jenkins 主目錄位置的最後一步是使用新位置資訊更新其配置檔案。配置檔案可以在 Linux 系統上的 /etc/default/jenkins 和 Windows 系統上的 C:\Program Files (x86)\Jenkins\jenkins.xml 中找到。

$ sudo vim /etc/default/jenkins

使用文字編輯器（如 Notepad++ 或 Vim）開啟它，並找到指向舊主目錄的 JENKINS_HOME 變數。將其替換為您新主目錄的絕對路徑，例如“/var/lib/jenkins/new_home_directory”。

JENKINS_HOME /var/lib/jenkins/new_home_directory

儲存並關閉配置。仔細遵循這些步驟，您就可以立即成功更改 Jenkins 主目錄位置！

驗證並重新啟動 Jenkins 服務

更改 Jenkins 主目錄位置後，必須驗證所有檔案是否已成功移動到新目錄。第一步是停止 Jenkins 服務。

這可以透過導航到命令列介面並輸入命令“sudo systemctl stop jenkins”來完成。服務停止後，導航到新的 Jenkins 主目錄位置並驗證所有檔案是否已成功移動。這可以透過檢查特定檔案（如 config.xml 或 jobs 目錄）來完成。

sudo systemctl stop jenkins

檢查所有檔案是否已成功移動到新目錄

更改 Jenkins 主目錄中最關鍵的步驟之一是確保所有檔案都已成功移動到新目錄。務必仔細檢查任何自定義外掛或配置是否位於新目錄中的正確位置。此外，請確保之前在舊目錄下建立的任何作業或專案現在都可以在其新的檔案路徑下訪問。

使用更新的配置檔案啟動 Jenkins 服務

驗證所有檔案都已正確移動後，就可以使用更新的配置檔案（引用其新的主目錄位置）啟動 Jenkins 服務了。準備好後，導航回命令列介面視窗並輸入“sudo systemctl start jenkins”以啟動此最後一步。更新的配置檔案應確保在啟動期間不會出現任何問題，但如果您在此處遇到問題，則可能需要再次檢查日誌和/或配置設定，以查詢路徑引用錯誤和其他潛在的複雜情況。

成功完成這些最後步驟後，恭喜！您新更改的 Jenkins 主目錄現在應該可以完全正常執行，並且可以恢復對產品管道或工作流系統的所有可持續元件的訪問！

更改 Jenkins 主目錄位置後常見問題的故障排除

Jenkins 服務啟動失敗

移動 Jenkins 主目錄後，使用者遇到的一個常見問題是 Jenkins 服務啟動失敗。此問題可能是由不正確的配置或許可權設定引起的。

要解決此問題，首先檢查新目錄位置中所有檔案許可權是否已正確設定。確保所有檔案和目錄都由執行 Jenkins 服務的使用者擁有。

此外，驗證新主目錄中 Java 的路徑是否正確。如果所有設定都正確，請嘗試重新啟動計算機並再次啟動 Jenkins 服務。

作業未顯示或執行

重新定位 Jenkins 主目錄後，使用者面臨的另一個典型問題是作業未在儀表板上顯示或無法正確執行。這可能是由於檔案許可權問題以及配置錯誤造成的。確保每個作業的配置都指向其在新主目錄中的正確工作區位置；您可以在“高階專案選項”下檢查每個作業的配置頁面。如果作業工作區未更新以反映其新位置，則它們可能無法正常執行或顯示在儀表板上。

無效的外掛安裝

當外掛未在新重新定位的主目錄位置正確安裝時，使用者在嘗試安裝新外掛或更新已安裝的外掛時，可能會在儀表板上收到無效的外掛安裝錯誤訊息。解決此問題的一種方法是在將它們移動到新主目錄中的新建立的資料夾 /new/home/directory/plugins/ 之前，先刪除舊目錄中的所有現有外掛檔案和資料夾。將所有外掛移動到此資料夾後，重新啟動 Jenkins 以使其能夠從頭開始檢測並安裝所有有效的外掛。

結論

在本文中，我們介紹了更改 Jenkins 主目錄的重要性。隨著組織的增長和需求的變化，您可能需要更改 Jenkins 主目錄的位置。

您可能還想將 Jenkins 安裝移動到另一臺伺服器或將其升級到新版本。無論出於何種原因，制定計劃以確保流程順利進行都至關重要。