自動化構(gòu)建部署安裝手冊培訓(xùn)資料模板

年4月19日自動化構(gòu)建部署安裝手冊培訓(xùn)資料模板資料內(nèi)容僅供您學(xué)習(xí)參考，如有不當(dāng)或者侵權(quán)，請聯(lián)系改正或者刪除。自動化構(gòu)建部署安裝手冊07月目錄TOC\o"1-3"\h\z731.編寫目的 440952.版本要求 4286243.準(zhǔn)備工作 41174.安裝部署 4264764.1.安裝JDK 4113314.1.1.版本說明 4254014.1.2.安裝步驟 455944.1.3.環(huán)境配置 5326674.1.4.測試JDK 5258214.2.安裝maven 559404.3.安裝tomcat 6155624.3.1.版本說明 6116214.3.2.安裝步驟 6127844.3.3.測試tomcat 6291624.3.4.啟動與停止 759154.3.5.環(huán)境配置 774.3.6.設(shè)置隨機啟動 78290854.4.安裝jenkens 9134464.4.1.版本說明 937404.4.2.下載安裝包并部署 9238354.4.3.配置jenkins環(huán)境變量 9194024.4.4.獲取管理員密碼 10245534.4.5.配置管理員信息 12304574.4.6.安裝插件 1270954.4.7.全局設(shè)置 138024.4.8.系統(tǒng)設(shè)置 14208944.4.9.郵箱通知配置 1517584.4.10.用戶權(quán)限配置 24143884.5.安裝sonarQube 25223654.5.1.版本說明 25115364.5.2.下載安裝包 25277434.5.3.安裝中文包 2680454.5.4.創(chuàng)立數(shù)據(jù)庫 26237464.5.5.修改配置文件 26258504.5.6.服務(wù)啟動停止 261524.5.7.測試 27292124.6.安裝SonarQubeScanner 27278824.6.1.版本說明 27310084.6.2.下載安裝包 27242084.6.3.配置scanner 27205364.6.4.Jenkins配置Scanner 2753184.6.5.安裝sonarQube插件 28154215.創(chuàng)立項目 30249325.1.項目基本情況 30282895.2.源碼管理 3091885.3.構(gòu)建觸發(fā)器 31138845.4.構(gòu)建環(huán)境配置 32198735.5.配置sonarQube 33108415.6.編譯環(huán)境配置 35166215.7.指定打包類型 35303785.8.容器遠程部署 36107375.9.SSH遠程部署 37編寫目的實現(xiàn)項目代碼自動化構(gòu)建、打包、發(fā)布、測試、部署。版本要求軟件版本說明jenkins2.62.6以上版本必須jdk1.8及以上jdk1.8tomcat8.0maven3.3.9sonarQube6.4SonarQubeScanner3.0.3centos7.2準(zhǔn)備工作服務(wù)器硬件要求:cpu4核心,內(nèi)存16g,硬盤40g,centos7安裝部署安裝JDK版本說明jjdk-7u80-linux-x64.tar.gz。安裝步驟1、登錄服務(wù)器。2、新建/usr/java文件夾,將jdk-8u112-linux-x64.tar.gz上傳放到該文件夾中,并將工作目錄切換到/usr/java目錄下。#cd/usr#mkdirjava3、解壓JDK,在/usr/java多了一個jdk1.8.0_112文件夾。#tar-zxvf

jdk-8u112-linux-x64.tar.gz環(huán)境配置#vi/etc/profile在profile底部添加如下內(nèi)容#jdk環(huán)境變量配置exportJAVA_HOME=/usr/java/jdk1.8.0_112exportPATH=$JAVA_HOME/bin:$PATHexportCLASSPATH=.執(zhí)行如下命令使環(huán)境變量配置生效。#source/etc/profile測試JDK1、使用javac和java命令,不會出現(xiàn)commandnotfound錯誤。2、使用java-version,出現(xiàn)版本為javaversion"1.8.0_112"。3、echo$JAVA_HOME,echo$CLASSPATH,echo$PATH,看看自己的配置是否都正確。至此jdk安裝配置已經(jīng)完成。安裝maven1、下載maven部署包將maven上傳到/opt下并解壓2、配置環(huán)境變量#vi/etc/profile添加如下export

