Subversion 系統(tǒng)
多年來，并發(fā)版本系統(tǒng)（CVS）一直是在Linux上管理代碼或者文本的標(biāo)準(zhǔn)。作為基于RCS上建立但卻允許多用戶協(xié)作的系統(tǒng)而言，CVS記錄所有文件的修改信息。這對于程序開發(fā)者、網(wǎng)絡(luò)設(shè)計者和系統(tǒng)管理員而言，是非常有用的。
然而，CVS逐漸顯示出它的衰老，出現(xiàn)了相似的源代碼管理軟件。然而大多這種東西都是以牟利為主要目的的。
Subversion就是一種相對新鮮的源代碼管理系統(tǒng)。雖然事實上它還在不斷的反展之中，但是Subversion已經(jīng)是一個非常穩(wěn)定而且成熟的產(chǎn)品。它是一個全新的系統(tǒng)，其功能可以和CVS媲美，同時，它要比CVS更直觀，更容易操作。本文就Subversion的安裝和一些特殊功能作一個介紹。
安裝服務(wù)器端
下載Apache和SVN源碼包
從官方網(wǎng)站臺下載httpd-2.0.52.tar.gz,subversion-1.1.1.tar.gz
(因為redhat 9默認(rèn)安裝的Apache沒有并包含--enable-so選項，所以無法產(chǎn)生mod_dav_svn.沒有這個模塊，SVN就無法采用http方式運行，所以必須重新編譯新的Apache)
以root身份執(zhí)行：
#tar zxvf httpd-2.0.52.tar.gz
#cd httpd-2.0.52
#./configure --enable-dav --enable-so --enable-maintainer-mode
#make
#make install
此時會產(chǎn)生/usr/local/apache2目錄,接著執(zhí)行:
#tar zxvf subversion-1.1.1.tar.gz
#./configure --with-apxs=/usr/local/apache2/bin/apxs
# rm /usr/local/lib/libsvn*
# make clean && make && make install
此時會自動在/usr/local/apache2/conf/httpd.conf添加
LoadModule dav_svn_module ?modules/mod_dav_svn.so
安裝完成后,運行svnserver --version確認(rèn)版本為1.1.1。
SVN服務(wù)器安裝結(jié)束.
安裝客戶機(jī)端
window客戶機(jī)：
直接安裝TortoiseSVN-1.1.1-UNICODE_svn-1.1.1.msi，方法同一般軟件安裝相同。
Linux客戶機(jī)：
方法輿安裝服務(wù)器相同。
(注意redhat 9默認(rèn)安裝的SVN版本為0.17.1,它的客戶端命令svn無法輿新的SVN服務(wù)器通訊,必須重新安裝)
建立倉庫Repository
Subversion 的檔案庫是個中央倉儲, 用來存放任意數(shù)量項目的受版本控管資料,建立方法很簡單
#svnadmin create path/to/repos
舉個例子：
#svnadmin create /home/mysvn
#chown –R nobody /home/mysvn
運行服務(wù)器
Subversion服務(wù)器有兩種運行方式，一是可以作為Apache 2.0的一個模塊， 以WebDAV/DeltaV協(xié)議與外界連通；另外，也可使用Subversion 自帶的小型服務(wù)器程序svnserve。該程序使用的是自帶的通訊協(xié)議，可以很容易地透過SSH以
以http方式運行
在/usr/local/apache2/conf/httpd.conf中加入:
<Location /svn/repository>
?DAV svn
?SVNPath /home/mysvn
</Location>
在服務(wù)器的瀏覽器中輸入網(wǎng)址:
http://localhost/svn/repository/
這時候,你會看到這樣的顯示：
這表明服務(wù)器已經(jīng)以http方式正常運行了.
以svnserve方式運行
這種方式的運行又可以分為以下兩種(這和vsftp有些相似)
1) standalone mode
直接運行 #svnserve –d
運行 lsof -i :3690可以看到SVN服務(wù)器已經(jīng)在運行
2) xinetd mode
在/etc/xinetd.d/下生成svnserve文件，內(nèi)容如下
service svnserve
{
disable = no
socket_type ? ? ? ? ? ? = stream
protocol ? ? ? ? ? ? ? ? = tcp
wait ? ? ? ? ? ? ? ? ? ?= no
user ? ? ? ? ? ? ? ? ? ?= apache
server ? ? ? ? ? ? ? ? ?= /usr/local/bin/svnserve
server_args ? ? ? ? ? ? = -i
}
編輯 /etc/services 檔,加入底下兩行:
svnserve ? ? ? ?3690/tcp ? ? ? ? ? ? ? ? ? ? ? ?# Subversion svnserve
svnserve ? ? ? ?3690/udp ? ? ? ? ? ? ? ? ? ? ? ?# Subversion svnserve
重啟xinetd服務(wù)，運行 lsof -i :3690可以看到SVN服務(wù)器已經(jīng)在運行
客戶機(jī)訪問
客戶機(jī)的訪問方法輿服務(wù)器的運行方式有直接關(guān)系
window客戶機(jī)：
1) 服務(wù)器以http方式運行
安裝完TortoiseSVN-1.1.1-UNICODE_svn-1.1.1.msi后,在你想工作的目錄下點擊右鍵，執(zhí)行checkout，按上圖輸入即可。
2) 服務(wù)器以svnserve方式運行
同上的區(qū)別只是URL of repository變?yōu)?svn://svn服務(wù)器ip/home/mysvn
或者 svn+ssh://svn服務(wù)器ip/home/mysvn
(注意不是//svn服務(wù)器ip//svn/repository)
linux客戶機(jī)：
1) 服務(wù)器以http方式運行
執(zhí)行 #svn checkout http: //svn服務(wù)器ip/svn/repository
2) 服務(wù)器以svnserve方式運行
執(zhí)行 #svn checkout svn://svn服務(wù)器ip/home/mysvn
或者 #svn checkout svn+ssh://svn服務(wù)器ip/home/mysvn
客戶認(rèn)證機(jī)制
這輿服務(wù)器的運行方式有關(guān)
服務(wù)器以http方式運行
比如我們想給 Sally 與 Harry 送交存取檔案庫的權(quán)限. 首先, 我們必須把它們加入到密碼檔案.
# ### 第一次: 以 -c 建立檔案
# htpasswd -c /etc/svn-auth-file harry
New password: *****
Re-type new password: *****
Adding password for user harry
# htpasswd /etc/svn-auth-file sally
New password: *******
Re-type new password: *******
Adding password for user sally
#
接著,在/usr/local/apache2/conf/httpd.conf的加入:
<Location /svn/repository >
?DAV svn
?SVNPath /home/mycvs
?AuthType Basic
?AuthName "Subversion repository"
?AuthUserFile /etc/svn-auth-file
Require valid-user
</Location>
重新激活 Apache后，如果有人要訪問SVN服務(wù)器，系統(tǒng)會要求他輸入用戶名和密碼。 只有輸入Sally 或Harry的用戶名和相應(yīng)的密碼，才可以對檔案庫進(jìn)行修改和訪問
服務(wù)器以svnserve方式運行
默認(rèn)下客戶可以以匿名方式通過svn://方式任意訪問檔案庫，為了限制其權(quán)限，比如只允許讀操作，可以通過修改檔案庫conf子目錄中的svnseve.conf文件來實現(xiàn)。
#vi /home/mysvn/conf/svnseve.conf
修改[general]字段下內(nèi)容為：
anon-access = read
如果設(shè)為anon-access = none，則匿名用戶不可以通過svn://方式訪問檔案庫
為了實現(xiàn)用戶認(rèn)證,我們一般采用svn+ssh://訪問機(jī)制。
首先在svnseve.conf文件設(shè)置anon-access = none禁止匿名用戶通過svn://方式訪問檔案庫，然后在其后加入
auth-access = write
auth-access 是限制有援權(quán)的使用者(使用svn+ssh:// 來登入) 的存取權(quán)限，我們設(shè)為是可以讀寫。
當(dāng)用戶通過svn+ssh://訪問時，服務(wù)器會自動激活ssh認(rèn)證機(jī)制，要求用戶輸入密碼，對于window用戶來說還需要安裝第三方軟件openssh，才可以采用這種機(jī)制
Hook scripts
掛勾 (hook) 是改動檔案庫時所觸發(fā)的程序, 比如當(dāng)你提交更動前，會先觸發(fā)pre-commit，提交更動后，則會觸發(fā)post-commit，我們可以利用hook來實現(xiàn)一些自動控制。檔案庫的hook 子目錄中, 預(yù)設(shè)是放置各個檔案庫掛勾的模板:
post-commit.tmpl ? ? ? ? ?
pre-revprop-change.tmpl
post-revprop-change.tmpl ?
start-commit.tmpl
pre-commit.tmpl ? ? ? ?
如果要使用這些hook，就必須把它的后綴名.tmpl去掉，拷貝為
post-commit ? ? ? ? ?
pre-revprop-change
post-revprop-change ?
start-commit
pre-commit
這里主要介紹pre-commit和post-commit(事實上它們就是在特定的情況下被觸發(fā)的普通的shell程序,至于shell的內(nèi)容由用戶自己隨意編寫，但是要保證名稱不能改動)
pre-commit
本掛勾執(zhí)行的時間為異動完成之后, 送交之前.檔案庫會傳遞兩個自變量給這個程序: 檔案庫的路徑, 以及準(zhǔn)備送交的異動名稱. 如果程序傳回一個非零的結(jié)束值, 送交會被中止, 而異動會被刪除.
如何應(yīng)用pre-commit我們不妨舉個例子：
假如有一個項目由Mail Team,Login Team和PHP Team三個Team共同通過SVN系統(tǒng)開發(fā)完成。當(dāng)項目準(zhǔn)備發(fā)布的時候，PM人員發(fā)現(xiàn)Mail功能方面存在一些 bug，需要Mail Team去修改，為了防止其它Team的人員修改系統(tǒng)，我們可以在任何改動檔案庫的企圖之前用pre-commit去檢查log message信息,(因為任何更動檔案庫的操作都必須提供log message信息,PM可以事先輿Mail Team約定好一個log message),如果輿pre-commit中設(shè)定的log message不相符，則不能提交更動。
pre-commit源程序如下:
#!/bin/sh
REPOS="$1"
TXN="$2"
SVNLOOK=/usr/local/bin/svnlook
$SVNLOOK log -t "$TXN" "$REPOS" | \
? grep –w "bug1234" > /dev/null || exit 1
exit 0
本例中的log message為”bug1234”,任何人想要提交更動就必須用 –m “bug1234”參數(shù),采用-m “bug123”,-m “bug12345”都會提交失敗。
post-commit
本掛勾執(zhí)行的時間是在異動送交, 新修訂版被建立之后. 大多數(shù)的人用這個掛勾來寄出關(guān)于本次送交的電子郵件, 或是建立檔案庫的備份. 檔案庫會傳遞兩個自變量給這個程序: 檔案庫的路徑, 以及新建立的修訂版號. 本程序的結(jié)束碼會被忽略.
Subversion 源碼樹的 tools/hook-script 目錄中包含了一個 commit-email.pl 命令，可以用來寄送包含描述指定送交的電子郵件. 這個郵件包含了更動路徑列表, 該送交所對應(yīng)的記錄訊息, 使用者, 送交的日期,以及一個以 GNU diff 樣式表示的本次更動差異. 我們可以將這個程序輿post-commit這個hook搭配起來使用來實現(xiàn)檔案庫更動后自動mail給相關(guān)人員的功能。
post-commit源程序如下:
#!/bin/sh
REPOS="$1"
REV="$2"
commit-email.pl "$REPOS" "$REV" PM@yourdomain.com
##需要指明commit-email.pl的絕對路徑
特殊性質(zhì)
除了對你的目錄與檔案進(jìn)行版本控制之外, Subversion 還提供了一個接口, 可用來新增, 修改, 以及移除已納入版本控制的目錄與檔案的版本控制描述資料. 我們稱這個描述資料為性質(zhì),在這里我主要介紹以下幾個比較重要的特殊性質(zhì)
svn:mime-type
svn:mime-type 性質(zhì)在 Subversion 中有很多作用. 除了作為儲存檔案的多用途網(wǎng)際網(wǎng)絡(luò)郵件延伸語法 (MIME) 分類之外, 這個性質(zhì)的內(nèi)容還會決定幾項 Subversion 的行為特征.
舉個例子, 如果 svn:mime-type 性質(zhì)設(shè)為文字的 MIME 類別 , Subversion 會假設(shè)該檔的內(nèi)容是二進(jìn)制(也就是人類看不懂的資料). Subversion 提供的功能中, 其中一項是在從服務(wù)器收到工作檔的更新中, 依文字內(nèi)容與文字列進(jìn)行合并. 但是對含有二進(jìn)制資料的檔案, 根本就沒有 “文字列” 的概念. 因此, Subversion 對這些檔案在更新時, 不會試著進(jìn)行內(nèi)文合并. 它改用另一種方式。
一般來說Subversion 在執(zhí)行 svn import 與 svn add 子命令時, 會使用二進(jìn)制偵測運算法的方式來協(xié)助使用者.但是如果 Subversion 猜錯了, 或是你希望將 svn:mime-type 設(shè)定成更為明確的值(可能是 image/png)你都可以移除或是手動編輯這個性質(zhì).
svn:ignore
svn:ignore 性質(zhì)包含了檔案樣式的列表, Subversion 處理時會忽略. 它可以與執(zhí)行時期設(shè)定的 global-ignores 選項一起工作, 以便在類似 svn status 的命令中過濾掉未納入版本控制的目錄與檔案.
我們知道新增的文件和目錄必須透過 svn add 命令, 才會被納入 Subversion 的管理. svn status 命令會將工作復(fù)本中未納入版控制目錄與檔案顯示出來.
$ svn status calc
M ? ? calc/button.c
? ? ? ?calc/calculator
? ? ? ?calc/data.c
? ? ? ?calc/debug_log
? ? ? ?calc/debug_log.1
在這個范例中, 用?標(biāo)注出來的文件就是未納入版控制的檔案.如果你不想每次執(zhí)行 svn status 時, 都看到這些檔案， 那幺svn:ignore 性質(zhì)就是解決方案。你可以透過 svn propedit svn:ignore calc 對 calc 目錄加上一些忽略樣式. 舉個例子,將以下的值作為 svn:ignore 性質(zhì)的新內(nèi)容:
calculator
debug_log*
加上這個性質(zhì)后再執(zhí)行你的 svn status 輸出便會不同：
$ svn status
M ? ? calc
M ? ? calc/button.c
? ? ? ?calc/data.c
現(xiàn)在, 所有不想看到的東西都從輸出中消失了!
svn:keywords
Subversion 具有取代關(guān)鍵詞(有關(guān)納入版本控制檔案的有用信息)進(jìn)入檔案內(nèi)容的功能.
舉個例子, 假設(shè)你有個文件, 想要在里面顯示最近一次修改的日期. 你可以把這個負(fù)擔(dān)加諸文件的作者身上, 讓他們每一次送交更動之前, 順便添加最近一次修改日期的部份. 但是遲早有人會忘記這件事. 換個方式, 只要叫 Subversion 對 LastChangedDate 關(guān)鍵詞進(jìn)行關(guān)鍵詞取代即可.
Subversion 定義了可用來進(jìn)行取代的關(guān)鍵詞列表. 這個列表包含了以下五個關(guān)鍵詞:
LastChangedDate
LastChangedRevision
LastChangedBy
HeadURL
Id
如果只把關(guān)鍵詞定位錨加進(jìn)檔案里的話, 什幺事也不會發(fā)生.要告訴 Subversion 是否該對某一個檔案進(jìn)行關(guān)鍵詞取代,得使用svn:keywords這個性質(zhì)。當(dāng)它被設(shè)定時, 它會控制該檔案哪個關(guān)鍵詞應(yīng)該被取代.
舉個例子, 假設(shè)你有一個納入版本控制的檔案, 名為 weather.txt, 看起來像這樣:
Here is the latest report from the front lines.
$LastChangedDate$
$Rev$
Cumulus clouds are appearing more frequently as summer approaches.
如果沒有設(shè)定該檔案的 svn:keywords 性質(zhì), Subversion 什幺事也不會作. 讓我們開啟關(guān)鍵詞 LastChangedDate 的內(nèi)容取代.
$ svn propset svn:keywords "LastChangedDate Author" weather.txt
property `svn:keywords' set on 'weather.txt'
$
在你送交了這個性質(zhì)更動之后, Subversion 會顯示為：
Here is the latest report from the front lines.
$LastChangedDate: 2002-07-22 21:42:37 -0700 (Mon, 22 Jul 2002) $
$Rev$
Cumulus clouds are appearing more frequently as summer approaches.
這樣不管誰提交這個文件，都會在里面顯示最近一次修改的日期。
svn:eol-style
除非另外指定版本控制檔案的 svn:mime-type 性質(zhì), Subversion 會假設(shè)檔案包含人類可讀的資料.這對于列尾符號 (EOL) 是很不幸地, 因為不同的操作系統(tǒng)會使用不同的符號來表示一列的結(jié)尾. 舉個例子, 一般用在 Windows 平臺上的列尾符號是兩個 ASCII 控制字符 ：返回字符 (CR) 與換行字符 (LF). 但是 Unix 軟件就只使用 LF 字符來表示一列的結(jié)尾.這樣以來window客戶提交的檔案中的CR 字符在 linux客戶端會顯示成 ^M, 而linux客戶提交的檔案中CR 字符在 Windows 客戶端會被忽略。結(jié)果將檔案里的所有文字列合并成一個超長的文字列, 這是因為沒有返回CRLF字符組合的存在來表示一個換行。 解決的方法是 svn:eol-style 性質(zhì). 當(dāng)這個性質(zhì)設(shè)定為native時, Subversion 會根據(jù)系統(tǒng)的類型來決定是否對該檔案的結(jié)尾進(jìn)行自動處理。.
svn:externals
有的時候, 一個工作復(fù)本可能包含了數(shù)個不同來源的工作復(fù)本. 舉個例子, 你可能想要有數(shù)個不同的目錄, 各來自不同的檔案庫.我們可以通過svn:externals 性質(zhì)來宣告這一對對應(yīng)關(guān)系。內(nèi)容是子目錄對應(yīng)至 Subversion 檔案庫 URL 的多行表格.
$ svn propget svn:externals calc
third-party/sounds ? ? ? ? ?http://sounds.red-bean.com/repos
third-party/skins ? ? ? ? ? http://skins.red-bean.com/repositories/skinproj
third-party/skins/toolkit ? http://svn.red-bean.com/repos/skin-maker
當(dāng)有人取出 calc 目錄的工作復(fù)本, Subversion 還會繼續(xù)取出在外部定義里的項目.
$ svn checkout http://svn.example.com/repos/calc
A ?calc
A ?calc/Makefile
A ?calc/integer.c
A ?calc/button.c
Checked out revision 148.
Fetching external item into calc/third-party/sounds
A ?calc/third-party/sounds/ding.ogg
A ?calc/third-party/sounds/dong.ogg
A ?calc/third-party/sounds/clang.ogg
Checked out revision 14.
Fetching external item into calc/third-party/skins
…
小結(jié)
Subversion有一份很好的文檔——《Version Control with Subversion》（http://svnbook.red-bean.com/）。它提供了有關(guān)Subversion的各方面內(nèi)容，如使用、管理和開發(fā)等。
經(jīng)過數(shù)年的開發(fā)，以替代CVS為目標(biāo)的Subversion，相信以其強(qiáng)大的功能，對CVS良好的繼承性，一定會有很好的發(fā)展
|