1. 程式人生 > >Jenkins入門系列之—— Jenkins安裝與配置

Jenkins入門系列之—— Jenkins安裝與配置

1.下載最新的版本(一個 WAR 檔案)。Jenkins官方網址: http://Jenkins-ci.org/ 2.執行 java -jar jenkins.war 注意:Jenkins 需要執行 Java 5以及以上的版本。 還有一種安裝方式就是將下載的war包檔案部署到 servlet 容器,然後啟動容器,在瀏覽器的URL位址列中輸入類似http://localhost:8080/jenkins/這樣的地址即可。下圖是安裝成功後的介面(使用的是Linux+Tomcat6+Java6環境): 圖2 Jenkins主介面 寫在配置前的一些話:Jenkins的配置不可能全部都說到的,大部分配置是有英文說明的,點選輸入框後面的問號就可以看見了。英文不會用翻譯工具,連蒙帶猜的,多測試幾次,你就懂了。 在已執行的Jenkins主頁中,點選左側的系統管理進入如下介面: 圖3 Jenkins系統管理 Ps:版本不同提示的訊息有可能不同 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" New version of Jenkins (1.518.JENKINS-14362-jzlib) is available for download (changelog). 提示有新的版本可以下載了,喜歡更新的點選download去下載吧! 圖5 安全提示訊息 詹金斯允許網路上的任何人代表您啟動程序。考慮至少啟用身份驗證來阻止濫用。點選Dismiss忽略該訊息,點選Setup Security進入設定介面.詳細設定請參考 Configure Global Security(安全設定) 章節 在已執行的Jenkins主頁中,點選左側的系統管理—>系統設定進入如下介面:
圖6 系統設定介面 配置一個JDK、Ant、Maven例項,請在每一節下面單擊Add(新增) 按鈕,這裡將新增例項的名稱和絕對地址。下圖描述了這兩個部分。 圖7 JDK配置介面 JDK別名:給你看的,隨便你自己,叫阿貓阿狗都可以 JAVA_HOME:這個是本機JDK的安裝路徑(錯誤的路徑會有紅字提示你的) 自動安裝:不推薦這個選項 後面Ant與Maven的配置是一樣的,JDK去oracle官網下載,Ant與Maven去apache官網下載 Ps:每個文字框後面都有個問號,點選問號就會出現幫助資訊 圖8 發件人地址配置介面 System Admin e-mail address:Jenkins郵件傳送地址,如果你這個沒有配置,等著發郵件的時候報錯吧,當時我也是這兒沒有配置,鬱悶了我一週的時間。⊙﹏⊙b汗
圖9 郵件通知 這個就非常的簡單了,根據的的郵箱提供者的引數配置就行了。 Ps:小技巧:使用者預設郵件字尾配置了後,以後你填寫郵件地址只需要@之前的就行了 圖10 Subversion配置 Subversion Workspace Version:Subversion 的版本號,選擇你對應的版本號就行了 在已執行的Jenkins主頁中,點選左側的系統管理—>Configure Global Security進入如下介面: 圖11 安全設定介面 設定如上圖,儲存後系統管理中就出現管理使用者的選項。頁面右上角也會出現登入/註冊的選項。 在右上角點選註冊 圖12 註冊使用者介面 點選sign up按鈕,提示你現在已經登入.返回首頁. 登入後和匿名賬號看到的首頁有幾點不同,如下圖紅框所示:
圖13 使用者登入介面 建議先閱讀Jenkins外掛章節,在回來安裝如下所示的外掛。這個外掛將生成的構件(war或者ear)部署到主流的伺服器上。 外掛名稱:Deploy Plugi 外掛介紹:This plugin takes a war/ear file and deploys that to a running remote application server at the end of a build 在已執行的Jenkins主頁中,點選左側的新建Job進入如下介面: 圖14 新建Job介面 這時,需要為新的構建任務指定一個名稱。(這裡輸入的任務名稱為:Ant_test)這裡有幾種的任務型別可供選擇,鑑於初步介紹,先選擇構建一個自由風格的軟體專案。對於其他的型別,經常使用的是拷貝已存在任務;這主要為了能在現有的任務基礎上新建任務。點選OK按鈕, 演示是使用Subversion的連結,在Repository URL中輸入你的專案連結,如果沒有許可權則會提示如下圖: 圖15 Subversion配置介面 點選 enter credential 輸入使用者名稱和密碼(我猜大家一般都是使用的使用者名稱和密碼登陸的) 圖16 Subversion許可權認證介面 Ps:svn的使用者名稱和密碼設定了是沒有辦法在web介面修改的。如果要修改則先去Jenkins目錄刪除hudson.scm.SubversionSCM.xml檔案(點到為止,畢竟這只是入門教程) 在其他專案構建完成後才執行構建:指定的專案完成構建後,觸發此專案的構建。 Poll SCM :這是CI 系統中常見的選項。當您選擇此選項,您可以指定一個定時作業表示式來定義Jenkins每隔多久檢查一下您原始碼倉庫的變化。如果發現變化,就執行一次構建。例如,表示式中填寫0,15,30,45 * * * *將使Jenkins每隔15分鐘就檢查一次您原始碼倉庫的變化。 Build periodically :此選項僅僅通知Jenkins按指定的頻率對專案進行構建,而不管SCM是否有變化。如果想在這個Job中執行一些測試用例的話,它就很有幫助。 因為我的專案是用ant指令碼實現的編譯和打包,所以我選擇的是Invoke Ant,Ant Version選擇你Ant配置的那個名字,注意不要選擇default喔,那個選擇了沒有用。 圖17 Ant構建配置介面 如果你的構建指令碼build.xml不在workspace根目錄、或者說你的構建指令碼不叫build.xml。那麼需要在高階裡設定Build File選項的路徑,指明你的指令碼。注意:是相對路徑 部署請參考:war檔案部署章節 圖18 新建Job介面 這時,需要為新的構建任務指定一個名稱。(這裡輸入的任務名稱為:maven_test)這裡有幾種的任務型別可供選擇,鑑於初步介紹,先選擇構建一個maven2/3專案。對於其他的型別,經常使用的是拷貝已存在任務;這主要為了能在現有的任務基礎上新建任務。點選OK按鈕, 圖19 構建任務配置介面 演示是使用Subversion的連結,在Repository URL中輸入你的專案連結,如果沒有許可權則會提示如下圖: 圖20 Subversion配置介面 點選 enter credential 輸入使用者名稱和密碼(我猜大家一般都是使用的使用者名稱和密碼登陸的) 圖21 Subversion許可權認證介面 Ps:svn的使用者名稱和密碼設定了是沒有辦法在web介面修改的。如果要修改則先去Jenkins目錄刪除hudson.scm.SubversionSCM.xml檔案(點到為止,畢竟這只是入門教程) 在其他專案構建完成後才執行構建:指定的專案完成構建後,觸發此專案的構建。 Poll SCM :這是CI 系統中常見的選項。當您選擇此選項,您可以指定一個定時作業表示式來定義Jenkins每隔多久檢查一下您原始碼倉庫的變化。如果發現變化,就執行一次構建。例如,表示式中填寫0,15,30,45 * * * *將使Jenkins每隔15分鐘就檢查一次您原始碼倉庫的變化。 Build periodically :此選項僅僅通知Jenkins按指定的頻率對專案進行構建,而不管SCM是否有變化。如果想在這個Job中執行一些測試用例的話,它就很有幫助。 圖22 Maven構建配置介面 2013-08-22補充Goals and options :clean install  -Dmaven.test.skip=true  #加入了跳過測試的程式碼 Root POM:填寫你專案的pom.xml檔案的位置,注意:是相對位置,如果該檔案不存在,會有紅色字提示。 部署請參考:war檔案部署章節 使用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啟動了 圖25 構建後操作介面 選擇Add post-build action,然後選擇E-mail Notification,如下圖: 圖26 收件人列表介面 在Recipients中輸入收件人郵件地址,如果用多個收件人用“,”英文逗號隔開 首先你必須安裝好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記憶體引數調高可以解決這個問題。 最後不要忘記點選儲存喔。 好了!到此一個專案的獲取原始碼,打包,遠端部署,郵件通知就完成了。 當任務一旦執行,您將會看到這個任務正在佇列中的儀表板和當前工作主頁上執行。這兩種顯示如下。 圖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 控制檯輸出介面 從Jenkins現有的功能擴充套件或開發者們為Jenkins提供的新功能都可以稱之為Jenkins外掛。有些外掛可以無縫新增到您的構建過程,而其它,諸如除CVS和Subversion的SCM外掛則需要原始碼控制系統的支援。 Jenkins 外掛管理器允許您安裝新的外掛,和更新您Jenkins伺服器上的外掛。管理者將連線到聯機資料庫,檢索可用的和已更新的外掛。如果您的Jenkins伺服器 無法直接連線到外部資源,您可以從Jenkins網站上下載。 在已執行的Jenkins主頁中,點選左側的系統管理—>管理外掛進入如下介面: 圖36 外掛管理介面 它包含四個標籤: 更新:清單中列示了Jenkins為某些外掛搜尋到了可用的更新。列出的每個外掛可以被選擇並應用更新。 可選安裝:清單中列示了可用於安裝(而不是目前已安裝的)的所有外掛。列出的每個外掛都可以被選擇並安裝。 已安裝:清單中列示了已經安裝的外掛。 高階:允許您通過設定HTTP代理的方式使Jenkins與線上外掛庫建立連線。此外,還提供了一個上傳裝置,可以安裝你在Jenkins以外已下載的那些外掛。 由上圖可知,Jenkins預設集成了maven2外掛,並且一旦外掛有新版本,會提示更新新版本外掛。 如果想安裝新的外掛,可以點選tab分頁中的可選外掛。如下圖: 圖37 可選外掛介面 從圖可知,各種Jenkins外掛根據之前所記述的型別進行分門別類。可勾選任意想安裝的Jenkins外掛,點選Install without restart按鈕進行安裝。安裝後,所有外掛以hpi作為字尾名放置在plugins資料夾下。如果是高階使用者還可以自行開發外掛方便具體專案使用。 注意:安裝完成後需要重啟Jenkins部署的容器。這樣才能使用新裝的外掛。 Jenkins執行自動部署war包到servlet容器內,要實現這個功能必須安裝一個外掛。 圖38 安裝外掛介面 圖39 外掛安裝介面 好了,到此Deploy Plugin外掛安裝完成! 最後,如果感覺我太囉嗦了去看這篇吧: http://www.cnblogs.com/gao241/archive/2013/04/08/3008380.html 轉:http://www.cnblogs.com/zz0412/p/jenkins02.html 點選開啟連結