操作環境:Windows
一、環境準備
1 安裝JDK
本文采用jdk-8u111-windows-x64.exe;
2 配置tomcat
本文采用tomcat8,無需安裝,配置JAVA_HOME及JRE_HOME環境變量即可;
3 安裝maven
本文采用maven3.3.9,無需安裝;
4 安裝Jenkins
下載地址https://jenkins.io/download/,僅下載war包,如下圖:
將下載好的jenkins.war放進tomcat/webapps目錄下。
二、相關配置
1 登入http://localhost:8080/jenkins,進入Jenkins初始化頁面,第一次啓動時間可能有點長,耐心等待。進入成功後會看到如下畫面,按提示路徑打開密碼文件,輸入密碼:
解鎖後又是一長段時間等待,此後可能出現如下圖所示界面:
表示無法下載Jenkins插件,可能是因爲防火牆導致,而Jenkins插件的安裝非常重要,建議翻牆。如無法翻牆,則選擇Skip Plugin Installations跳過插件安裝。進入以下頁面,設置登陸用戶:
2 設置成功後即進入Jenkins主界面:
點擊左上側系統管理,進入Jenkins基本系統設置(主要是以下三塊):
3 先進入“管理插件”模塊安裝必需的插件,以下是建議安裝列表:
將本文附件中的插件放入Jenkins插件存放目錄即可,如本文插件存放目錄爲:C:\Users\Administrator\.jenkins\plugins(可點擊系統管理–>系統設置,在最上方查看,如下圖);
4 配置系統設置
添加編碼全局屬性:
增加系統管理員郵件地址:
其他的可用默認配置,保存後退出。
5 添加全局配置Global ToolConfiguration
配置JDK,不採用自動安裝:
配置maven,不採用自動安裝:
以上即爲需要設置的系統配置。
三、系統部署
系統設置完成後開始添加任務,任務類型選擇自由風格:
創建完成後可在主頁看到如下畫面:
在”All” tab下能看到新建的任務,點擊該任務,進入該任務的配置頁面:
設置項目備註及構建規則:
配置項目輪詢的源碼位置(@HEAD表示構建最新的代碼)並配置代碼訪問密碼:
配置構建觸發器,如下圖配置爲每天晚上9:30開始構建(Cron表達式):
增加Invoke top-level Maven targets構建步驟,插件目標爲編譯、發現編譯Bug、部署,另外還可以配置構建時忽略測試用例:
增加構建後操作步驟:Publish FindBugs analysis results,用於查看FindBugs插件的代碼分析報告,該模塊可採用默認配置:
增加構建後操作步驟:Deploy war/ear to a container,用於將構建後生成的war包部署至tomcat服務器,下圖中Contextpath用於配置項目訪問路徑,如填/RMS_Server則表示項目的根訪問目錄爲:http://localhost:8080/RMS_Server,Deploy on failure用於配置當前構建失敗時是否仍然部署至tomcat,默認不選:
以上即爲本項目的所有配置,完成後應用(或保存)並退出。
配置完成後即可開始構建,左側可查看bugs分析信息及構建歷史:
點擊某個構建記錄,如上圖中的#31,即可查看構建日誌、SVN代碼提交日誌及bugs分析結果:
四、編碼問題
FindBugs分析報告中查看某些代碼文件時可能出現中文亂碼情況,如下圖:
這是tomcat的編碼問題導致的,可在系統管理中查看tomcat的相關編碼情況:
主要關注的是file.encoding屬性及sun.jnu.encoding屬性,二者需要設置爲UTF-8以兼容中文:
這可通過在tomcat配置文件/bin/catalina.bat文件中添加set “JAVA_OPTS=-Dfile.encoding=UTF-8-Dsun.jnu.encoding=UTF-8”命令實現,如下圖:
配置完成後重啓tomcat,可看到編碼已經更改: