SVN簡(jiǎn)介和工作原理

subversion（簡(jiǎn)稱svn）是近幾年崛起的版本管理軟件，是cvs的接班人，目前絕大多數(shù)開(kāi)源軟件都使用svn作為代碼版本管理軟件。Subversion支持linux和windows，但較多安裝在linux下。

svn服務(wù)器有兩種運(yùn)行方式：獨(dú)立服務(wù)器和借助于apache。 svn://或http://svn客戶端tortoisesvnsvn的基本工作原理： 在一臺(tái)服務(wù)器上建立一個(gè)源代碼庫(kù)，庫(kù)里可以存放許多不同項(xiàng)目的源程序。有源代碼庫(kù)管理員統(tǒng)一管理這些源程序。每個(gè)用戶在使用源代碼庫(kù)之前，首先要把源代碼庫(kù)里德項(xiàng)目文件下載到本地，然后開(kāi)發(fā)人員可以在本地修改，左后用svn命令進(jìn)行提交，游源代碼庫(kù)統(tǒng)一管理修改。版本控制解決了：*代碼管理混亂*解決代碼沖突困難*在代碼整合期間引發(fā)bug*無(wú)法對(duì)代碼的擁有者進(jìn)行權(quán)限控制*項(xiàng)目不同版本的發(fā)布困難

subversion目錄說(shuō)明：*dav目錄：是提供apache與mod_dav_svn使用的目錄，讓他們存儲(chǔ)內(nèi)部數(shù)據(jù)*db目錄：就是所有版本控制的數(shù)據(jù)存放文件*hooks目錄：放置hook腳本文件的目錄*locks目錄：用來(lái)放置subversion見(jiàn)艱苦鎖定數(shù)據(jù)的目錄，用來(lái)追蹤存取文件庫(kù)的客戶端*format文件：是一個(gè)文本文件，里面只放了一個(gè)整數(shù)。表示當(dāng)前文件庫(kù)配置的版本號(hào)*conf目錄：是這個(gè)倉(cāng)庫(kù)的配置文件（倉(cāng)庫(kù)的用戶訪問(wèn)賬號(hào)、權(quán)限等）

SVN Server詳細(xì)配置手冊(cè)

系統(tǒng)環(huán)境CentOS 5.8 最小化安裝(關(guān)閉iptables和selinux) + ssh + yum

一，安裝必須的軟件包.yum install subversionmysql-server httpd mod_dav_svn mod_perl sendmail wget gcc-c++ make unzip perl* ntsysv vim-enhanced

說(shuō)明：subversion (SVN服務(wù)器)mysql-server (用于codestriker)httpd mod_dav_svn mod_perl (用于支持WEB方式管理SVN服務(wù)器)sendmail (用于配置用戶提交代碼后發(fā)郵件提醒)wget gcc-c++ make unzip perl* (必備軟件包)ntsysv vim-enhanced (可選)

二，基本的SVN服務(wù)器配置1，新建一個(gè)目錄用于存儲(chǔ)SVN所有文件# mkdir /home/svn

2，新建一個(gè)版本倉(cāng)庫(kù)# svnadmin create /home/svn/project

3，初始化版本倉(cāng)庫(kù)中的目錄# mkdir project project/server project/client project/test (建立臨時(shí)目錄)# svn import project/ file:///home/svn/project -m “初始化SVN目錄”# rm -rf project (刪除臨時(shí)建立的目錄)

4，添加用戶要添加SVN用戶非常簡(jiǎn)單，只需在/home/svn/project/conf/passwd文件添加一個(gè)形如“username=password”的條目就可以了。為了測(cè)試，我添加了如下內(nèi)容:[users]# harry = harryssecret# sally = sallyssecretpm = pm_pwserver_group = server_pwclient_group = client_pwtest_group = test_pw5，修改用戶訪問(wèn)策略/home/svn/project/conf/authz記錄用戶的訪問(wèn)策略，以下是參考:[groups]project_p = pmproject_s = server1,server2,server3project_c = client1,client2,client3project_t = test1,test1,test1

[project:/]@project_p = rw* =

[project:/server]@project_p = rw@project_s = rw* =

[project:/client]@project_p = rw@project_c = rw* =

[project:/doc]@project_p = rw@project_s = r@project_c = r@project_t = r* =

