Continuum入門--實(shí)例
本文雖然是Continuum的入門,但并不涉及Continuum的歷史、下載與安裝,這些內(nèi)容可以到 Continuum的官方網(wǎng)站 (http://maven.apache.org/continuum/) 上了解。本文主要是以一個(gè)實(shí)例來(lái)闡述使用 Continuum的基本方法,而其中將使用的Maven工程是《Maven入門--概念與實(shí)例》中的實(shí)例(該文末有下載鏈接)。注:轉(zhuǎn)載時(shí)請(qǐng)注明原作者(jiangshachina)及出處(http://www.aygfsteel.com/jiangshachina)!
1 使用持續(xù)集成的好處
1.1 較早提交,經(jīng)常提交
當(dāng)開發(fā)者有規(guī)律性地提交文件時(shí),持續(xù)集成將是最高效的。這就是意味著,不能提交不完全的代碼,而是保持每次的改動(dòng)不大,并且有很好的測(cè)試。這就可以更好地發(fā)現(xiàn)代碼中的錯(cuò)誤。
1.2 盡可能頻繁的構(gòu)建
頻繁的Build可能要受到需要進(jìn)行Build的工作量,以及進(jìn)行Build工作的機(jī)器的性能的影響。但頻繁的Build確實(shí)可以在開發(fā)人員轉(zhuǎn)移注意力之前,盡可能早的發(fā)現(xiàn)錯(cuò)誤。任何時(shí)候,任何一個(gè)提交的發(fā)生,Continuum都可以觸發(fā)一個(gè)Build工作。這就意味著,這些Build工作應(yīng)該更快,對(duì)于大量的Build工作或性能測(cè)試
1.3 創(chuàng)建一個(gè)穩(wěn)定的環(huán)境
如果該Build不是其它開發(fā),測(cè)試或產(chǎn)品環(huán)境中的一員,那么就可以避免定制JDK或其它的本地設(shè)置。如果在持續(xù)集成環(huán)境中,一個(gè)Build工作失敗了,它會(huì)被從引起它的原因的修改中隔離出來(lái),可以獨(dú)立于運(yùn)行環(huán)境來(lái)被使用。
1.4 運(yùn)行干凈的構(gòu)建
快速、重復(fù)地構(gòu)建是十分有用的,同樣重要的是,不會(huì)由于舊的Build狀態(tài)而發(fā)生失敗的Build工作。有規(guī)律的考慮問題,就能得到干凈的構(gòu)建。Continuum默認(rèn)就是進(jìn)行干凈的Build工作,未來(lái)它還可以允許開發(fā)者根據(jù)所選的時(shí)間表去請(qǐng)求一個(gè)初始的checkout。
2 實(shí)例
2.1 構(gòu)想
本實(shí)例中需要持續(xù)集成的Maven工程是《Maven入門--概念與實(shí)例》中的Demo。使用的SCM是Subversion,即假定已經(jīng)安裝好了Subversion服務(wù)器和命令行客戶端。我們的目標(biāo)是使用Continuum對(duì)Maven工程demo(包括它的子工程)進(jìn)行定時(shí)的持續(xù)集成。在本文的環(huán)境中有如下路徑:
Continuum_Home=D:\continuum
SVN_Repoitory=E:\svn-repo\repository
Maven_Demo=D:\maven\demo
Continuum_Maven=D:\maven\continuum // 該目錄存放從Subversion下載的Maven Demo工程
2.2 初始化Subversion倉(cāng)庫(kù)
生成倉(cāng)庫(kù):svnadmin create SVN_Repository
將Maven_Demo中的文件導(dǎo)入到倉(cāng)庫(kù):
svn import Maven_Demo file:///SVN_Repoitory/demo -m "initial import demo"
重新下載倉(cāng)庫(kù)中的文件(在目錄Continuum_Maven中運(yùn)行如下命令):
svn checkout file:///SVN_Repoitory/demo demo
2.3 啟動(dòng)Continuum
假設(shè)此時(shí)已經(jīng)安裝了Continuum,但還沒有運(yùn)行它。要運(yùn)行Continuum,可以雙擊Continuum_Home\bin\win32\run.bat文件。對(duì)于第一次運(yùn)行,會(huì)報(bào)一些錯(cuò)誤:
……
WARN RDBMS - Error initialising derby schema : Schema 'SA' does not exist
ERROR 42Y07: Schema 'SA' does not exist
……
這種情況是正常的,因?yàn)镃ontinuum后臺(tái)使用的是Apache Derby數(shù)據(jù)庫(kù),在第一次運(yùn)行之前,Continuum所需要的一些表和數(shù)據(jù)并不存在。但Continuum會(huì)初始化這些數(shù)據(jù),當(dāng)?shù)?次啟動(dòng)Continuum時(shí),這些錯(cuò)誤就不會(huì)出現(xiàn)了。WARN RDBMS - Error initialising derby schema : Schema 'SA' does not exist
ERROR 42Y07: Schema 'SA' does not exist
……
Continuum服務(wù)器默認(rèn)使用8080端口,如果之前該端口已被占用了,那么啟動(dòng)將失敗。為了解決這個(gè)問題,我們需要修改jar文件Continuum_Home\apps\continuum-plexus-application-1.0.3.jar中的\conf\application.xml文件。在該文件中查找8080(該值是唯一的),將改它為你所指定的端口值,本文是使用8081。經(jīng)過(guò)上述過(guò)程后,Continuum服務(wù)器應(yīng)該就可以正常啟動(dòng)了。下面將討論Continuum的初始化配置。
2.4 初始化配置
在瀏覽器中使用地址http://localhost:8081/continuum登錄Continuum控制臺(tái)界面,如下圖所示。

