|
PS:今天給開發(fā)的同事搭建一個(gè)公網(wǎng)的SVN Server,google一下,發(fā)現(xiàn)下面這篇最詳細(xì),就記錄下來,重新排版一下。順便根據(jù)自己的使用經(jīng)驗(yàn),補(bǔ)充了幾個(gè)細(xì)節(jié)和總結(jié)。本文配置是基于CentOS 5.x的,但一樣適用于其他Linux發(fā)行版!
SVN簡介和工作原理
subversion(簡稱svn)是近幾年崛起的版本管理軟件,是cvs的接班人,目前絕大多數(shù)開源軟件都使用svn作為代碼版本管理軟件。Subversion支持linux和windows,但較多安裝在linux下。
svn服務(wù)器有兩種運(yùn)行方式:獨(dú)立服務(wù)器和借助于apache。 svn://或http:// svn客戶端tortoisesvn svn的基本工作原理: 在一臺(tái)服務(wù)器上建立一個(gè)源代碼庫,庫里可以存放許多不同項(xiàng)目的源程序。有源代碼庫管理員統(tǒng)一管理這些源程序。每個(gè)用戶在使用源代碼庫之前,首先要把源代碼庫里德項(xiàng)目文件下載到本地,然后開發(fā)人員可以在本地修改,左后用svn命令進(jìn)行提交,游源代碼庫統(tǒng)一管理修改。 版本控制解決了: *代碼管理混亂 *解決代碼沖突困難 *在代碼整合期間引發(fā)bug *無法對(duì)代碼的擁有者進(jìn)行權(quán)限控制 *項(xiàng)目不同版本的發(fā)布困難
SVN工作原理示意圖:

