TortoiseSVN的使用

一、什么是SVN(Subversion)?

有一个简单但不十分精确比喻： SVN = 版本控制 + 备份服务器

简单的说，您可以把SVN当成您的备份服务器，更好的是，他可以帮您记住每次上传到这个服务器的档案内容。并且自动的赋予每次的变更一个版本。

二、为甚么要用SVN?

1.备份工作档案是十分重要的。您永远不知道计算机上的硬盘何时会坏掉。根据经验法则再加上摩菲定理，坏事情往往都发生在最重要的时刻。例如，要release东西的前一刻，硬盘完全坏掉，无法修复。所以，常常备份工作数据是非常重要的。大部分公司的server都会有专门的备份机制，甚至是异地备援。绝对比放在自己的计算机里头，或是随身碟上面来的安全。

2.版本控管非常重要。您无法保证手头上最新版本永远都是对的。很多时候，在经过数天努力工作后，您才发现走错方向。需要将所有的修改回复到数天前版本。没有几个人能够完全记住自己修改过什么东西。如果没有做好版本控管，那么，最差的状况就是要全部重来。

3.伙伴间的数据同步也是非常重要的。很多时候，除了您个人外，还有其它的伙伴也需要您的档案。怎么把最新的档案提供给伙伴呢？用e-mail？根据经验，用e-mail是一个很差的办法。到了最后，根本就不知道哪一封e-mail才是新的。因为可能您最新的e-mail已经被当成垃圾信给丢了。别忘了，现在很多e-mail软件都有anti-spam的功能，说不定这些信件都被当成广告信给处理掉了。而且，您也应该知道一般档案如果放在e-mail内，档案大小会变得比较大（通常是原来的4/3倍以上）。如果每天更新一次，恐怕几天没收信的话，信箱就爆了！

4.如果没有一个好的办法，备份不同版本是很耗费硬盘空间的。例如：您有一个总共10MB的目录，使用单纯的档案备份。如果有10个版本就会变成100MB。20个版本就有200MB。如果，不想备份这么多版本，势必就是要减少备份的次数。拉长备份周期将会导致数据遗失的危险性增高。把旧的不需要的备份删除？根据经验，只要时间一拉长，您跟本就不知道一个月以前的版本是重要或者是不重要。

SVN能帮我们解决上面的问题吗？答案是肯定的：

1.SVN Repository可以是自己计算机上的一个目录，或者是随身碟（不建议这样用）。当然也可以是公司的服务器。

2.SVN有很棒的版本控管机制。所有上传的版本都会帮您记录下来。日后您可以随时取得某一个时刻的版本。而且，也有版本分支及合并等好用的功能。

3.SVN可以让不同的开发者存取同样的档案，并且利用SVN Server作为档案同步的机制。也就是说，您有档案更新时，无须将档案寄给您的开发成员。只需要告诉他新的版本已经在SVN Server上面，请他自己去SVN Server上面就可以取得最新版本。而且，SVN Server也可以做到当您上传新版本后，自动发信给相关的成员。

4.SVN的存放档案方式是采用差异备份的方式。也就是说，他只会备份有不同的地方。所以很省硬盘空间。此外，他也可以针对所谓的非文字文件进行差异备份。

三、建立一个SVN存储库

四、与SVN服务器连接

建立好本地的存储库之后就可以与SVN服务器存储库同步数据了。

一，安装必须的软件包.
       yum install subversion (SVN服务器)
                   mysql-server (用于codestriker)
                   httpd mod_dav_svn mod_perl (用于支持WEB方式管理SVN服务器)
                   sendmail (用于配置用户提交代码后发邮件提醒)
                   wget gcc-c++ make unzip perl* (必备软件包)
                   ntsysv vim-enhanced (可选)

二，基本的SVN服务器配置
       1，新建一个目录用于存储SVN所有文件
               # mkdir /home/svn

       2，新建一个版本仓库
               # svnadmin create /home/svn/project

       3，初始化版本仓库中的目录
               # mkdir project project/server project/client project/test (建立临时目录)
               # svn import project/ file:///home/svn/project -m "初始化SVN目录"
               # rm -rf project (删除临时建立的目录)

       4，添加用户
               要添加SVN用户非常简单，只需在/home/svn/project/conf/passwd文件添加一个形如“username=password"的条目就可以了.为了测试，我添加了如下内容:
               [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 = server_group
                       project_c = client_group
                       project_t = test_group

                       [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 = rw
                       @project_c = rw
                       @project_t = rw
                       * =
               以上信息表示，只有pm有根目录的读写权，server_group能访问server目录，client_group能访问client目录，所有人都可以访问doc目录.

       6，修改svnserve.conf文件,让用户和策略配置升效.
               svnserve.conf内容如下:
                       [general]
                       anon-access = none
                       auth-access = write
                       password-db = /home/svn/project/conf/passwd
                       authz-db = /home/svn/project/conf/authz

       7，启动服务器
               # svnserve -d -r /home/svn

       8，测试服务器
               # 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没用根目录的访问权 )

               # 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.  ( 测试提取成功 )

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

三，配置SVN服务器的HTTP支持
       1，转换SVN服务器的密码
               由于SVN服务器的密码是明文的，HTTP服务器不与支持，所以需要转换成HTTP支持的格式。我写了一个Perl脚本完成这个工作.
               脚本内容如下:
               # cd /home/svn/project/conf/
               # cat 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 $_`;
                   }
               }

               # ./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
               现在目录下会多一个webpasswd文件。

       2，修改httpd.conf，添加关于SVN服务器的内容
               编辑/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，启动HTTPD服务器
               # service httpd restart
               Stopping httpd:                                            [FAILED]
               Starting httpd:                                            [  OK  ]

       4，用浏览器访问http://192.168.60.10/project/server/测试
               测试结果如下图所示：

               ( 测试成功 )

