Jenkins部署與項目自動部署.doc

Jenkins安裝與項目部署發(fā)布說明2015/08/13update 2017/09026本篇的系統(tǒng)環(huán)境為Linux1. 軟件準備本文中連接linux服務(wù)器的工具為SecureCRT。（其它工具類似）準備好以下文件：jdk-7u79-linux-x64.tar.gzapache-maven-3.3.3-bin.tar.gzjenkins-1.623-1.1.noarch.rpm使用root用戶登錄linux，切換到usr目錄（也可以自定義目錄），將準備好的文件上傳到服務(wù)器上。（本文件之后的內(nèi)容中，如無特殊說明，都是在root用戶下執(zhí)行操作。）命令如下：cd /usr切換到usr目錄rz（上傳的路徑為執(zhí)行該命令時所在的目錄）ll 查看文件2. JDK、MAVEN安裝與環(huán)境變量配置解壓maven和jdk到usr目錄下，然后打開etc目錄下profile文件，配置環(huán)境變量。命令如下：tar apache-maven-3.3.3-bin.tar.gztar jdk-7u79-linux-x64.tar.gzvi /etc/profile按i鍵進行編輯，在文件結(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測試配置是否有效3. Jenkins安裝與配置3.1. 安裝執(zhí)行命令安裝：rpm -ivh /usr/jenkins-1.623-1.1.noarch.rpm安裝成功后，Jenkins的默認端口號是8080，AJP端口是8009，與tomcat的相同。我們可以進入Jenkins的配置文件修改端口號：vi /etc/sysconfig/Jenkins找到JENKINS_PORT=8080和JENKINS_AJP_PORT=8009進行修改。然后就嘗試啟動Jenkins服務(wù)：service jenkins start如果提示：Starting Jenkins 確定這表示啟動成功，可以通過http:/ip:8080進行訪問了。如果提示：Starting Jenkins bash: /usr/bin/java: 沒有那個文件或目錄 確定或者 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)境，需要再次進入到配置文件中，找到JENKINS_JAVA_CMD配置項，把java路徑配置進去，此處為JENKINS_JAVA_CMD=”/usr/java/jdk1.7.0_79/bin/java”，注意bin目錄后要加/java。保存文件退出，重新啟動服務(wù)，可以成功啟動。通過http:/ip:8080進行訪問。3.2. 配置通過瀏覽器訪問Jenkins頁面，點擊系統(tǒng)管理-系統(tǒng)設(shè)置，打開系統(tǒng)設(shè)置界面。點擊主目錄的高級按鈕，可以自定義Jenkins從svn下載源碼的位置，構(gòu)建項目的位置向下滾動頁面，找到j(luò)dk，點擊新增jdk按鈕，不勾選自動安裝，手動填寫JAVA_HOME（系統(tǒng)中的JAVA_HOME）。找到maven，點擊新增maven按鈕，不勾選自動安裝，手動填寫MAVEN_HOME。找到郵件通知，點擊高級按鈕，勾選使用smtp認證，填寫用戶名密碼。設(shè)置好后，可以勾選通過發(fā)送測試郵件測試配置，查看配置是否正確。其他選項使用默認配置，不要更改。最后點擊保存按鈕。4. 創(chuàng)建Jenkins用戶4.1. 創(chuàng)建用戶useradd jenkins如果不手動創(chuàng)建，在安裝Jenkins時，默認會自動創(chuàng)建該用戶，那么久可能遇到下面這個問題。如果Jenkins所在服務(wù)器與web服務(wù)器不是同一臺，那么在構(gòu)建部署項目時，需要編寫項目部署命令（如拷貝項目、停用服務(wù)、啟用服務(wù)等），通過ssh執(zhí)行。此時Jenkins會默認以jenkins這個用戶登錄web服務(wù)器進行命令操作。所以我們需要切換到j(luò)enkins這個用戶，配置用戶免密碼登錄，如果是自動創(chuàng)建的用戶，則可能會切換不了，因此需要手動創(chuàng)建該用戶。4.2. 配置免密碼登錄web服務(wù)器。切換用戶：su - jenkins執(zhí)行如下命令，生成本機的公鑰和私鑰文件，這過程中會有提示選擇，全部回車默認就可以了：ssh-keygen -t rsa命令執(zhí)行后，目錄/.ssh（當(dāng)前用戶目錄下）下會出現(xiàn)兩個文件：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文件夾，如果沒有，創(chuàng)建該文件夾，并創(chuàng)建settings.xml文件，修改其中的配置（也可以從其他地方復(fù)制過來）：cd ll -amkdir .m2touch settings.xml（創(chuàng)建文件） cp /usr/settings.xml /home/jenkins/.m2（從其他地方復(fù)制）5. 配置項目自動部署5.1. 執(zhí)行上一章節(jié)中【配置免密碼登錄web服務(wù)器】。5.2. 新建點擊新建按鈕，填寫item名稱，選擇構(gòu)建一個maven項目點擊OK5.3. 源碼管理選擇Subversion，填寫項目的svn路徑第一次錄入svn地址時，會出現(xiàn)該錯誤，點擊enter credential，填寫svn的用戶名密碼就可以了。5.4. 構(gòu)建觸發(fā)器表達式是5位，分別表示分（0-59）、時（0-23）、天（1-31）、月（1-2）、星期（0-7,0和7都表示周日）。基本上與cron表達式一致。特別的H/n，表示每多長時間。5.5. PreSteps執(zhí)行步驟無特殊需求，則不需要填寫。5.6. Build（部分配置項是jenkins2.0以后的）填寫maven命令如果需要特殊配置，例如指定自定義的maven的settings.xml地址等，則點擊高級選項5.7. PostSteps執(zhí)行步驟這一步是自動部署的重點，在這里增加Execute shell（Windows就是batch command）。選擇 Run only if build succeeds，填寫執(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è)置默認是構(gòu)建失敗通知勾線郵件通知，填寫接收郵件即可。5.9. 構(gòu)建后操作（部分配置項是jenkins2.0以后的）如果項目構(gòu)建并自動部署成功后，想要郵件通知測試人員，那么需要在這里配置。點擊最下邊的advanced settings點擊Triggers，選擇success，然后在配置如下5.10. 保存。6. 常見問題及注意事項1. 執(zhí)行遠程命令時，報錯Host key verification failed.（Linux下）這說明jenkins服務(wù)器無法免密碼登錄web服務(wù)器執(zhí)行命令。需要按照那一章節(jié)，再重新執(zhí)行一下。2. 通過遠程命令啟動tomcat，報錯：Neither the JAVA_HOME nor the JRE_HOME environment variable is defined原因：因為啟動tomcat會調(diào)用tomcat安裝文件中的startup.sh，而它調(diào)用了catalina.sh則調(diào)用了setclasspath.sh。因此需要在setclasspath.sh的開頭手動聲明環(huán)境變量。（windows相同）解決方案：用vim打開tomcat的bin目錄下的setclasspath.sh，添加JAVA_HOME和JRE_HOME兩個環(huán)境變量（下圖紅色方框內(nèi)），兩個環(huán)境變