January 13, 2013

與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

No comments: