一、概述
1.基础环境
- Debian GNU/Linux 9.9 (stretch)
- Docker version 19.03.4
如果你使用其他Linux发行版本安装过程也基本一样的,我在操作的时候使用阿里云的Debian 9.9服务器。关于什么是SVN,这里不会赘述,本文将演示基于第三方镜像搭建SVN服务的过程
2.开启简单的容器实例
本次我们直接使用Dockerhub上比较热门的一个镜像elleflorio/svn-server
,详细内容可以参考此链接:https://hub.docker.com/r/elleflorio/svn-server
使用以下命令创建一个简单的svn服务
1
docker run -d --name svn-server -p 3690:3690 elleflorio/svn-server
你还可以选择性的把本地目录映射到容器的svn仓库目录,如下参数
1
-v <hostpath>:/home/svn
二、实际操作过程
假设现在有这样的需要,开发一个PHP项目,在服务器创建一个base代码仓库,所有开发人员可以从服务器把代码pull到PC进行开发,再push到服务器进行托管,开发任务push代码完成之后,将代码同步到同一台服务器的web目录,下面我们基于Docker完成这个过程。
2.1 下载镜像,创建容器
1
2
3
4
5
6
# 下载镜像
docker pull elleflorio/svn-server
# 创建svn仓库目录,进入svn仓库目录
mkdir -p /var/svn
# 创建svn服务容器,把容器中的svn仓库映射到本机,并映射3690端口
docker run -d --name svn-server -p 3690:3690 -v "$PWD":/home/svn -v /var/www/html:/var/www/html elleflorio/svn-server
在以上示例代码中,为了能在svn容器中管理本机的项目目录,假设本机的项目目录是/var/www/html
,除了映射SVN仓库目录,我们同时把本机的/var/www/html
映射到svn容器中的/var/www/html
目录。
2.2 在服务器创建代码仓库
1
2
# 创建代码仓库
docker exec -t svn-server svnadmin create /home/svn/test
以上代码中,在容器中的/home/svn/test
目录创建代码仓库,会同步到本机的/var/svn目录。我们先进行svn仓库配置。
SVN库中的配置目录 conf 有三个文件:
- authz:权限控制文件
- passwd:帐号密码文件
- svnserve.conf:SVN服务综合配置文件
修改权限配置文件/var/svn/test/conf/authz
,如下
1
2
3
4
5
6
7
8
9
[groups]
# 用户组
admin = master,admin
#用户组所对应的目录
[/]
# 库目录权限
@admin = rw
# 用户组权限
*=r
配置账号密码文件 passwd,/var/svn/test/conf/passwd
1
2
3
4
5
[users]
# harry = harryssecret
# sally = sallyssecret
master = master
admin = admin
配置SVN的服务配置文件/var/svn/test/conf/svnserve.conf
,如下
1
2
3
4
5
6
7
8
9
10
11
12
13
[general]
# force-username-case = none
# 匿名访问的权限 可以是read、write,none,默认为read,现改为none
anon-access = none
# 使授权用户有写权限
auth-access = write
# 密码数据库的路径
password-db = passwd
# 授权配置文件
authz-db = authz
# 认证命名空间,SVN会在认证提示里显示,并且作为凭证缓存的关键字
realm = /var/svn/test
[sasl]
完成以上配置之后,我们要做的是服务器代码与本地代码同步,如下图所示:
下面,我们将本机电脑代码推送到SVN仓库后,服务器又将代码同步到项目目录。
2.3 同步代码到服务器项目目录
- 在PC上将代码上传到svn仓库(PC上必须安装SVN)
1
2
3
4
5
6
7
8
9
# 将仓库中的代码pull到本地,下面的123.123.123.123代表的是服务器IP地址,以下过程可能会需要输入svn账号和密码
svn checkout svn://123.123.123.123/test
# 进入代码目录
cd test
# 创建示例文件
echo "hello" >> test.txt
# 提交代码到SVN仓库
svn add test.txt
svn commit test.txt -m 'test'
- 服务器同步代码
1
2
# 使用checkout指令将代码同步到项目目录
docker exec -t svn-server svn checkout svn://127.0.0.1/test /var/www/html/test --username master --password master --force --no-auth-cache
- 自动同步代码
我们开发的PC每一次向服务器提交一次代码,现在都需要去服务器主动执行一下同步命令,代码才会同步到服务器的项目目录。想必很麻烦,于是我们可以使用SVN提供的钩子去实现代码自动更新,如下配置
1
2
3
4
# 进入钩子配置文件目录
cd /var/svn/test/hooks
# 复制钩子模板文件为钩子文件
cp post-commit.tmpl post-commit
接下来我们编辑post-commit文件,注释掉发送邮件的代码。然后在下面加上两行代码即可,如下:
1
2
3
4
5
6
7
8
9
REPOS="$1"
REV="$2"
TXN_NAME="$3"
#mailer.py commit "$REPOS" "$REV" /path/to/mailer.conf
# 设置编码
export LANG="en_US.UTF-8"
# 更新代码到项目目录
svn update --username master --password master /var/www/html/test
编辑完成配置文件之后,我们只需要保存即可,自动生效。此时在PC上修改项目内容,再次提交到代码仓库,服务器会自动同步到服务器的项目目录。不再需要手动执行svn checkout指令
三、总结
本次主要演示了SVN服务器的搭建过程中的一些基本流程。我们使用第三方Docker镜像来构建SVN容器服务,实际上和我们直接在操作系统上手动编译安装,或者从软件库安装的效果一样。而容器更好的减少服务器相关依赖,也更好地隔离操作系统的环境。如果我们不需要SVN服务了,直接将对应容器移除即可。
如果我们每次创建一个SVN仓库,都要进行一大堆配置,是一件比较浪费时间的事。开发者也不应该把过多的时间与精力去“重复造轮子”,而应该把更多的时间和精力去思考更有价值的事物!大家可以自行学习编写一个Shell脚本,用于快速搭建SVN仓库,就可以使用一条命令即可完成以上复杂的内容。限于篇幅,本文不再深入研究。