Jenkins是一個開源的持續集成工具，應用Jenkins搭建持續集成環境，可以進行自動構建、自動編譯和部署，非常方便。
在服務器比較少的情況下，Jenkins的優勢並不明顯，但是隨着項目發展，服務器數量的增加，Jenkins的優勢就會凸顯出來，可以很好的提高效率，減少很多人工操作。
現在很多公司的Java項目開發都是使用Git或者SVN管理代碼，Maven管理多模塊和項目依賴，
所以今天嘗試學習如何使用Jenkins搭建Github與Maven下的自動構建和部署。
1.部署Jenkins
官網下載http://jenkins-ci.org/。目前的最新版本是1.629。
Jenkins的安裝十分簡單，下載后就是一個jenkins.war的war包，可以直接部署在Tomcat或者其他容器中。
如果不能部署，可以檢查Tomcat的配置文件，可以查看server.xml里unpackWARs和autoDeploy是否設置為True。
另外官網還有相關的.deb等的安裝，比較繁瑣，具體哪種方式部署可以自己選擇。
2.安裝相關插件
把war文件拷貝到Tomcat的webapps目錄，
啟動后進入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端口沒有打開。