MAVEN_HOME=/opt/maven3.5export

PATH=$MAVEN_HOME/bin:$PATH

保存后,執(zhí)行#source/etc/profile3、測試是否成功mvn-v或echo$MAVEN_HOME4、配置本地倉庫修改conf下面settting.xml文件安裝tomcat版本說明apache-tomcat-8.5.9.tar.gz安裝步驟1、登錄服務(wù)器。2、將apache-tomcat-8.5.9.tar.gz上傳放到/usr/local目錄下。3、解壓tomcat。#tar-zxvf

apache-tomcat-8.5.9.tar.gz修改文件夾名稱為tomcat。#mv

apache-tomcat-8.5.9tomcat8測試tomcat1、啟動服務(wù)#/usr/local/tomcat8/bin/startup.sh瀏覽器訪問

:8080/,如::8080/注意:如果訪問不成功可能是防止墻沒有關(guān)閉。查看防火墻狀態(tài)#firewall-cmd--state關(guān)閉防火墻#systemctlstopfirewalld禁止開機啟動#systemctldisable

firewalld3、查看tomcat進程

#ps-ef|grepjava#ps-ef|greptomcat啟動與停止1、啟動服務(wù)#/usr/local/tomcat8/bin/startup.sh2、停止服務(wù)#/usr/local/tomcat8/bin/shutdown.sh環(huán)境配置1、配置JVM修改tomcat下bin目錄下catalina.bat文件1、linux配置,第二行添加。注意:具體參數(shù)根據(jù)環(huán)境配置,示例內(nèi)存8g。JAVA_OPTS="-server-Xms4096m-Xmx4096m-XX:PermSize=128M-XX:MaxPermSize=256m"2、windows配置,第一行添加setJAVA_OPTS=-server-Xms4096m-Xmx4096m-XX:PermSize=128M-XX:MaxPermSize=256m設(shè)置隨機啟動1、創(chuàng)立啟動用戶#useraddtomcat2、添加啟動腳本#vi/etc/rc.d/init.d/tomcat添加如下內(nèi)容并保存,設(shè)置啟動權(quán)限為tomcat。#!/bin/bash##starguolinytomcat啟動腳本#/etc/rc.d/init.d/tomcat8#initscriptfortomcatprecesses##processname:tomcat#description:tomcatisaj2seserver#chkconfig:23458616#description:StartuptheTomcatservletengine.if[-f/etc/init.d/functions];then./etc/init.d/functionselif[-f/etc/rc.d/init.d/functions];then./etc/rc.d/init.d/functionselseecho-e"\atomcat:unabletolocatefunctionslib.Cannotcontinue."exit-1fiRETVAL=$?CATALINA_HOME="/usr/local/tomcat8"case"$1"instart)if[-f$CATALINA_HOME/bin/startup.sh];thenecho$"StartingTomcat"su-c$CATALINA_HOME/bin/startup.shtomcatfi;;stop)if[-f$CATALINA_HOME/bin/shutdown.sh];thenecho$"StoppingTomcat"su-c$CATALINA_HOME/bin/shutdown.shtomcatfi;;*)echo$"Usage:$0{start|stop}"exit1;;esacexit$RETVAL注意:只需要修改CATALINA_HOME="/usr/local/tomcat8",指tomcat安裝路徑。2、添加權(quán)限#chmod

755

/etc/rc.d/init.d/tomcat

#chkconfig--addtomcat

#chkconfig

--level

2345

tomcat

on3、重啟電腦測試是否生效瀏覽器訪問

:8080/,如::8080/安裝jenkens版本說明Jenkins2.6下載安裝包并部署#cd/usr/local/tomcat8/webapps#wget配置jenkins環(huán)境變量設(shè)置jenkins數(shù)據(jù)(下載代碼、插件等)保存路徑#cd/opt#mkdirjenkins#vi/etc/profile添加如下內(nèi)容JENKINS_HOME=/opt/jenkins#source/etc/profile驗證是否配置環(huán)境變量成功#echo$JENKINS_HOME獲取管理員密碼啟動tomcat后,

