Jenkins部署與項(xiàng)目自動(dòng)部署.doc

Jenkins安裝與項(xiàng)目部署發(fā)布說(shuō)明2015/08/13update 2017/09026本篇的系統(tǒng)環(huán)境為L(zhǎng)inux1. 軟件準(zhǔn)備本文中連接linux服務(wù)器的工具為SecureCRT。（其它工具類(lèi)似）準(zhǔn)備好以下文件：jdk-7u79-linux-x64.tar.gzapache-maven-3.3.3-bin.tar.gzjenkins-1.623-1.1.noarch.rpm使用root用戶登錄linux，切換到usr目錄（也可以自定義目錄），將準(zhǔn)備好的文件上傳到服務(wù)器上。（本文件之后的內(nèi)容中，如無(wú)特殊說(shuō)明，都是在root用戶下執(zhí)行操作。）命令如下：cd /usr切換到usr目錄rz（上傳的路徑為執(zhí)行該命令時(shí)所在的目錄）ll 查看文件2. JDK、MAVEN安裝與環(huán)境變量配置解壓maven和jdk到usr目錄下，然后打開(kāi)etc目錄下profile文件，配置環(huán)境變量。命令如下：tar apache-maven-3.3.3-bin.tar.gztar jdk-7u79-linux-x64.tar.gzvi /etc/profile按i鍵進(jìn)行編輯，在文件結(jié)尾處添加以下文字JAVA_HOME=/usr/java/jdk1.7.0_79CLASSPATH=.:$JAVA_HOME/jre/lib/rt.jar: $JAVA_HOME/lib/tools.jarM2_HOME=/usr/apache-maven-3.3.3PATH=$PATH:$JAVA_HOME/bin:$M2_HOME/binexport JAVA_HOME CLASSPATH M2_HOME PATH推出編輯 :wq 保存退出source /etc/profile （使環(huán)境變量生效）然后，輸入java version和mvn v測(cè)試配置是否有效3. Jenkins安裝與配置3.1. 安裝執(zhí)行命令安裝：rpm -ivh /usr/jenkins-1.623-1.1.noarch.rpm安裝成功后，Jenkins的默認(rèn)端口號(hào)是8080，AJP端口是8009，與tomcat的相同。我們可以進(jìn)入Jenkins的配置文件修改端口號(hào)：vi /etc/sysconfig/Jenkins找到JENKINS_PORT=8080和JENKINS_AJP_PORT=8009進(jìn)行修改。然后就嘗試啟動(dòng)Jenkins服務(wù)：service jenkins start如果提示：Starting Jenkins 確定這表示啟動(dòng)成功，可以通過(guò)http:/ip:8080進(jìn)行訪問(wèn)了。如果提示：Starting Jenkins bash: /usr/bin/java: 沒(méi)有那個(gè)文件或目錄 確定或者 Starting Jenkins Jenkins requires Java7 or later, but you are running 1.6.0_35-b35 from /usr/lib/jvm/java-1.6.0-openjdk-5.x86_64/jrejava.lang.UnsupportedClassVersionError: 50.0 at Main.main(Main.java:90) 確定表示Jenkins找不到可執(zhí)行的java環(huán)境，需要再次進(jìn)入到配置文件中，找到JENKINS_JAVA_CMD配置項(xiàng)，把java路徑配置進(jìn)去，此處為JENKINS_JAVA_CMD=”/usr/java/jdk1.7.0_79/bin/java”，注意bin目錄后要加/java。保存文件退出，重新啟動(dòng)服務(wù)，可以成功啟動(dòng)。通過(guò)http:/ip:8080進(jìn)行訪問(wèn)。3.2. 配置通過(guò)瀏覽器訪問(wèn)Jenkins頁(yè)面，點(diǎn)擊系統(tǒng)管理-系統(tǒng)設(shè)置，打開(kāi)系統(tǒng)設(shè)置界面。點(diǎn)擊主目錄的高級(jí)按鈕，可以自定義Jenkins從svn下載源碼的位置，構(gòu)建項(xiàng)目的位置向下滾動(dòng)頁(yè)面，找到j(luò)dk，點(diǎn)擊新增jdk按鈕，不勾選自動(dòng)安裝，手動(dòng)填寫(xiě)JAVA_HOME（系統(tǒng)中的JAVA_HOME）。找到maven，點(diǎn)擊新增maven按鈕，不勾選自動(dòng)安裝，手動(dòng)填寫(xiě)MAVEN_HOME。找到郵件通知，點(diǎn)擊高級(jí)按鈕，勾選使用smtp認(rèn)證，填寫(xiě)用戶名密碼。設(shè)置好后，可以勾選通過(guò)發(fā)送測(cè)試郵件測(cè)試配置，查看配置是否正確。其他選項(xiàng)使用默認(rèn)配置，不要更改。最后點(diǎn)擊保存按鈕。4. 創(chuàng)建Jenkins用戶4.1. 創(chuàng)建用戶useradd jenkins如果不手動(dòng)創(chuàng)建，在安裝Jenkins時(shí)，默認(rèn)會(huì)自動(dòng)創(chuàng)建該用戶，那么久可能遇到下面這個(gè)問(wèn)題。如果Jenkins所在服務(wù)器與web服務(wù)器不是同一臺(tái)，那么在構(gòu)建部署項(xiàng)目時(shí)，需要編寫(xiě)項(xiàng)目部署命令（如拷貝項(xiàng)目、停用服務(wù)、啟用服務(wù)等），通過(guò)ssh執(zhí)行。此時(shí)Jenkins會(huì)默認(rèn)以jenkins這個(gè)用戶登錄web服務(wù)器進(jìn)行命令操作。所以我們需要切換到j(luò)enkins這個(gè)用戶，配置用戶免密碼登錄，如果是自動(dòng)創(chuàng)建的用戶，則可能會(huì)切換不了，因此需要手動(dòng)創(chuàng)建該用戶。4.2. 配置免密碼登錄web服務(wù)器。切換用戶：su - jenkins執(zhí)行如下命令，生成本機(jī)的公鑰和私鑰文件，這過(guò)程中會(huì)有提示選擇，全部回車(chē)默認(rèn)就可以了：ssh-keygen -t rsa命令執(zhí)行后，目錄/.ssh（當(dāng)前用戶目錄下）下會(huì)出現(xiàn)兩個(gè)文件：id_rsa和id_rsa.pub。其中，id_rsa.pub為公鑰文件。將該文件的內(nèi)容追加到web服務(wù)器上/.ssh目錄下的authorized_keys文件中。首先將該文件拷貝到web服務(wù)器上：scp /.ssh/id_rsa.pub root85:/tmp/id_rsa_Jenkins.pub用root用戶登錄web服務(wù)器，切換到/.ssh目錄下，將id_rsa_HOSTA.pub的內(nèi)容追加到authorized_keys文件中：cat /tmp/id_rsa_Jenkins.pub /.ssh/authorized_keyschmod 600 authorized_keys4.3. 設(shè)置Jenkins服務(wù)器中jenkins用戶下的maven切換到Jenkins用戶文件目錄下， su - jenkins查看是否有.m2文件夾，如果沒(méi)有，創(chuàng)建該文件夾，并創(chuàng)建settings.xml文件，修改其中的配置（也可以從其他地方復(fù)制過(guò)來(lái)）：cd ll -amkdir .m2touch settings.xml（創(chuàng)建文件） cp /usr/settings.xml /home/jenkins/.m2（從其他地方復(fù)制）5. 配置項(xiàng)目自動(dòng)部署5.1. 執(zhí)行上一章節(jié)中【配置免密碼登錄web服務(wù)器】。5.2. 新建點(diǎn)擊新建按鈕，填寫(xiě)item名稱，選擇構(gòu)建一個(gè)maven項(xiàng)目點(diǎn)擊OK5.3. 源碼管理選擇Subversion，填寫(xiě)項(xiàng)目的svn路徑第一次錄入svn地址時(shí)，會(huì)出現(xiàn)該錯(cuò)誤，點(diǎn)擊enter credential，填寫(xiě)svn的用戶名密碼就可以了。5.4. 構(gòu)建觸發(fā)器表達(dá)式是5位，分別表示分（0-59）、時(shí)（0-23）、天（1-31）、月（1-2）、星期（0-7,0和7都表示周日）?；旧吓ccron表達(dá)式一致。特別的H/n，表示每多長(zhǎng)時(shí)間。5.5. PreSteps執(zhí)行步驟無(wú)特殊需求，則不需要填寫(xiě)。5.6. Build（部分配置項(xiàng)是jenkins2.0以后的）填寫(xiě)maven命令如果需要特殊配置，例如指定自定義的maven的settings.xml地址等，則點(diǎn)擊高級(jí)選項(xiàng)5.7. PostSteps執(zhí)行步驟這一步是自動(dòng)部署的重點(diǎn)，在這里增加Execute shell（Windows就是batch command）。選擇 Run only if build succeeds，填寫(xiě)執(zhí)行的命令。tomcathome=/u01/tomcat/apache-tomcat-7.0.69_SOPip=4ssh root$ip cd $tomcathomessh root$ip rm -rf /webapps/sop*scp $WORKSPACE/target/sop.war root$ip:$tomcathome/webapps/sleep 10ssh root$ip mv $tomcathome/webapps/sop/WEB-INF/classes/perties.test $tomcathome/webapps/sop/WEB-INF/classes/pertiesssh root$ip $tomcathome/bin/shutdown.shssh root$ip $tomcathome/bin/startup.sh5.8. 構(gòu)建設(shè)置默認(rèn)是構(gòu)建失敗通知勾線郵件通知，填寫(xiě)接收郵件即可。5.9. 構(gòu)建后操作（部分配置項(xiàng)是jenkins2.0以后的）如果項(xiàng)目構(gòu)建并自動(dòng)部署成功后，想要郵件通知測(cè)試人員，那么需要在這里配置。點(diǎn)擊最下邊的advanced settings點(diǎn)擊Triggers，選擇success，然后在配置如下5.10. 保存。6. 常見(jiàn)問(wèn)題及注意事項(xiàng)1. 執(zhí)行遠(yuǎn)程命令時(shí)，報(bào)錯(cuò)Host key verification failed.（Linux下）這說(shuō)明jenkins服務(wù)器無(wú)法免密碼登錄web服務(wù)器執(zhí)行命令。需要按照那一章節(jié)，再重新執(zhí)行一下。2. 通過(guò)遠(yuǎn)程命令啟動(dòng)tomcat，報(bào)錯(cuò)：Neither the JAVA_HOME nor the JRE_HOME environment variable is defined原因：因?yàn)閱?dòng)tomcat會(huì)調(diào)用tomcat安裝文件中的startup.sh，而它調(diào)用了catalina.sh則調(diào)用了setclasspath.sh。因此需要在setclasspath.sh的開(kāi)頭手動(dòng)聲明環(huán)境變量。（windows相同）解決方案：用vim打開(kāi)tomcat的bin目錄下的setclasspath.sh，添加JAVA_HOME和JRE_HOME兩個(gè)環(huán)境變量（下圖紅色方框內(nèi)），兩個(gè)環(huán)境變