與Jenkins共舞 - 安裝與基本設定(2)

接續前篇文章，筆者已經將Jenkins安裝完成並且可以透過http://localhost來瀏覽Jenkins的管理介面，接下來本篇文章將介紹Jenkins的基本設定。Jenkins的設定頁面可以透過管理介面首頁->Manage Jenkins->Configure System進入或是直接瀏覽http://localhost/configure

以下列出幾個筆者有使用過的設定做說明

• Home directory: Jenkins的安裝目錄，如C:\Program Files (x86)\Jenkins
  
• Workspace Root Directory(點選Advanced按鈕後出現): 原始碼存放路徑，用來儲存Jenkins從版本控制軟體(如Subversion)取下來的原始碼，作為之後編譯程式碼用。它的預設值為${ITEM_ROOTDIR}/workspace，意思是Jenkins會將原始碼放在某個Build Job下的workspace資料夾。例如建立了一個Build Job名為Build001，Jenkins會在home directory下的jobs資料夾中建立一個名為Build001的資料夾，而在Build001中會有一個workspace資料夾用來存放編譯用的原始碼。也就是說，如果你有3個Build Jobs，那就會有三份原始碼被下載放到不同的位置，當然你也可以更改預設值把它設定成固定的路徑如此多個Build Jobs便可共用同一份原始碼
  
  
• Build Record Root Directory(點選Advanced按鈕後出現): 建置結果存放路徑。它的預設值為${ITEM_ROOTDIR}/builds，意思是Jenkins會將編譯原始碼後的結果放在某個Build Job下的builds資料夾。例如建立了一個Build Job名為Build001，Jenkins會在home directory下的jobs資料夾中建立一個名為Build001的資料夾，而在Build001中會有一個builds資料夾用來存放建置原始碼後的結果，建置的結果會以日期為命名方式做儲存如
  
  
• System Message: 管理介面首頁的顯示訊息，可使用HTML，如
  
  
  
  
• System Admin e-mail address: 系統管理者的Email及顯示名稱，如Pete Chen <pete.chen@outlook.com>。當Job建置失敗時，Jenkins可以寄送Email通知相關人員，此時Email的寄件者就會以這裡的設定做為顯示
• Subversion Workspace Version: Subversion的版本，預設為1.4。如果要支援到1.7，則需將Jenkins內建的Subversion Plugin升級到最新的版本。可透過管理介面首頁-> Manage Jenkins-> Manage Plugins-> Updates找到Subversion Plugin，安裝^[註1]後重新啟動^[註2]Jenkins即可。
  
  
• SMTP server: SMTP伺服器位址，如192.168.0.92。當Job建置失敗時，Jenkins可以透過此SMTP伺服器寄送Email通知相關人員。如需對寄送通訊埠、認證、SSL支援功能做進階設定，可按下Advanced按鈕。Jenkins也提供了一個貼心的功能，在做完設定後，可以直接測試是否能正常使用所設定的SMTP伺服器進行Email寄送，只要核取Test configuration by sending test e-mail，輸入收件者Email並按下Test configuration按鈕即可
  
  

備註

1. 筆者在升級Subversion Plugin時出現過plugin安裝失敗的訊息，不過在重新啟動Jenkins後發現這個plugin實際上是有安裝成功，Subversion的版本也可以支援到1.7
2. 如要重新啟動Jenkins，可透過Windows服務管理介面，或是使用RESTful的方式連結至http://localhost/restart重啟Jenkins