訪問http://IP:8080/jenkins按提示/jenkins/secrets/initialAdminPassword獲取管理員密碼#cat/jenkins/secrets/initialAdminPassword復(fù)制密碼到提示框點擊默認(rèn)安裝插件選擇第一個安裝,耐心等待。配置管理員信息設(shè)置管理員賬號密碼等信息,點擊點擊能夠進入jenkins進行配置。安裝插件1、Maven插件

MavenIntegrationplugin2、發(fā)布插件

DeploytocontainerPlugin

支持將代碼部署到tomcat容器3、git插件

Gitplugin4、svn插件

SubversionPlug-in和SVNPublisherplugin5、發(fā)送郵件插件

EmailExtensionPlugin全局設(shè)置系統(tǒng)管理--GlobalToolConfiguration--配置JDK、Maven、git配置maven配置jdk配置項目編譯時需要的jdk版本。注意:當(dāng)前我們項目都jdk1.7編譯的,因此需要在系統(tǒng)安裝一個jdk1.7,官網(wǎng)下載一個tar包解壓即可,不用配置環(huán)境變量。配置maven系統(tǒng)設(shè)置-Xms256m-Xmx512m-Dfile.encoding=UTF-8(注意:具體參數(shù)根據(jù)環(huán)境配置)郵箱通知配置jenkins內(nèi)置的郵件功能使用email-ext插件擴展的郵件功能1、系統(tǒng)管理－系統(tǒng)設(shè)置,先設(shè)置發(fā)件人的郵件在"Jenkins

Location"設(shè)置系統(tǒng)管理員地址(必須設(shè)置)2、系統(tǒng)管理－系統(tǒng)設(shè)置,再設(shè)置全局設(shè)置:在"郵件通知"部分配置發(fā)送郵件的用戶名、密碼(注意這里的密碼使用的是163郵箱設(shè)置的"客戶端授權(quán)碼",不是登陸密碼,建議不用QQ郵箱,會容易導(dǎo)致發(fā)送失敗)3、勾選"經(jīng)過發(fā)送測試郵件測試配置",填入測試收件人,點擊"Test

Configuration"到qq郵箱里check新郵件email-ext插件配置Jenkins默認(rèn)提供了一個郵件通知,能在構(gòu)建失敗、構(gòu)建不穩(wěn)定等狀態(tài)后發(fā)送郵件?？墒撬旧碛泻芏嗑窒扌?比如它的郵件通知無法提供詳細的郵件內(nèi)容、無法定義發(fā)送郵件的格式、無法定義靈活的郵件接收配置等等。在這樣的情況下,我們找到了Jenkins?Email?Extension?Plugin。該插件能允許你自定義郵件通知的方方面面,比如在發(fā)送郵件時你能夠自定義發(fā)送給誰,發(fā)送具體什么內(nèi)容等等。email-ext插件可根據(jù)構(gòu)建的結(jié)果,發(fā)送構(gòu)建報告,給當(dāng)前的committer(用git做代碼管理)

1)該插件支持jenkins1.5以上的版本,插件的安裝此處略,若您可選插件的頁卡的列表是空的,先去高級頁面檢查更新下。

