2 Jenkins安裝
在最簡單的情況下,Jenkins 只需要兩個步驟:
1.下載最新的版本(一個 WAR 檔案)。Jenkins官方網址: http://Jenkins-ci.org/
注意:Jenkins 需要執行 Java 5以及以上的版本。
還有一種安裝方式就是將下載的war包檔案部署到 servlet 容器,然後啟動容器,在瀏覽器的URL位址列中輸入類似http://localhost:8080/jenkins/這樣的地址即可。下圖是安裝成功後的介面(使用的是Linux+Tomcat6+Java6環境):
圖2 Jenkins主介面
3 Jenkins配置
寫在配置前的一些話:Jenkins的配置不可能全部都說到的,大部分配置是有英文說明的,點選輸入框後面的問號就可以看見了。英文不會用翻譯工具,連蒙帶猜的,多測試幾次,你就懂了。
3.1 系統管理
在已執行的Jenkins主頁中,點選左側的系統管理進入如下介面:
圖3 Jenkins系統管理
3.1.1 提示資訊
Ps:版本不同提示的訊息有可能不同
3.1.1.1 Utf-8編碼
Your container doesn’t use UTF-8 to decode URLs. If you use non-ASCII characters as a job name etc, this will cause problems. See Containers and Tomcat i18n for more details.
Jenkins建議在tomcat中使用utf-8編碼,配置tomcat下conf目錄的server.xml檔案
圖4 URIEncoding編碼設定
Ps:如果Job的控制檯中文輸出亂碼,請將URIEncoding=”utf-8”更改為useBodyEncodingForURI=”true”
3.1.1.2 新的版本
New version of Jenkins (1.518.JENKINS-14362-jzlib) is available for download (changelog).
提示有新的版本可以下載了,喜歡更新的點選download去下載吧!
3.1.1.3 安全設定
圖5 安全提示訊息
詹金斯允許網路上的任何人代表您啟動程式。考慮至少啟用身份驗證來阻止濫用。點選Dismiss忽略該訊息,點選Setup Security進入設定介面.詳細設定請參考 Configure Global Security(安全設定) 章節
3.1.2 系統設定
在已執行的Jenkins主頁中,點選左側的系統管理—>系統設定進入如下介面:
圖6 系統設定介面
3.1.2.1 JDK、Maven、Ant配置
配置一個JDK、Ant、Maven例項,請在每一節下面單擊Add(新增) 按鈕,這裡將新增例項的名稱和絕對地址。下圖描述了這兩個部分。
圖7 JDK配置介面
JDK別名:給你看的,隨便你自己,叫阿貓阿狗都可以
JAVA_HOME:這個是本機JDK的安裝路徑(錯誤的路徑會有紅字提示你的)
自動安裝:不推薦這個選項
後面Ant與Maven的配置是一樣的,JDK去oracle官網下載,Ant與Maven去apache官網下載
Ps:每個文字框後面都有個問號,點選問號就會出現幫助資訊
3.1.2.2 郵件通知配置
3.1.2.2.1 配置發件人地址
圖8 發件人地址配置介面
System Admin e-mail address:Jenkins郵件傳送地址,如果你這個沒有配置,等著發郵件的時候報錯吧,當時我也是這兒沒有配置,鬱悶了我一週的時間。⊙﹏⊙b汗
3.1.2.2.2 配置郵件通知
圖9 郵件通知
這個就非常的簡單了,根據的的郵箱提供者的引數配置就行了。
Ps:小技巧:使用者預設郵件字尾配置了後,以後你填寫郵件地址只需要@之前的就行了
3.1.2.3 Subversion配置
圖10 Subversion配置
Subversion Workspace Version:Subversion 的版本號,選擇你對應的版本號就行了
3.1.3 Configure Global Security(安全設定)
在已執行的Jenkins主頁中,點選左側的系統管理—>Configure Global Security進入如下介面:
圖11 安全設定介面
設定如上圖,儲存後系統管理中就出現管理使用者的選項。頁面右上角也會出現登入/註冊的選項。
3.1.4 管理使用者設定
在右上角點選註冊
圖12 註冊使用者介面
點選sign up按鈕,提示你現在已經登入.返回首頁.
登入後和匿名賬號看到的首頁有幾點不同,如下圖紅框所示:
圖13 使用者登入介面
3.1.5 管理外掛設定
建議先閱讀Jenkins外掛章節,在回來安裝如下所示的外掛。這個外掛將生成的構件(war或者ear)部署到主流的伺服器上。
外掛名稱:Deploy Plugin
外掛介紹:This plugin takes a war/ear file and deploys that to a running remote application server at the end of a build
3.2 專案構建設定
3.2.1 構建自由風格的Job
3.2.1.1 新建自由風格構建任務
在已執行的Jenkins主頁中,點選左側的新建Job進入如下介面:
圖14 新建Job介面
這時,需要為新的構建任務指定一個名稱。(這裡輸入的任務名稱為:Ant_test)這裡有幾種的任務型別可供選擇,鑑於初步介紹,先選擇構建一個自由風格的軟體專案。對於其他的型別,經常使用的是拷貝已存在任務;這主要為了能在現有的任務基礎上新建任務。點選OK按鈕,
3.2.1.2 構建任務配置
3.2.1.2.1 原始碼管理配置
演示是使用Subversion的連結,在Repository URL中輸入你的專案連結,如果沒有許可權則會提示如下圖:
圖15 Subversion配置介面
點選 enter credential 輸入使用者名稱和密碼(我猜大家一般都是使用的使用者名稱和密碼登陸的)
圖16 Subversion許可權認證介面
Ps:svn的使用者名稱和密碼設定了是沒有辦法在web介面修改的。如果要修改則先去Jenkins目錄刪除hudson.scm.SubversionSCM.xml檔案(點到為止,畢竟這只是入門教程)
3.2.1.2.2 構建觸發器
在其他專案構建完成後才執行構建:指定的專案完成構建後,觸發此專案的構建。
Poll SCM :這是CI 系統中常見的選項。當您選擇此選項,您可以指定一個定時作業表示式來定義Jenkins每隔多久檢查一下您源程式碼倉庫的變化。如果發現變化,就執行一次構建。例如,表示式中填寫0,15,30,45 * * * *將使Jenkins每隔15分鐘就檢查一次您原始碼倉庫的變化。
Build periodically :此選項僅僅通知Jenkins按指定的頻率對專案進行構建,而不管SCM是否有變化。如果想在這個Job中執行一些測試用例的話,它就很有幫助。
3.2.1.2.3 Ant構建配置
因為我的專案是用ant指令碼實現的編譯和打包,所以我選擇的是Invoke Ant,Ant Version選擇你Ant配置的那個名字,注意不要選擇default喔,那個選擇了沒有用。
圖17 Ant構建配置介面
如果你的構建指令碼build.xml不在workspace根目錄、或者說你的構建指令碼不叫build.xml。那麼需要在高階裡設定Build File選項的路徑,指明你的指令碼。注意:是相對路徑
部署請參考:war檔案部署章節
3.2.2 構建Maven風格的Job
3.2.2.1 新建Maven構建任務
圖18 新建Job介面
這時,需要為新的構建任務指定一個名稱。(這裡輸入的任務名稱為:maven_test)這裡有幾種的任務型別可供選擇,鑑於初步介紹,先選擇構建一個maven2/3專案。對於其他的型別,經常使用的是拷貝已存在任務;這主要為了能在現有的任務基礎上新建任務。點選OK按鈕,
3.2.2.2 構建任務配置
圖19 構建任務配置介面
3.2.2.2.1 原始碼管理配置
演示是使用Subversion的連結,在Repository URL中輸入你的專案連結,如果沒有許可權則會提示如下圖:
圖20 Subversion配置介面
點選 enter credential 輸入使用者名稱和密碼(我猜大家一般都是使用的使用者名稱和密碼登陸的)
圖21 Subversion許可權認證介面
Ps:svn的使用者名稱和密碼設定了是沒有辦法在web介面修改的。如果要修改則先去Jenkins目錄刪除hudson.scm.SubversionSCM.xml檔案(點到為止,畢竟這只是入門教程)
3.2.2.2.2 構建觸發器
在其他專案構建完成後才執行構建:指定的專案完成構建後,觸發此專案的構建。
Poll SCM :這是CI 系統中常見的選項。當您選擇此選項,您可以指定一個定時作業表示式來定義Jenkins每隔多久檢查一下您原始碼倉庫的變化。如果發現變化,就執行一次構建。例如,表示式中填寫0,15,30,45 * * * *將使Jenkins每隔15分鐘就檢查一次您原始碼倉庫的變化。
Build periodically :此選項僅僅通知Jenkins按指定的頻率對專案進行構建,而不管SCM是否有變化。如果想在這個Job中執行一些測試用例的話,它就很有幫助。
3.2.2.2.3 Maven構建設定
圖22 Maven構建配置介面
2013-08-22補充Goals and options :clean install -Dmaven.test.skip=true #加入了跳過測試的程式碼
Root POM:填寫你專案的pom.xml檔案的位置,注意:是相對位置,如果該檔案不存在,會有紅色字提示。
部署請參考:war檔案部署章節
3.2.2.2.4 構建maven專案的心得
使用Jenkins構建maven專案的一點小心得:
maven專案的構建是比較麻煩的,如果你的專案是下圖這種結構。那麼恭喜你!你新建一個job就可以了,因為只有一個根。如果你的svn地址是:https://192.xxx/Pe_Project/root-pom,那麼Root POM只需要保持預設就行了,因為Jenkins可以再workspace目錄下面找到pom.xml檔案
如果你的svn地址是:https://192.xxx/Pe_Project,那麼Root POM需要指定為root-pom/pom.xml,因為Jenkins可以再workspace/root-pom目錄下面找到pom.xml檔案
圖23 Maven專案結構介面1
上面這種方法打包的時候非常簡單,但是用eclipse開發的時候你就不右鍵run as —>tomca啟動了,如果你想使用這種方式,將tomcat換成jetty即可。
如果你的專案是下圖這種結構,那麼非常悲劇的告訴你,你要建立好幾個job來構建這一個專案,因為這個專案有4個根。
圖24 Maven專案結構介面2
上面這種方法打包的時候比較麻煩,但是用eclipse開發的時候你就可以使用右鍵run as —>tomca啟動了
3.2.3 郵件通知設定
圖25 構建後操作介面
選擇Add post-build action,然後選擇E-mail Notification,如下圖:
圖26 收件人列表介面
在Recipients中輸入收件人郵件地址,如果用多個收件人用“,”英文逗號隔開
3.2.4 War檔案部署設定
首先你必須安裝好Deploy Plugin外掛,然後在tomcat的conf目錄配置tomcat-users.xml檔案,在<tomcat-users>節點裡新增如下內容:
<role rolename=”manager-gui”/>
<role rolename=”manager-script”/>
<role rolename=”manager-jmx”/>
<role rolename=”manager-status”/>
<user username=”username” password=”password” roles=”manager-gui,manager-script,manager-jmx,manager-status”/>
引號裡的username和password可以隨便替換,待會要用的。
好了,回到Jenkins專案配置頁面:
圖27 構建後操作介面
選擇Add post-build action,然後選擇Deploy war/ear to a container,如下圖:
圖28 遠端部署配置介面
WAR/EAR files:war檔案的存放位置,如:target/test.war 注意:相對路徑,target前是沒有/的。
Context path:訪問時需要輸入的內容,如ofCard訪問時如下:http://192.168.x.x:8080/ofCard/如果為空,預設是war包的名字。
Container:選擇你的web容器,如tomca 6.x
Manager user name:填入tomcat-users.xml配置的username內容
Manager password:填入tomcat-users.xml配置的password內容
Tomcat URL:填入http://192.168.x.x:8080/
Deploy on failure:構建失敗依然部署,一般不選擇
注意:雖然這種部署方法可能會導致tomcat載入時出現卡死的現象。但是也是最簡單的部署方式。如果卡死了重啟下就好了,將tomcat的java記憶體引數調高可以解決這個問題。
最後不要忘記點選儲存喔。
好了!到此一個專案的獲取原始碼,打包,遠端部署,郵件通知就完成了。
3.3 監控
當任務一旦執行,您將會看到這個任務正在佇列中的儀表板和當前工作主頁上執行。這兩種顯示如下。
圖29 主頁監控(左),專案監控(右)
一旦構建完成後,完成後的任務將會有三個地方進行顯示。
你可以在Jenkins的控制皮膚上看到它,如下圖。
圖30 主頁專案介面
在上面展示的截圖中,您將注意到有兩個圖示描述當前作業的狀態。S欄目代表著“最新構建狀態”,W欄目代表著“構建穩定性”。Jenkins使用這兩個概念來介紹一個作業的總體狀況:
構建狀態:下圖中分級符號概述了一個Job新近一次構建會產生的四種可能的狀態:
Successful:完成構建,且被認為是穩定的。
Unstable:完成構建,但被認為不穩定。
Failed:構建失敗。
Disabled:構建已禁用。
圖31 構建狀態介面
構建穩定性: 當一個Job中構建已完成並生成了一個未釋出的目標構件,如果您準備評估此次構建的穩定性,Jenkins會基於一些後處理器任務為構建釋出一個穩健指數 (從0-100 ),這些任務一般以外掛的方式實現。它們可能包括單元測試(JUnit)、覆蓋率(Cobertura )和靜態程式碼分析(FindBugs)。分數越高,表明構建越穩定。下圖中分級符號概述了穩定性的評分範圍。任何構建作業的狀態(總分100)低於80分就是不穩定的。
圖32 構建穩定性介面
你也可以在當前Job主介面上看到它,如下圖左下部分
圖33 專案主介面
當前作業主頁上還包含了一些有趣的條目。左側欄的連結主要控制Job的配置、刪除作業、構建作業。右邊部分的連結指向最新的專案報告和構件。
通過點選構建歷史(Build History)中某個具體的構建連結,您就能跳轉到Jenkins為這個構建例項而建立的構建主頁上。如下圖
圖34 構建歷史介面
如果你想通過檢視輸出介面來監控當前任務的進展情況。你可以單擊Console Output(控制檯輸出)。如果工作已完成,這將顯示構建指令碼產生的靜態輸出;如果作業仍然在執行中,Jenkins將不斷重新整理網頁的內容,以便您可以看到它執行時的輸出。如下圖:
圖35 控制檯輸出介面
4 Jenkins外掛
從Jenkins現有的功能擴充套件或開發者們為Jenkins提供的新功能都可以稱之為Jenkins外掛。有些外掛可以無縫新增到您的構建過程,而其它,諸如除CVS和Subversion的SCM外掛則需要原始碼控制系統的支援。
4.1 Jenkins外掛安裝
Jenkins 外掛管理器允許您安裝新的外掛,和更新您Jenkins伺服器上的外掛。管理者將連線到聯機資料庫,檢索可用的和已更新的外掛。如果您的Jenkins伺服器 無法直接連線到外部資源,您可以從Jenkins網站上下載。
在已執行的Jenkins主頁中,點選左側的系統管理—>管理外掛進入如下介面:
圖36 外掛管理介面
它包含四個標籤:
更新:清單中列示了Jenkins為某些外掛搜尋到了可用的更新。列出的每個外掛可以被選擇並應用更新。
可選安裝:清單中列示了可用於安裝(而不是目前已安裝的)的所有外掛。列出的每個外掛都可以被選擇並安裝。
已安裝:清單中列示了已經安裝的外掛。
高階:允許您通過設定HTTP代理的方式使Jenkins與線上外掛庫建立連線。此外,還提供了一個上傳裝置,可以安裝你在Jenkins以外已下載的那些外掛。
由上圖可知,Jenkins預設整合了maven2外掛,並且一旦外掛有新版本,會提示更新新版本外掛。
如果想安裝新的外掛,可以點選tab分頁中的可選外掛。如下圖:
圖37 可選外掛介面
從圖可知,各種Jenkins外掛根據之前所記述的型別進行分門別類。可勾選任意想安裝的Jenkins外掛,點選Install without restart按鈕進行安裝。安裝後,所有外掛以hpi作為字尾名放置在plugins資料夾下。如果是高階使用者還可以自行開發外掛方便具體專案使用。
注意:安裝完成後需要重啟Jenkins部署的容器。這樣才能使用新裝的外掛。
4.2 Jenkins外掛安裝示例
Jenkins執行自動部署war包到servlet容器內,要實現這個功能必須安裝一個外掛。
圖38 安裝外掛介面
圖39 外掛安裝介面
好了,到此Deploy Plugin外掛安裝完成!
最後,如果感覺我太囉嗦了去看這篇吧:
http://www.cnblogs.com/gao241/archive/2013/04/08/3008380.html