第一次登錄Continuum后,需要進(jìn)行一些配置。主要包括用戶名/密碼,工作區(qū)目錄,Build輸出目錄以及公司信息。主要參數(shù)值如下所示:
Working Directory=D:\continuum\workspace
Build Output Directory=D:\continuum\workspace\output
Base URL=http://localhost:8081/continuum/servlet/continuum
// 這里的Company信息就借用此Blog站點(diǎn)的信息吧 *_*
Company Name=BlogJava
Company Logo=http://www.aygfsteel.com/images/logo.gif
Company URL=http://www.aygfsteel.com/
提交之后會(huì)出現(xiàn)如下畫面(能夠看到BlogJava的logo嗎 *_*)

使用初始配置時(shí)設(shè)置的用戶名及密碼,就可以登錄Continuum控制臺(tái)了。
2.5 修改POM文件
在目錄Continuum_Maven中執(zhí)行如下命令,將Maven工程demo重新下載一次
svn checkout file:///SVN_Repository/demo demo
為了能被Continuum使用,且能與Subversion進(jìn)行配合,需要對(duì)原來(lái)Maven工程中的POM文件進(jìn)行修改。在每個(gè)POM中加入如下形式的語(yǔ)句:
<project>
……
<ciManagement>
<system>Continuum</system>
<url>http://localhost:8081/continuum/servlet/continuum</url>
<notifiers>
<notifier>
<type>mail</type>
<address>jiangshachina@163.com</address>
</notifier>
</notifiers>
</ciManagement>
<scm>
<connection>scm:svn:file://localhost/SVN_Repository/ProjectName</connection>
</scm>
……
</project>
其中ProjectName要與POM當(dāng)前所在工程名一致,如對(duì)于demo目錄中的POM,ProjectName就是demo。這三個(gè)文件修改完畢之后,將它們都提交到Subversion服務(wù)器中,在各個(gè)POM的當(dāng)前目錄下執(zhí)行命令:……
<ciManagement>
<system>Continuum</system>
<url>http://localhost:8081/continuum/servlet/continuum</url>
<notifiers>
<notifier>
<type>mail</type>
<address>jiangshachina@163.com</address>
</notifier>
</notifiers>
</ciManagement>
<scm>
<connection>scm:svn:file://localhost/SVN_Repository/ProjectName</connection>
</scm>
……
</project>
svn commit pom.xml -m "my settings"
為了每個(gè)工程都可以被單獨(dú)地運(yùn)行,需要將整個(gè)demo及其子工程都安裝到Maven倉(cāng)庫(kù)中,僅需要在Maven_Demo 目錄下執(zhí)行命令:
mvn install
2.6 添加Maven工程
登錄到Continuum控制臺(tái)后,點(diǎn)擊左邊“Add Project”組中的“Maven 2.0+ Project”。添加Maven2工程有兩種情況:輸入POM文件的URL;直接上傳POM文件。前者適用于任何Maven工程;后者只能適用于沒有module,即無(wú)子工程的Maven工程。由于本文使用的Maven工程demo中有兩個(gè)子工程,所以只能使用前一種方法。

只需要加載頂層工程的POM文件,Continuum會(huì)自動(dòng)加載其它moudel的POM文件。如上圖所示,在M2 POM Url中輸入:
file:///D:/maven/continuum/Demo/pom.xml
提交之后會(huì)看到如下的畫面,即表示Maven工程已經(jīng)被正確地加載到Continuum中了。