2)插件用于job配置頁面,添加構(gòu)建后步驟”EditableEmailNotification”1、系統(tǒng)管理－系統(tǒng)設(shè)置,先設(shè)置全局:詳細參數(shù)說明如下:1.OverrideGlobalSettings:如果不選,該插件將使用默認(rèn)的E-mailNotification通知選項。反之,您能夠經(jīng)過指定不同于(默認(rèn)選項)的設(shè)置來進行覆蓋。2.DefaultContentType:指定構(gòu)建后發(fā)送郵件內(nèi)容的類型,有Text和HTML兩種.3.UseList-IDEmailHeader:為所有的郵件設(shè)置一個List-ID的郵件信頭,這樣你就能夠在郵件客戶端使用過濾。它也能阻止郵件發(fā)件人大部分的自動回復(fù)(諸如離開辦公室、休假等等)。你能夠使用你習(xí)慣的任何名稱或者ID號,可是她們必須符合如下其中一種格式(真實的ID必須要包含在<和>標(biāo)記里):<>BuildNotifications<>”BuildNotifications”<>4.Add'Precedence:bulk'EmailHeader:設(shè)置優(yōu)先級,5.DefaultRecipients:自定義默認(rèn)電子郵件收件人列表。如果沒有被項目配置覆蓋,該插件會使用這個列表。您能夠在項目配置使用$DEFAULT_RECIPIENTS參數(shù)包括此默認(rèn)列表,以及添加新的地址在項目級別。添加抄送:cc:電子郵件地址例如,CC:6.ReplyToList:回復(fù)列表,Acommaseparatedlistofe-mailaddressestouseintheReply-Toheaderoftheemail.Thisvaluewillbeavailableas$DEFAULT_REPLYTOintheprojectconfiguration.7.Emergencyreroute:如果這個字段不為空,所有的電子郵件將被單獨發(fā)送到該地址(或地址列表)。8.ExcludedCommitters:防止郵件被郵件系統(tǒng)認(rèn)為是垃圾郵件,郵件列表應(yīng)該沒有擴展的賬戶名(如:@),而且使用逗號分隔9.DefaultSubject:自定義郵件通知的默認(rèn)主題名稱。該選項能在郵件的主題字段中替換一些參數(shù),這樣你就能夠在構(gòu)建中包含指定的輸出信息。10.MaximumAttachmentSize:郵件最大附件大小。11.DefaultContent:自定義郵件通知的默認(rèn)內(nèi)容主體。該選項能在郵件的內(nèi)容中替換一些參數(shù),這樣你就能夠在構(gòu)建中包含指定的輸出信息。12.DefaultPre-sendScript:默認(rèn)發(fā)送前執(zhí)行的腳本(注:grooy腳本,這是我在某篇文章上看到的,不一定準(zhǔn)確)。13.EnableDebugMode:啟用插件的調(diào)試模式。這將增加額外的日志輸出,構(gòu)建日志以及Jenkins的日志。在調(diào)試時是有用的,但不能用于生產(chǎn)。14.EnableSecurity:啟用時,會禁用發(fā)送腳本的能力,直接進入Jenkins實例。如果用戶試圖訪問Jenkins管理對象實例,將拋出一個安全異常。15.ContentTokenReference:郵件中能夠使用的變量,所有的變量都是可選的。

2、項目配置1)要想在一個項目中使用email-ext插件,你首先必須在項目配置頁激活它。在構(gòu)建后操作——”Add

Post-build

Actions”選項中勾選”Editable

Email

Notification”標(biāo)簽。如下圖:項目基本配置參數(shù)說明:當(dāng)插件激活后你就能編輯如下字段(只列出常見的字段):ProjectRecipientList:這是一個以逗號(或者空格)分隔的收件人郵件的郵箱地址列表。允許您為每封郵件指定單獨的列表。Ps:如果你想在默認(rèn)收件人的基礎(chǔ)上添加收件人:$DEFAULT_RECIPIENTS,<新的收件人>DefaultSubject:允許你配置此項目郵件的主題。DefaultContent:跟DefaultSubject的作用一樣,可是是替換郵件內(nèi)容。AttachBuildLog:附件構(gòu)建日志。CompressBuildLogbeforesending:發(fā)送前壓縮生成日志(zip格式)。

