Jenkins是一個開源的持續集成工具，應用Jenkins搭建持續集成環境，能夠進行自動構建、自動編譯和部署，很是方便。java
在服務器比較少的狀況下，Jenkins的優點並不明顯，可是隨着項目發展，服務器數量的增長，Jenkins的優點就會凸顯出來，能夠很好的提升效率，減小不少人工操做。git
如今不少公司的Java項目開發都是使用Git或者SVN管理代碼，Maven管理多模塊和項目依賴，github
因此今天嘗試學習如何使用Jenkins搭建Github與Maven下的自動構建和部署。web
1.部署Jenkins
官網下載http://jenkins-ci.org/。目前的最新版本是1.629。spring
Jenkins的安裝十分簡單，下載後就是一個jenkins.war的war包，能夠直接部署在Tomcat或者其餘容器中。shell
若是不能部署，能夠檢查Tomcat的配置文件，能夠查看server.xml裏unpackWARs和autoDeploy是否設置爲True。apache
另外官網還有相關的.deb等的安裝，比較繁瑣，具體哪一種方式部署能夠本身選擇。tomcat
2.安裝相關插件
把war文件拷貝到Tomcat的webapps目錄，bash
啓動後進入http://SERVER_PATH:8080/jenkins/，能夠看到Jenkins已經在運行：服務器
配置Git倉庫須要用到Git插件，Jenkins默認沒有Git插件，須要手動安裝。
點擊Manage Jenkins，進入Manage Plugins，
在可用(Avaliable)插件列表下找到Source Code Management一欄，
選擇GIT plugin插件，安裝以後重啓。
其餘的插件如Maven等，Jenkins默認安裝，不須要手動下載。
3.配置Maven和JDK路徑等
選擇Configure System，能夠配置Maven安裝路徑等。
若是沒有Maven和Git環境，須要另外設置。
記得配置JDK路徑，第一次我就忘記配置，結果構建時系統自動安裝Jdk，特別慢。
下面是Jenkins Location選項，jenkins默認會存放在用戶主目錄下的.jenkins文件夾中，若是須要變更能夠在這裏更改。
後面的shell中也會用到Jenkins Location，默認的訪問路徑：
http://SERVER_PATH:8080/jenkins/job/
4.建立任務，配置項目信息
爲了更好的學習Jenkins，我新建了一個很是簡單的Spring MVC項目，這個項目使用Maven管理，提交到了github上，地址：
https://github.com/bingyue/easy-springmvc-maven
首先按照提示建立一個任務，選擇Maven Project。
進入Config頁面，點擊Source Code Management的git選項，
填入上面的git地址，配置用戶名密碼等參數。
下面的Build Triggers是一個持續集成的觸發器插件，
能夠根據已經完成構建的結果，觸發新Job或者傳遞參數。
默認的選項是Build whenever a SNAPSHOT dependency is built，
意思是依賴於快照的構建意思是依賴於快照的構建，當代碼有更新時就構建項目。
下面的Build periodically和Poll SCM能夠設置定時自動構建，這裏我暫時不設置。
Pre Steps選項用來配置構建前的工做，這裏不做更改。
由於是Maven項目，Build選項有Root POM和Goals and options的設置，
使用默認的打包應該就能夠。
5.配置構建成功後的動做，添加shell
Post Steps選項設置構建完成後的動做，
這裏我設置爲將war包拷貝到Tomcat目錄，刪除項目原來的內容文件夾，並重啓Tomcat。
選擇Run only if build succeeds or is unstable ，點擊添加Execute Shell：
#!/bin/bash
#copy file and restart tomcat
tomcat_path=/usr/local/tomcat2
project=easy-springmvc-maven
war_name=easy-springmvc-maven.war
war_path=http://192.168.106.128:8080/jenkins/job/jeekins-test/ws/target
server_port=8082
file_path=/home/bingyue/.jenkins/jobs/jeekins-test/workspace/target
now=$(date +"%Y%m%d%H%M%S")
echo "the shell execute time is ${now}"
echo `lsof -n -P -t -i :${server_port}`
tomcat_pid=`lsof -n -P -t -i :${server_port}`
echo "the tomcat_pid is ${tomcat_pid}"
if [ "${tomcat_pid}" != "" ]; then
kill -9 $tomcat_pid
echo "kill the server"
fi
echo "rm ${tomcat_path}/webapps/${war_name}"
rm ${tomcat_path}/webapps/${war_name}
echo "rm -rf ${tomcat_path}/webapps/${project}"
rm -rf ${tomcat_path}/webapps/${project}
cd $file_path
if [ -f ${war_name} ]; then
cp ${war_name} ${tomcat_path}/webapps
else
echo "${war_name} unexists"
fi
export JAVA_HOME=/data/jdk7
export CATALINA_HOME2=/usr/local/apache-tomcat-2
export CATALINA_BASE2=/usr/local/apache-tomcat-2
$tomcat_path/bin/startup.sh
echo "server restarted"
說明幾點：
此次學習是使用了單臺虛擬機裏的兩個Tomcat，因此端口號有改變，
我爲了方便測試，直接訪問了Jenkins的隱藏目錄/.jenkins/文件夾，
實際應用中，Jenkins一般都是應用在分佈式系統，同時部署多臺服務器，通常都是訪問Jenkins所在的機器上下載war包來部署，
咱們測試的時候也能夠直接修改Jenkins主目錄。
最下面的BuildSetting 能夠設置郵件收件人列表等，在每次構建結束後能夠將相關信息發送到郵箱。
6.構建項目
完成相應的設置後，就能夠進行項目的構建。
在任務列表頁點擊Play的按鈕，或者進入任務而後選擇Build Now。
首頁左下角的欄目顯示正在構建的項目狀態：
點擊能夠查看控制檯輸出和日誌：
構建成功，項目狀態爲藍色，失敗是紅色。
打包成功後，能夠進入workspace查看文件：
http://SERVER_PATH:8080/jenkins/job/jeekins-test/ws/target/easy-springmvc-maven.war
如今打開剛纔的Tomcat路徑，若是控制檯沒有錯誤輸出，構建的項目應該能夠正常訪問：
構建成功！
7.遇到的問題
- 部署到Tomcat時Jenkins啓動報錯，war包沒法解壓：
Invalid or unreadable WAR file : error in opening zip file
檢查發現是文件下載不徹底，從新下載上傳後解決。jenkins.war文件有60多MB，使用前記得檢查文件完整性。
- 首次進入提示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.
點擊Jenkins提示已經給出瞭解決方案:
Some versions of Tomcat (such as 5.0.28) uses iso-8859-1 to decode URLs, which is in a clear violation of the relevant RFCs. To fix this problem, add the following URIEncoding attribute to the connector definition in $TOMCAT_HOME/conf/server.xml.
<Connector port="8080" URIEncoding="UTF-8"/>
- Sending e-mails to: name@gmail.com
ERROR: Could not connect to SMTP host: localhost, port: 25
javax.mail.MessagingException: Could not connect to SMTP host: localhost, port: 25;
本地的SMTP25端口沒有打開。