說(shuō)明：以上信息表示，只有project_p用戶組有根目錄的讀寫權(quán)。r表示對(duì)該目錄有讀權(quán)限，w表示對(duì)該目錄有寫權(quán)限，rw表示對(duì)該目錄有讀寫權(quán)限。最后一行的* =表示，除了上面設(shè)置了權(quán)限的用戶組之外，其他任何人都被禁止訪問(wèn)本目錄。這個(gè)很重要，一定要加上！

6，修改svnserve.conf文件,讓用戶和策略配置升效.svnserve.conf內(nèi)容如下:[general]anon-access = noneauth-access = writepassword-db = /home/svn/project/conf/passwdauthz-db = /home/svn/project/conf/authz7，啟動(dòng)服務(wù)器# svnserve -d -r /home/svn注意：如果修改了svn配置，需要重啟svn服務(wù)，步驟如下：# ps -aux|grep svnserve# kill -9 ID號(hào)# svnserve -d -r /home/svn8，測(cè)試服務(wù)器# svn co svn://192.168.60.10/projectAuthentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18dPassword for ’root’:Authentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18dUsername: server_groupPassword for ’server_group’:svn: Authorization failed ( server_group沒(méi)用根目錄的訪問(wèn)權(quán) )

# svn co svn://192.168.60.10/projectAuthentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18dPassword for ‘root’:Authentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18dUsername: pmPassword for ‘pm’:A project/testA project/serverA project/clientChecked out revision 1. ( 測(cè)試提取成功 )

# cd project/server# vim main.c# svn add main.c# svn commit main.c -m “測(cè)試一下我的C程序,看什么看,不行啊??”Adding main.cTransmitting file data .Committed revision 2. ( 測(cè)試提交成功 )

三，配置SVN服務(wù)器的HTTP支持1，轉(zhuǎn)換SVN服務(wù)器的密碼由于SVN服務(wù)器的密碼是明文的，HTTP服務(wù)器不與支持，所以需要轉(zhuǎn)換成HTTP支持的格式。我寫了一個(gè)Perl腳本完成這個(gè)工作.腳本內(nèi)容如下:# cd /home/svn/project/conf/# vim PtoWP.pl

#!/usr/bin/perl# write by huabo, 2009-11-20use warnings;use strict;#open the svn passwd fileopen (FILE, 'passwd') or die ('Cannot open the passwd file!!!n');#clear the apache passwd fileopen (OUT_FILE, '>webpasswd') or die ('Cannot open the webpasswd file!!!n');close (OUT_FILE);#beginforeach (<FILE>) {if($_ =~ m/^[^#].*=/) {$_ =~ s/=//;`htpasswd -b webpasswd $_`;}}

# chmod +x PtoWP.pl# ./PtoWP.plAdding password for user pmAdding password for user server_groupAdding password for user client_groupAdding password for user test_group現(xiàn)在目錄下會(huì)多一個(gè)webpasswd文件。

2，修改httpd.conf，添加關(guān)于SVN服務(wù)器的內(nèi)容編輯/etc/httpd/conf/httpd.conf，在最后添加如下信息:<Location /project>DAV svnSVNPath /home/svn/project/AuthType BasicAuthName 'svn for project'AuthUserFile /home/svn/project/conf/webpasswdAuthzSVNAccessFile /home/svn/project/conf/authzSatisfy allRequire valid-user</Location>

3，修改svn目錄的屬主為apache帳號(hào)：chown -R apache.apache /home/svn/project/（注意：原文少了這一步，會(huì)出權(quán)限問(wèn)題。）4，重啟Web服務(wù)器：# /etc/init.d/httpd restartStopping httpd: [FAILED]Starting httpd: [ OK ]

5，用瀏覽器訪問(wèn)http://192.168.60.10/project/server/測(cè)試