2)點擊高級,設(shè)置觸發(fā)器:(注意:所有的觸發(fā)器都只能配置一次)觸發(fā)器參數(shù)說明:Failure:即時發(fā)送構(gòu)建失敗的郵件。如果”StillFailing”觸發(fā)器已配置,而上一次構(gòu)建的狀態(tài)是”Failure”,那么”StillFailing”觸發(fā)器將發(fā)送一封郵件來替代(它)。Unstable:即時發(fā)送構(gòu)建不穩(wěn)固的郵件。如果”StillUnstable”觸發(fā)器已配置,而上一次構(gòu)建的狀態(tài)是”Unstable”,那么”StillUnstable”觸發(fā)器將發(fā)送一封郵件來替代(它)。StillFailing:如果兩次或兩次以上連續(xù)構(gòu)建的狀態(tài)為”Failure”,發(fā)送該郵件。Success:如果構(gòu)建的狀態(tài)為”Successful”發(fā)送郵件。如果”Fixed”已配置,而上次構(gòu)建的狀態(tài)為”Failure”或”Unstable”,那么”Fixed”觸發(fā)器將發(fā)送一封郵件來替代(它)。Fixed:當(dāng)構(gòu)建狀態(tài)從”Failure”或”Unstable”變?yōu)椤盨uccessful”時發(fā)送郵件。StillUnstable:如果兩次或兩次以上連續(xù)構(gòu)建的狀態(tài)為”Unstable”,發(fā)送該郵件。BeforeBuild:當(dāng)構(gòu)建開始時發(fā)送郵件。對于內(nèi)容,你可能注意到了這里調(diào)用了個‘html.jelly’的模板,這是插件內(nèi)置的,直接用即可。當(dāng)然也能夠自己寫jelly文件,確保放置jenkins/home/email-template下以供jenkins調(diào)用。

<!DOCTYPEhtml><html><head><metacharset="UTF-8"><title>${ENV,var="JOB_NAME"}-第${BUILD_NUMBER}次構(gòu)建日志</title></head><bodyleftmargin="8"marginwidth="0"topmargin="8"marginheight="4"offset="0"><tablewidth="95%"cellpadding="0"cellspacing="0"style="font-size:11pt;font-family:Tahoma,Arial,Helvetica,sans-serif"><tr><td>(本郵件是程序自動下發(fā)的,請勿回復(fù)!)</td></tr><tr><td><h2><fontcolor="#0000FF">構(gòu)建結(jié)果-${BUILD_STATUS}</font></h2></td></tr><tr><td><br/><b><fontcolor="#0B610B">構(gòu)建信息</font></b><hrsize="2"width="100%"align="center"/></td></tr><tr><td><ul><li>項目名稱 : ${PROJECT_NAME}</li><li>構(gòu)建編號 : 第${BUILD_NUMBER}次構(gòu)建</li><li>SVN 版本: ${SVN_REVISION}</li><li>觸發(fā)原因: ${CAUSE}</li><li>構(gòu)建日志: <ahref="${BUILD_URL}console">${BUILD_URL}console</a></li><li>構(gòu)建  Url : <ahref="${BUILD_URL}">${BUILD_URL}</a></li><li>工作目錄 : <ahref="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li><li>項目  Url : <ahref="${PROJECT_URL}">${PROJECT_URL}</a></li></ul></td></tr><tr><td><b><fontcolor="#0B610B">ChangesSinceLastSuccessfulBuild:</font></b><hrsize="2"width="100%"align="center"/></td></tr><tr><td><ul><li>歷史變更記錄:<ahref="${PROJECT_URL}changes">${PROJECT_URL}changes</a></li></ul>${CHANGES_SINCE_LAST_SUCCESS,reverse=true,format="ChangesforBuild#%n:<br/>%c<br/>",showPaths=true,changesFormat="<pre>[%a]<br/>%m</pre>",pathFormat="    %p"}</td></tr><tr><td><b>FailedTestResults</b><hrsize="2"width="100%"align="center"/></td></tr><tr><td><prestyle="font-size:11pt;font-family:Tahoma,Arial,Helvetica,sans-serif">$FAILED_TESTS</pre><br/></td></tr><tr><td><b><fontcolor="#0B610B">構(gòu)建日志(最后100行):</font></b><hrsize="2"width="100%"align="center"/></td></tr><!--<tr><td>TestLogs(iftesthasran):<ahref="${PROJECT_URL}ws/TestResult/archive_logs/Log-Build-${BUILD_NUMBER}.zip">${PROJECT_URL}/ws/TestResult/archive_logs/Log-Build-${BUILD_NUMBER}.zip</a><br/><br/></td></tr>--><tr><td><textareacols="80"rows="30"readonly="readonly"style="font-family:CourierNew">${BUILD_LOG,maxLines=100}</textarea></td></tr></table></body></html>用戶權(quán)限配置1、安裝用戶管理插件Role-basedAuthorizationStrategy2、配置用戶登錄才能夠操作系統(tǒng)管理--ConfigureGlobalSecurity2、項目矩陣授權(quán)策略安裝sonarQube版本說明當(dāng)前最新版本6.4下載安裝包,當(dāng)前版本是6.4。解壓后上傳到服務(wù)器對應(yīng)位置,如:/opt/目錄下安裝中文包下載對應(yīng)版本中文包,本例子使用sonar-l10n-zh-plugin-1.16版本,將語言包放在/extensions/plugins/下,重啟即可。創(chuàng)立數(shù)據(jù)庫createdatabasesonarcharactersetutf8collateutf8_general_ci;createusersonaridentifiedby'sonar';grant