加載工程時(shí),Continuum會(huì)將這些工程分別下載到Working Directory(見2.4節(jié))中,并在 Build Output Directory(見2.4節(jié))中為每個(gè)工程 生成一個(gè)輸出目錄(開始只有一些log文件)。細(xì)心的朋友可能會(huì)發(fā)現(xiàn),當(dāng)上述工作完成之后,子工程“CE Maven Demo – App”和“CE Maven Demo – WebApp”的Build狀態(tài)仍然是“Queued Build”。其實(shí)這是Continuum的一個(gè)Bug!Continnum在許多情況下不會(huì)自動(dòng)刷新頁(yè)面,需要手動(dòng)刷新,即點(diǎn)擊“Show projects”按鈕。但請(qǐng)不要使用瀏覽器中的refresh按鈕,這樣可能會(huì)重新提交你的請(qǐng)求。這個(gè)Bug將在Continuum1.1中被修復(fù)。當(dāng)頁(yè)面刷新之后,App和WebApp的Build狀態(tài)將與Demo工程一致。
2.7 第一次Build
要Build任何一個(gè)Maven工程都十分簡(jiǎn)單,只需要點(diǎn)擊某個(gè)工程右邊“Build Now”按鈕就可以Build該工程了。如我們點(diǎn)擊demo工程對(duì)應(yīng)的“Build Now”按鈕,那么Continuum將按照demo中的POM文件執(zhí)行Build工作。當(dāng)Build完成后,可以顯示本次Build的結(jié)果狀態(tài):成功,失敗或錯(cuò)誤(但請(qǐng)隨時(shí)手動(dòng)刷新頁(yè)面^_^)。而Build次數(shù)也將從0改變?yōu)?。

點(diǎn)擊上圖表格中的列“Build”中的數(shù)字,將可以看到本次Build的詳細(xì)過(guò)程,如下圖所示。

2.8 設(shè)置時(shí)間表
前面已經(jīng)談過(guò),持續(xù)集成就需要進(jìn)行有規(guī)律的Build。即需要建立一個(gè)時(shí)間表,讓持續(xù)集成服務(wù)器按照這個(gè)表進(jìn)行Build。Continuum默認(rèn)的時(shí)間表為:每天的每一個(gè)整點(diǎn)進(jìn)行一次Build,即每天每隔一小時(shí)Build一次。我們也可以建立自己的時(shí)間表。點(diǎn)擊Administration組中的“Schedules”按鈕就可以發(fā)現(xiàn)當(dāng)前默認(rèn)使用的時(shí)間表,再點(diǎn)擊“Add”按鈕就可以添加新的時(shí)間表了,如下圖所示。

這些參數(shù)項(xiàng)中最關(guān)鍵的是Cron Expression,它定義了Continuum執(zhí)行Build的時(shí)間規(guī)則,它的語(yǔ)法規(guī)則請(qǐng)見參加資源[4]。上圖中規(guī)定的時(shí)間表是:在每天的14:00-14:59之間,每分鐘都要進(jìn)行一次Build。勾選上Enable復(fù)選框之后,再提交,該Schedule就可以被使用了。
為了使用新建的Schedule,我們需要進(jìn)入工程視圖頁(yè)面。點(diǎn)擊“Show Projects”-->工程名(如CE Maven Demo),就可以看到該工程的詳細(xì)信息,如下圖所示。

在工程視圖的Build Definitions項(xiàng)的Goals中可以發(fā)現(xiàn),使用的Schedule就是“DEFAULT_SCHEDULE”時(shí)間表。再點(diǎn)擊“Add”按鈕,并在Schedule下拉列表框中,請(qǐng)選擇剛剛新建的“My First Schedule”時(shí)間表(如下圖所示),最后再提交后,新的時(shí)間表將被采用。

4 小結(jié)
根據(jù)前面的描述,應(yīng)該可以對(duì)Continuum的使用有些感性上的認(rèn)識(shí)了。由于Continuum是Maven的子項(xiàng)目,它內(nèi)置支持Maven2,所以能夠與Maven進(jìn)行良好的集成使用?,F(xiàn)時(shí),Continuum也能夠支持Ant與Shell腳本工程。使用Continuum+Maven,能夠?qū)こ踢M(jìn)行干凈與頻繁的集成,可以提高Build效率并能促進(jìn)工程的健康發(fā)展。
5 參數(shù)資源
[1]Continuum官方網(wǎng)站. http://maven.apache.org/continuum/
[2]Continuum的參考文檔. http://maven.apache.org/continuum/guides/index.html
[3]Better Build with Maven. http://www.mergere.com/m2book_download.jsp
[4]Cron Expression語(yǔ)法規(guī)則. http://www.opensymphony.com/quartz/api/org/quartz/CronTrigger.html