四，配置邮件提醒支持
       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，启动邮件服务器
               # service sendmail restart
               Shutting down sendmail:                                    [FAILED]
               Starting sendmail:                                         [  OK  ]
               Starting sm-client:                                        [  OK  ]

       6，配置自动发邮件脚本
               修改post-commit脚本,以支持邮件通知功能.
               # cd /home/svn/project/hooks/
               # vim post-commit
               内容如下:
               #!/bin/sh
               REPOS="$1"
               REV="$2"

               /usr/bin/svnnotify --repos-path "$1" --revision "$2" --to [e-mail] --from [e-mail] --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参数代表接收邮件的地址，可以有多个，当你有多个老大的时候，这就很重要了，：）。from参数是虚拟的，代表你的发送地址，一般情况下，这个参数 不重要，但如果接收者的邮件服务器有反垃圾邮件的功能，需要判定源地址的话，这个参数是否合法就显得很重要了)
               再给该脚本添加可执行权限
               # chmod +x post-commit

       7，再次提交时，就会给指定邮件地址发信了。
               如下图所示:

五，其它常用配置
       1，强制写log脚本
               配置pre-commit文件，要求用户每次更新文件都必须写log.
               # cd /home/svn/project/hooks/
               # vim pre-commit
               文件内容如下:
               #!/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长度，依实际需要修改) ];
               then
                echo -e "\nEmpty log message not allowed. Commit aborted!" 1>&2
                exit 1
               fi

               配置完成后，给本件加上可执行权限。再提交代码时，就必须按要求写注释了，：）

       2，可修改log脚本
               配置pre-revprop-change文件，此文件在show log中修改log时会运行，得到修改的权限，否则会报错: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
               文件内容如下:
               REPOS="$1"
               REV="$2"
               USER="$3"
               PROPNAME="$4"
               if ["$PROPNAME" = "svn:log"];then exit 0;fi
               exit 1

               配置完后加可执行权限升效。

六，备份管理
       svn服务器的定期备份是很重要的，最简单的方式是定时备份仓库目录。
       1，新建备份目录
               # mkdir /opt/project_backup

       2，编写备份脚本
               # cd /home/svn/
               # vim project_backup.sh

               内容如下:
               #!/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="OK!!"
               else
                   result="False!!"
               fi

               #send mail to administrator
               /bin/mail [e-mail] -s "project_backup_$now" <<MESSAGE
               Result: `/bin/echo $result`
               MESSAGE

               给该脚本添加可执行权限。

       3，设定每天定时执行该脚本.
               # crontab -e
               输入如下内容:
               0 23 * * * /home/svn/project_backup.sh
               表示每天晚上23点运行此脚本。

       经过以上三步操作，就可以自动备份SVN资料了，且不论备份是否成功，都会给用户发送邮件信息。

七，用svnstat分析SVN数据.
       1，安装JAVA
       svnstat是JAVA应用程序，需要先安装JAVA环境。
       下载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/project
               A    project/test
               A    project/server
               A    project/server/main.c
               A    project/client
               Checked out revision 5.

       4，生成svnstat数据
               # 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，用浏览器登录即可看到许多统计出来的图表。大致如下图所示：

(俺的测试代码很少，生成的图不成样子，拿官方的图来充当一下，：）)

八，用statsvn分析SVN数据
       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数据
               # mkdir /var/www/html/statsvn
               # java -jar statsvn.jar -verbose -output-dir /var/www/html/statsvn/ /root/project.log /root/project

       3，用浏览器测测试效果如下图：

九，配置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.配置数据库
               # service mysqld restart
               # mysql -uroot mysql
                   执行:
                       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
                   注意以下几点(详细可查看codestriker的安装文档)
                   a.数据库的用户名密码要配对
                   b.svn的数据仓库要配对，我的如下：
                        @valid_repositories =
                            (
                             'svn:file:///home/svn/project',
                            )

       5.执行codestriker的安装脚本
               # cd bin/
               # ./install.pl

       6.配置http支持
               # vim /etc/httpd/conf/httpd.conf
                   在最后面加上如下内容:
                       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.重启HTTP服务器
               # service httpd restart

       8.在浏览器中输入http://192.168.60.10/codestriker/codestriker.pl即可访问，如下图：