subversion目錄說明: *dav目錄:是提供apache與mod_dav_svn使用的目錄,讓他們存儲(chǔ)內(nèi)部數(shù)據(jù) *db目錄:就是所有版本控制的數(shù)據(jù)存放文件 *hooks目錄:放置hook腳本文件的目錄 *locks目錄:用來放置subversion見艱苦鎖定數(shù)據(jù)的目錄,用來追蹤存取文件庫的客戶端 *format文件:是一個(gè)文本文件,里面只放了一個(gè)整數(shù)。表示當(dāng)前文件庫配置的版本號(hào) *conf目錄:是這個(gè)倉庫的配置文件(倉庫的用戶訪問賬號(hào)、權(quán)限等)
SVN Server詳細(xì)配置手冊(cè)
系統(tǒng)環(huán)境 CentOS 5.8 最小化安裝(關(guān)閉iptables和selinux) + ssh + yum
一,安裝必須的軟件包.
yum install subversion mysql-server httpd mod_dav_svn mod_perl sendmail wget gcc-c++ make unzip perl* ntsysv vim-enhanced
說明: 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è)版本倉庫 # svnadmin create /home/svn/project
3,初始化版本倉庫中的目錄 # mkdir project project/server project/client project/test (建立臨時(shí)目錄) # svn import project/ file:///home/svn/project -m “初始化SVN目錄” # rm -rf project (刪除臨時(shí)建立的目錄)
4,添加用戶 要添加SVN用戶非常簡單,只需在/home/svn/project/conf/passwd文件添加一個(gè)形如“username=password”的條目就可以了。為了測(cè)試,我添加了如下內(nèi)容:
[users] # harry = harryssecret # sally = sallyssecret pm = pm_pw server_group = server_pw client_group = client_pw test_group = test_pw
5,修改用戶訪問策略 /home/svn/project/conf/authz記錄用戶的訪問策略,以下是參考:
[groups] project_p = pm project_s = server1,server2,server3 project_c = client1,client2,client3 project_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 * =
說明:以上信息表示,只有project_p用戶組有根目錄的讀寫權(quán)。r表示對(duì)該目錄有讀權(quán)限,w表示對(duì)該目錄有寫權(quán)限,rw表示對(duì)該目錄有讀寫權(quán)限。最后一行的* =表示,除了上面設(shè)置了權(quán)限的用戶組之外,其他任何人都被禁止訪問本目錄。這個(gè)很重要,一定要加上!
6,修改svnserve.conf文件,讓用戶和策略配置升效. svnserve.conf內(nèi)容如下:
[general] anon-access = none auth-access = write password-db = /home/svn/project/conf/passwd authz-db = /home/svn/project/conf/authz
7,啟動(dòng)服務(wù)器 # svnserve -d -r /home/svn 注意:如果修改了svn配置,需要重啟svn服務(wù),步驟如下:
# ps -aux|grep svnserve # kill -9 ID號(hào) # svnserve -d -r /home/svn
8,測(cè)試服務(wù)器
# svn co svn://192.168.60.10/project Authentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18d Password for 'root': Authentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18d Username: server_group Password for 'server_group': svn: Authorization failed ( server_group沒用根目錄的訪問權(quán) )
# svn co svn://192.168.60.10/project Authentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18d Password for ‘root’: Authentication realm: <svn://192.168.60.10:3690> 92731041-2dae-4c23-97fd-9e1ed7f0d18d Username: pm Password for ‘pm’: A project/test A project/server A project/client Checked out revision 1. ( 測(cè)試提取成功 )
# cd project/server # vim main.c # svn add main.c # svn commit main.c -m “測(cè)試一下我的C程序,看什么看,不行啊??” Adding main.c Transmitting 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-20
use warnings;
use strict;
#open the svn passwd file
open (FILE, "passwd") or die ("Cannot open the passwd file!!!n");
#clear the apache passwd file
open (OUT_FILE, ">webpasswd") or die ("Cannot open the webpasswd file!!!n");
close (OUT_FILE);
#begin
foreach (<FILE>) {
if($_ =~ m/^[^#].*=/) {
$_ =~ s/=//;
`htpasswd -b webpasswd $_`;
}
}
# chmod +x PtoWP.pl # ./PtoWP.pl Adding password for user pm Adding password for user server_group Adding password for user client_group Adding 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 svn SVNPath /home/svn/project/ AuthType Basic AuthName "svn for project" AuthUserFile /home/svn/project/conf/webpasswd AuthzSVNAccessFile /home/svn/project/conf/authz Satisfy all Require valid-user </Location>
3,修改svn目錄的屬主為apache賬號(hào):chown -R apache.apache /home/svn/project/ (注意:原文少了這一步,會(huì)出權(quán)限問題。) 4,重啟Web服務(wù)器: # /etc/init.d/httpd restart Stopping httpd: [FAILED] Starting httpd: [ OK ]
5,用瀏覽器訪問http://192.168.60.10/project/server/測(cè)試 測(cè)試結(jié)果如下圖所示:
 ( 測(cè)試成功 )
四,配置郵件提醒支持 1,安裝Perl模塊Module::Build
# wget http://search./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/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/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/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 restart Shutting 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/sh REPOS="$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/sh REPOS="$1" TXN="$2" SVNLOOK=/usr/bin/svnlook LOGMSG=`$SVNLOOK log -t "$TXN" "$REPOS" | grep "[a-zA-Z0-9]" | wc -c` if [ "$LOGMSG" -lt 5(要求的log長度,依實(shí)際需要修改) ]; then echo -e "nEmpty log message not allowed. Commit aborted!" 1>&2 exit 1 fi
配置完成后,給本件加上可執(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;fi exit 1
配置完后加可執(zhí)行權(quán)限升效。
六,備份管理 svn服務(wù)器的定期備份是很重要的,最簡單的方式是定時(shí)備份倉庫目錄。 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/svn now=`/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 ] then result=”O(jiān)K!!” else result=”False!!” fi
#send mail to administrator /bin/mail caodaijun@pica.com -s “project_backup_$now” <<MESSAGE Result: `/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)過以上三步操作,就可以自動(dòng)備份SVN資料了,且不論備份是否成功,都會(huì)給用戶發(fā)送郵件信息。
七,用svnstat分析SVN數(shù)據(jù). 1,安裝JAVA svnstat是JAVA應(yīng)用程序,需要先安裝JAVA環(huán)境。 下載jre,URL: http://javadl./webapps/download/AutoDL?BundleId=39484 安裝: # chmod +x jre-6u20-linux-i586-rpm.bin # ./jre-6u20-linux-i586-rpm.bin
2,下載svnstat # wget http://urceforge.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/project A project/test A project/server A project/server/main.c A project/client Checked 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ì)出來的圖表。大致如下圖所示:
 八,用statsvn分析SVN數(shù)據(jù) 1,下載statsvn # wget http://urceforge.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://urceforge.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ù)庫 # service mysqld restart # mysql -uroot mysql 執(zhí)行: CREATE DATABASE codestrikerdb 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ù)庫的用戶名密碼要配對(duì) b.svn的數(shù)據(jù)倉庫要配對(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-script PerlHandler ModPerl::Registry Options +ExecCGI </Directory>
<Directory “/var/www/codestriker/codestriker-1.9.10/html/”> AllowOverride None Allow from all </Directory>
7.重啟Web服務(wù) # service httpd restart
8.在瀏覽器中輸入http://192.168.60.10/codestriker/codestriker.pl即可訪問,如下圖:

原文:http://blog./u3/94705/showart_2260521.html 參考:http://wiki./HowTos/Subversion
|