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

第一次登錄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站點的信息吧 *_*
Company Name=BlogJava
Company Logo=http://m.tkk7.com/images/logo.gif
Company URL=http://m.tkk7.com/
提交之后會出現(xiàn)如下畫面(能夠看到BlogJava的logo嗎 *_*)

使用初始配置時設(shè)置的用戶名及密碼,就可以登錄Continuum控制臺了。
2.5 修改POM文件
在目錄Continuum_Maven中執(zhí)行如下命令,將Maven工程demo重新下載一次
svn checkout file:///SVN_Repository/demo demo
為了能被Continuum使用,且能與Subversion進(jìn)行配合,需要對原來Maven工程中的POM文件進(jìn)行修改。在每個POM中加入如下形式的語句:
<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)前所在工程名一致,如對于demo目錄中的POM,ProjectName就是demo。這三個文件修改完畢之后,將它們都提交到Subversion服務(wù)器中,在各個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"
為了每個工程都可以被單獨地運行,需要將整個demo及其子工程都安裝到Maven倉庫中,僅需要在Maven_Demo 目錄下執(zhí)行命令:
mvn install
2.6 添加Maven工程
登錄到Continuum控制臺后,點擊左邊“Add Project”組中的“Maven 2.0+ Project”。添加Maven2工程有兩種情況:輸入POM文件的URL;直接上傳POM文件。前者適用于任何Maven工程;后者只能適用于沒有module,即無子工程的Maven工程。由于本文使用的Maven工程demo中有兩個子工程,所以只能使用前一種方法。

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

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

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

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

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

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

4 小結(jié)
根據(jù)前面的描述,應(yīng)該可以對Continuum的使用有些感性上的認(rèn)識了。由于Continuum是Maven的子項目,它內(nèi)置支持Maven2,所以能夠與Maven進(jìn)行良好的集成使用。現(xiàn)時,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語法規(guī)則. http://www.opensymphony.com/quartz/api/org/quartz/CronTrigger.html