Jenkins持續集成

時間 2019-11-16

原文原文鏈接

最近閒來無事，CTO讓我本身折騰下持續集成。因爲公司的項目用maven管理，首先有40來個子插件來構成4套模塊，最後組裝一個完整的項目。我本身折騰了一套jenkins，雖然有點繁瑣，可是仍是搞定了。我本身折騰的jenkins用maven作項目管理，git作版本管理，因爲時間和精力的緣由，這裏就本身截圖而後整理這個東西了。這裏轉載一篇寫的不錯的關於jenkins的文章。原文出處：http://blog.csdn.net/wangmuming/article/details/22925127。感謝做者的無私分享。html

寫的我想吐血，累死了。java

網頁看着不爽的，本身去下載PDF。有問題請留言！git

Jenkins入門系列之——03PDF文檔下載web

第二章 Jenkins安裝與配置

2 Jenkins安裝

在最簡單的狀況下，Jenkins 只須要兩個步驟：apache

1.下載最新的版本（一個 WAR 文件）。Jenkins官方網址: http://Jenkins-ci.org/瀏覽器

2.運行 java -jar jenkins.wartomcat

注意：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權限認證界面

3.2.2.2.2 構建觸發器

在其餘項目構建完成後才執行構建：指定的項目完成構建後，觸發此項目的構建。

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>節點裏添加以下內容：

引號裏的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 控制檯輸出界面