四，配置郵件提醒支持1，安裝Perl模塊Module::Build# wget http://search.cpan.org/CPAN/authors/id/D/DA/DAGOLDEN/Module-Build-0.36_11.tar.gz# tar xvf Module-Build-0.36_11.tar.gz# cd Module-Build-0.36_11# perl Build.PL# ./Build# ./Build test# ./Build install# cd ..2，安裝Perl模塊Authen::SASL# wget http://search.cpan.org/CPAN/authors/id/G/GB/GBARR/Authen-SASL-2.15.tar.gz# tar xvf Authen-SASL-2.15.tar.gz# cd Authen-SASL-2.15# perl Makefile.PL# make test# make install# cd ..3，安裝Perl模塊Net::SMTP_auth# wget http://search.cpan.org/CPAN/authors/id/A/AP/APLEINER/Net-SMTP_auth-0.08.tar.gz# tar xvf Net-SMTP_auth-0.08.tar.gz# cd Net-SMTP_auth-0.08# perl Makefile.PL# make test# make install# cd ..4，安裝Perl模塊SVN::Notify# wget http://search.cpan.org/CPAN/authors/id/D/DW/DWHEELER/SVN-Notify-2.80.tar.gz# tar xvf SVN-Notify-2.80.tar.gz# cd SVN-Notify-2.80# perl Build.PL# ./Build# ./Build test# ./Build install# cd ..5，啟動(dòng)郵件服務(wù)器# service sendmail restartShutting down sendmail: [FAILED]Starting sendmail: [ OK ]Starting sm-client: [ OK ]

6，配置自動(dòng)發(fā)郵件腳本修改post-commit腳本,以支持郵件通知功能.# cd /home/svn/project/hooks/# vim post-commit內(nèi)容如下:#!/bin/shREPOS='$1'REV='$2'

/usr/bin/svnnotify –repos-path “$1″ –revision “$2″ –to caodaijun@pica.com –from caodaijun@feinno.com –handler “HTML::ColorDiff” –with-diff –smtp localhost –smtp-user root –smtp-pass 5201314318 -c “UTF-8″ -g zh_CN -o raw –svnlook /usr/bin/svnlook –subject-prefix ‘[SVN Update]‘

(to參數(shù)代表接收郵件的地址，可以有多個(gè)，當(dāng)你有多個(gè)老大的時(shí)候，這就很重要了，：）。from參數(shù)是虛擬的，代表你的發(fā)送地址，一般情況下，這個(gè)參數(shù) 不重要，但如果接收者的郵件服務(wù)器有反垃圾郵件的功能，需要判定源地址的話，這個(gè)參數(shù)是否合法就顯得很重要了)再給該腳本添加可執(zhí)行權(quán)限# chmod +x post-commit

7，再次提交時(shí)，就會(huì)給指定郵件地址發(fā)信了。

五，其它常用配置1，強(qiáng)制寫log腳本配置pre-commit文件，要求用戶每次更新文件都必須寫log.# cd /home/svn/project/hooks/# vim pre-commit文件內(nèi)容如下:#!/bin/shREPOS='$1'TXN='$2'SVNLOOK=/usr/bin/svnlookLOGMSG=`$SVNLOOK log -t '$TXN' '$REPOS' | grep '[a-zA-Z0-9]' | wc -c`if [ '$LOGMSG' -lt 5(要求的log長(zhǎng)度，依實(shí)際需要修改) ];thenecho -e 'nEmpty log message not allowed. Commit aborted!' 1>&2exit 1fi配置完成后，給本件加上可執(zhí)行權(quán)限。再提交代碼時(shí)，就必須按要求寫注釋了，：）

2，可修改log腳本配置pre-revprop-change文件，此文件在show log中修改log時(shí)會(huì)運(yùn)行，得到修改的權(quán)限，否則會(huì)報(bào)錯(cuò):DAV request failed; it’s possible that the repository’s pre-revprop-change hook either failed or is non-existent. At least one property change failed; repository is unchanged# cd /home/svn/project/hooks/# vim pre-revprop-change文件內(nèi)容如下:REPOS='$1'REV='$2'USER='$3'PROPNAME='$4'if ['$PROPNAME' = 'svn:log'];then exit 0;fiexit 1配置完后加可執(zhí)行權(quán)限升效。

六，備份管理svn服務(wù)器的定期備份是很重要的，最簡(jiǎn)單的方式是定時(shí)備份倉(cāng)庫(kù)目錄。1，新建備份目錄# mkdir /opt/project_backup

2，編寫備份腳本# cd /home/svn/# vim project_backup.sh

內(nèi)容如下:#!/bin/bash#write by huabo, 2009-11-20