all

on

sonar.*

to

sonar;flush

privileges;修改配置文件修改config下sonar.conf文件,數(shù)據(jù)庫連接信息、https設(shè)置等1、數(shù)據(jù)庫連接mysqlsonar.jdbc.username=sonarsonar.jdbc.password=sonarsonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance&useSSL=false2、端口sonar.web.port=90003、設(shè)置登錄賬號密碼sonar.web.port=90004、配置環(huán)境變量#vi/etc/profile添加exportSONAR_HOME=/opt/sonarqube-6.4#source/etc/profile服務(wù)啟動停止1、進入sonarbin目錄如bin/linux-x86-64,運行如下命令:./sonar.shrestart

重啟服務(wù)2、其它常見的命令如下:./sonar.shstop

停止服務(wù)

./sonar.shstart

啟動服務(wù)3、設(shè)置隨機啟動。測試第一次啟動會比較慢,需要初始化數(shù)據(jù)庫數(shù)據(jù)http://IP:9000admin/admin安裝SonarQubeScanner版本說明sonar-scanner-cli-78-linux.zip下載安裝包解壓后上傳到/opt目錄下。配置scanner見conf目錄下perties文件。默認(rèn)是連接本地sonar服務(wù)。Jenkins配置Scanner1)系統(tǒng)管理--GlobalToolConfiguration--SonarQubeScanner安裝sonarQube插件在Jenkins插件管理中添加SonarQubeScannerforJenkins,點擊安裝即可。配置sonarQube1)系統(tǒng)管理--系統(tǒng)設(shè)置分別輸入sonarQube的名稱、服務(wù)器URL、服務(wù)器認(rèn)證令牌(見下面生成令牌方法)。獲取令牌方法登錄sonarQube,菜單–》配置–》權(quán)限–》用戶–》TOKENS–》Generate生成token,將生成token添加到此處,完成添加創(chuàng)立項目項目基本情況源碼管理在Credentials點擊Add,創(chuàng)立SVN連接賬號構(gòu)建觸發(fā)器觸發(fā)器說明備注構(gòu)建一個SNAPSHOT依賴關(guān)系構(gòu)建當(dāng)job依賴的快照版本被build時,執(zhí)行本job觸發(fā)遠程構(gòu)造Buildafterotherprojectsarebuilt當(dāng)本job依賴的job被build時,執(zhí)行本jobBuildperiodically隔一段時間build一次,不論版本庫代碼是否發(fā)生變化,一般不會采用此種方式。例如:示例:H8**1-5星期一到星期五8點定時執(zhí)行構(gòu)建。第一個參數(shù)代表的是分鐘minute,取值0~59;第二個參數(shù)代表的是小時hour,取值0~23;第三個參數(shù)代表的是天day,取值1~31;第四個參數(shù)代表的是月month,取值1~12;最后一個參數(shù)代表的是星期week,取值0~7,0和7都是表示星期天。因此0****表示的就是每個小時的第0分鐘執(zhí)行一次構(gòu)建。PollSCM根據(jù)SCM軟件的版本號,定時檢查源碼變更。如果有更新,則checkout最新code,然后執(zhí)行構(gòu)建動作。否則,不進行build,一般采用這種方式示例:H/5****每五分鐘去檢查一下遠程倉庫,看代碼是否發(fā)生變化。構(gòu)建環(huán)境配置配置sonarQube1、構(gòu)建環(huán)境