Jenkins入門系列之——02第二章 Jenkins安裝與配置

AskHarries發表於2018-11-08

2 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環境):

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖2 Jenkins主介面

3 Jenkins配置

寫在配置前的一些話:Jenkins的配置不可能全部都說到的,大部分配置是有英文說明的,點選輸入框後面的問號就可以看見了。英文不會用翻譯工具,連蒙帶猜的,多測試幾次,你就懂了。

3.1 系統管理

在已執行的Jenkins主頁中,點選左側的系統管理進入如下介面:

Jenkins入門系列之——02第二章 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檔案

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖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 安全設定

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖5 安全提示訊息

詹金斯允許網路上的任何人代表您啟動程式。考慮至少啟用身份驗證來阻止濫用。點選Dismiss忽略該訊息,點選Setup Security進入設定介面.詳細設定請參考 Configure Global Security(安全設定) 章節

3.1.2 系統設定

在已執行的Jenkins主頁中,點選左側的系統管理—>系統設定進入如下介面:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖6 系統設定介面

3.1.2.1 JDK、Maven、Ant配置

配置一個JDK、Ant、Maven例項,請在每一節下面單擊Add(新增) 按鈕,這裡將新增例項的名稱和絕對地址。下圖描述了這兩個部分。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖7 JDK配置介面

JDK別名:給你看的,隨便你自己,叫阿貓阿狗都可以

JAVA_HOME:這個是本機JDK的安裝路徑(錯誤的路徑會有紅字提示你的)

自動安裝:不推薦這個選項

後面Ant與Maven的配置是一樣的,JDK去oracle官網下載,Ant與Maven去apache官網下載

Ps:每個文字框後面都有個問號,點選問號就會出現幫助資訊

3.1.2.2 郵件通知配置

3.1.2.2.1 配置發件人地址

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖8 發件人地址配置介面

System Admin e-mail address:Jenkins郵件傳送地址,如果你這個沒有配置,等著發郵件的時候報錯吧,當時我也是這兒沒有配置,鬱悶了我一週的時間。⊙﹏⊙b汗

3.1.2.2.2 配置郵件通知

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖9 郵件通知

這個就非常的簡單了,根據的的郵箱提供者的引數配置就行了。

Ps:小技巧:使用者預設郵件字尾配置了後,以後你填寫郵件地址只需要@之前的就行了

3.1.2.3 Subversion配置

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖10 Subversion配置

Subversion Workspace Version:Subversion 的版本號,選擇你對應的版本號就行了

3.1.3 Configure Global Security(安全設定)

在已執行的Jenkins主頁中,點選左側的系統管理—>Configure Global Security進入如下介面:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖11 安全設定介面

設定如上圖,儲存後系統管理中就出現管理使用者的選項。頁面右上角也會出現登入/註冊的選項。

3.1.4 管理使用者設定

在右上角點選註冊

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖12 註冊使用者介面

點選sign up按鈕,提示你現在已經登入.返回首頁.

登入後和匿名賬號看到的首頁有幾點不同,如下圖紅框所示:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖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進入如下介面:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖14 新建Job介面

這時,需要為新的構建任務指定一個名稱。(這裡輸入的任務名稱為:Ant_test)這裡有幾種的任務型別可供選擇,鑑於初步介紹,先選擇構建一個自由風格的軟體專案。對於其他的型別,經常使用的是拷貝已存在任務;這主要為了能在現有的任務基礎上新建任務。點選OK按鈕,

3.2.1.2 構建任務配置

3.2.1.2.1 原始碼管理配置

演示是使用Subversion的連結,在Repository URL中輸入你的專案連結,如果沒有許可權則會提示如下圖:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖15 Subversion配置介面

點選 enter credential 輸入使用者名稱和密碼(我猜大家一般都是使用的使用者名稱和密碼登陸的)

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖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喔,那個選擇了沒有用。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖17 Ant構建配置介面

如果你的構建指令碼build.xml不在workspace根目錄、或者說你的構建指令碼不叫build.xml。那麼需要在高階裡設定Build File選項的路徑,指明你的指令碼。注意:是相對路徑

部署請參考:war檔案部署章節

3.2.2 構建Maven風格的Job

3.2.2.1 新建Maven構建任務

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖18 新建Job介面

這時,需要為新的構建任務指定一個名稱。(這裡輸入的任務名稱為:maven_test)這裡有幾種的任務型別可供選擇,鑑於初步介紹,先選擇構建一個maven2/3專案。對於其他的型別,經常使用的是拷貝已存在任務;這主要為了能在現有的任務基礎上新建任務。點選OK按鈕,

3.2.2.2 構建任務配置

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖19 構建任務配置介面

3.2.2.2.1 原始碼管理配置

演示是使用Subversion的連結,在Repository URL中輸入你的專案連結,如果沒有許可權則會提示如下圖:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖20 Subversion配置介面

點選 enter credential 輸入使用者名稱和密碼(我猜大家一般都是使用的使用者名稱和密碼登陸的)

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖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構建設定

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖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檔案

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖23 Maven專案結構介面1

上面這種方法打包的時候非常簡單,但是用eclipse開發的時候你就不右鍵run as —>tomca啟動了,如果你想使用這種方式,將tomcat換成jetty即可。

如果你的專案是下圖這種結構,那麼非常悲劇的告訴你,你要建立好幾個job來構建這一個專案,因為這個專案有4個根。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖24 Maven專案結構介面2

上面這種方法打包的時候比較麻煩,但是用eclipse開發的時候你就可以使用右鍵run as —>tomca啟動了

3.2.3 郵件通知設定

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖25 構建後操作介面

選擇Add post-build action,然後選擇E-mail Notification,如下圖:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖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專案配置頁面:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖27 構建後操作介面

選擇Add post-build action,然後選擇Deploy war/ear to a container,如下圖:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖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 監控

當任務一旦執行,您將會看到這個任務正在佇列中的儀表板和當前工作主頁上執行。這兩種顯示如下。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖29 主頁監控(左),專案監控(右)

一旦構建完成後,完成後的任務將會有三個地方進行顯示。

你可以在Jenkins的控制皮膚上看到它,如下圖。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖30 主頁專案介面

在上面展示的截圖中,您將注意到有兩個圖示描述當前作業的狀態。S欄目代表著“最新構建狀態”,W欄目代表著“構建穩定性”。Jenkins使用這兩個概念來介紹一個作業的總體狀況:

構建狀態:下圖中分級符號概述了一個Job新近一次構建會產生的四種可能的狀態:

Successful:完成構建,且被認為是穩定的。

Unstable:完成構建,但被認為不穩定。

Failed:構建失敗。

Disabled:構建已禁用。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖31 構建狀態介面

構建穩定性: 當一個Job中構建已完成並生成了一個未釋出的目標構件,如果您準備評估此次構建的穩定性,Jenkins會基於一些後處理器任務為構建釋出一個穩健指數 (從0-100 ),這些任務一般以外掛的方式實現。它們可能包括單元測試(JUnit)、覆蓋率(Cobertura )和靜態程式碼分析(FindBugs)。分數越高,表明構建越穩定。下圖中分級符號概述了穩定性的評分範圍。任何構建作業的狀態(總分100)低於80分就是不穩定的。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖32 構建穩定性介面

你也可以在當前Job主介面上看到它,如下圖左下部分

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖33 專案主介面

當前作業主頁上還包含了一些有趣的條目。左側欄的連結主要控制Job的配置、刪除作業、構建作業。右邊部分的連結指向最新的專案報告和構件。

通過點選構建歷史(Build History)中某個具體的構建連結,您就能跳轉到Jenkins為這個構建例項而建立的構建主頁上。如下圖

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖34 構建歷史介面

如果你想通過檢視輸出介面來監控當前任務的進展情況。你可以單擊Console Output(控制檯輸出)。如果工作已完成,這將顯示構建指令碼產生的靜態輸出;如果作業仍然在執行中,Jenkins將不斷重新整理網頁的內容,以便您可以看到它執行時的輸出。如下圖:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖35 控制檯輸出介面

4 Jenkins外掛

從Jenkins現有的功能擴充套件或開發者們為Jenkins提供的新功能都可以稱之為Jenkins外掛。有些外掛可以無縫新增到您的構建過程,而其它,諸如除CVS和Subversion的SCM外掛則需要原始碼控制系統的支援。

4.1 Jenkins外掛安裝

Jenkins 外掛管理器允許您安裝新的外掛,和更新您Jenkins伺服器上的外掛。管理者將連線到聯機資料庫,檢索可用的和已更新的外掛。如果您的Jenkins伺服器 無法直接連線到外部資源,您可以從Jenkins網站上下載。

在已執行的Jenkins主頁中,點選左側的系統管理—>管理外掛進入如下介面:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖36 外掛管理介面

它包含四個標籤:

更新:清單中列示了Jenkins為某些外掛搜尋到了可用的更新。列出的每個外掛可以被選擇並應用更新。

可選安裝:清單中列示了可用於安裝(而不是目前已安裝的)的所有外掛。列出的每個外掛都可以被選擇並安裝。

已安裝:清單中列示了已經安裝的外掛。

高階:允許您通過設定HTTP代理的方式使Jenkins與線上外掛庫建立連線。此外,還提供了一個上傳裝置,可以安裝你在Jenkins以外已下載的那些外掛。

由上圖可知,Jenkins預設整合了maven2外掛,並且一旦外掛有新版本,會提示更新新版本外掛。

如果想安裝新的外掛,可以點選tab分頁中的可選外掛。如下圖:

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖37 可選外掛介面

從圖可知,各種Jenkins外掛根據之前所記述的型別進行分門別類。可勾選任意想安裝的Jenkins外掛,點選Install without restart按鈕進行安裝。安裝後,所有外掛以hpi作為字尾名放置在plugins資料夾下。如果是高階使用者還可以自行開發外掛方便具體專案使用。

注意:安裝完成後需要重啟Jenkins部署的容器。這樣才能使用新裝的外掛。

4.2 Jenkins外掛安裝示例

Jenkins執行自動部署war包到servlet容器內,要實現這個功能必須安裝一個外掛。

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖38 安裝外掛介面

Jenkins入門系列之——02第二章 Jenkins安裝與配置

圖39 外掛安裝介面

好了,到此Deploy Plugin外掛安裝完成!

最後,如果感覺我太囉嗦了去看這篇吧:

http://www.cnblogs.com/gao241/archive/2013/04/08/3008380.html

Jenkins入門系列之——02第二章 Jenkins安裝與配置


相關文章