cd /home/svnnow=`/bin/date +%Y%m%d`/bin/tar czvf “project_backup_$now.tar.gz” project/ && rm -rf /opt/project_backup/* && /bin/mv project_backup_*.tar.gz /opt/project_backup/if [ $? == 0 ]thenresult=”O(jiān)K!!”elseresult=”False!!”fi

#send mail toadministrator/bin/mail caodaijun@pica.com -s “project_backup_$now” <<MESSAGEResult: `/bin/echo $result`MESSAGE

給該腳本添加可執(zhí)行權(quán)限。

3，設(shè)定每天定時(shí)執(zhí)行該腳本.# crontab -e輸入如下內(nèi)容:0 23 * * * /home/svn/project_backup.sh表示每天晚上23點(diǎn)運(yùn)行此腳本。

經(jīng)過(guò)以上三步操作，就可以自動(dòng)備份SVN資料了，且不論備份是否成功，都會(huì)給用戶發(fā)送郵件信息。

七，用svnstat分析SVN數(shù)據(jù).1，安裝JAVAsvnstat是JAVA應(yīng)用程序，需要先安裝JAVA環(huán)境。下載jre，URL: http://javadl.sun.com/webapps/download/AutoDL?BundleId=39484安裝:# chmod +x jre-6u20-linux-i586-rpm.bin# ./jre-6u20-linux-i586-rpm.bin

2，下載svnstat# wget http://downloads.sourceforge.net/project/svnstat/svnstat/Release-1.0/SvnStat-1.0.zip?use_mirror=jaist# unzip SvnStat-1.0.zip

3，更新代碼# pwd/root

# svn co svn://192.168.60.10/projectA project/testA project/serverA project/server/main.cA project/clientChecked out revision 5.

4，生成svnstat數(shù)據(jù)# svn log project -v –xml –non-interactive > project.log# cd SvnStat-1.0# java -classpath SvnStat-all.jar de.agentlab.svnstat.SvnStat -jar SvnStat-all.jar -r /root/project.log -d /var/www/html/

5，用瀏覽器登錄即可看到許多統(tǒng)計(jì)出來(lái)的圖表。

八，用statsvn分析SVN數(shù)據(jù)1，下載statsvn# wget http://downloads.sourceforge.net/project/statsvn/statsvn/0.7.0/statsvn-0.7.0.zip?use_mirror=jaist# unzip statsvn-0.7.0.zip# cd statsvn-0.7.0

2，生成statsvn數(shù)據(jù)# mkdir /var/www/html/statsvn# java -jar statsvn.jar -verbose -output-dir /var/www/html/statsvn/ /root/project.log /root/project

3，用瀏覽器測(cè)測(cè)試效果如下圖：

九，配置codestriker.1.安裝codestriker依賴的perl包.# perl -MCPAN -e ‘install “Template”‘

2.下載codestriker# wget http://downloads.sourceforge.net/project/codestriker/codestriker/1.9.10/codestriker-1.9.10.tar.gz?use_mirror=jaist&ts=1279246587# mkdir /var/www/codestriker# cd /var/www/codestriker# tar xvf /path/codestriker-1.9.10.tar.gz# chown -R apache.apache codestriker-1.9.10

3.配置數(shù)據(jù)庫(kù)# service mysqld restart# mysql -uroot mysql執(zhí)行:CREATEDATABASEcodestrikerdb CHARACTER SET utf8;GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP,REFERENCES ON codestrikerdb.* TO codestriker@localhost IDENTIFIED BY ‘cspasswd’;FLUSH PRIVILEGES;quit

4.配置codestriker# cd codestriker-1.9.10/# vim codestriker.conf注意以下幾點(diǎn)(詳細(xì)可查看codestriker的安裝文檔)a.數(shù)據(jù)庫(kù)的用戶名密碼要配對(duì)b.svn的數(shù)據(jù)倉(cāng)庫(kù)要配對(duì)，我的如下：@valid_repositories =(‘svn:file:///home/svn/project’,)

5.執(zhí)行codestriker的安裝腳本# cd bin/# ./install.pl

6.配置http支持# vim /etc/httpd/conf/httpd.conf在最后面加上如下內(nèi)容:

Alias /codestriker/ /var/www/codestriker/codestriker-1.9.10/cgi-bin/Alias /codestrikerhtml/ /var/www/codestriker/codestriker-1.9.10/html/

<Directory “/var/www/codestriker/codestriker-1.9.10/cgi-bin/”>SetHandler perl-scriptPerlHandler ModPerl::RegistryOptions +ExecCGI</Directory>

<Directory “/var/www/codestriker/codestriker-1.9.10/html/”>AllowOverride NoneAllow from all</Directory>

7.重啟Web服務(wù)# service httpd restart

8.在瀏覽器中輸入http://192.168.60.10/codestriker/codestriker.pl即可訪問(wèn)，如下圖：