一、简述
1.基础环境
- Debian GNU/Linux 9.9 (stretch)
- Docker version 19.03.4
实际上,使用其他Linux发行版本也是一样的,我在操作的时候使用阿里云的Debian 9.9服务器。关于什么是SVN,这里不会累赘说明,此处只是给大家演示如何基于第三个镜像搭建SVN服务
2.开启简单的容器实例
本次安装我们不写Dockerfile来构建镜像,直接使用Dockerhub上比较热门的一个镜像:elleflorio/svn-server,详细内容可以参考此链接:https://hub.docker.com/r/elleflorio/svn-server
使用以下命令创建一个简单的svn服务
代码语言:javascript复制docker run -d --name svn-server -p 3690:3690 elleflorio/svn-server
你还可以选择性的把本地目录映射到容器的svn仓库目录,如下参数
代码语言:javascript复制-v <hostpath>:/home/svn
二、实际操作过程
假设:现在有这样的需要,开发一个PHP项目,在服务器创建一个base代码仓库,所有开发人员可以从服务器把代码pull到PC进行开发,再上传到服务器进行自动部署。下面我们基于Docker完成这个过程。
1.下载镜像,创建容器
代码语言:javascript复制# 下载镜像
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.在服务器创建代码仓库
代码语言:javascript复制# 创建代码仓库
docker exec -t svn-server svnadmin create /home/svn/test
以上代码中,在容器中的/home/svn/test目录创建代码仓库,会同步到本机的/var/svn目录。我们先进行svn仓库配置。
SVN库中的配置目录 conf 有三个文件:
- authz 是权限控制文件
- passwd 是帐号密码文件
- svnserve.conf 是SVN服务综合配置文件
配置权限配置文件 authz
编辑 authz ,内容参考如下:
示例代码:/var/svn/test/conf/authz
代码语言:javascript复制[groups]
#用户组
admin = master,master
#用户组所对应的目录
[/]
#库目录权限
@admin = rw
#用户组权限
*=r
配置账号密码文件 passwd
编辑 passwd ,内容参考如下:
示例代码:/var/svn/test/conf/passwd
代码语言:javascript复制[users]
# harry = harryssecret
# sally = sallyssecret
master = master
admin = admin
配置 SVN 服务综合配置文件 svnserve.conf
编辑 svnserve.conf ,内容参考如下:
示例代码:/var/svn/test/conf/svnserve.conf
代码语言:javascript复制[general]
# force-username-case = none
# 匿名访问的权限 可以是read、write,none,默认为read
anon-access = none
#使授权用户有写权限
auth-access = write
#密码数据库的路径
password-db = passwd
#访问控制文件
authz-db = authz
#认证命名空间,SVN会在认证提示里显示,并且作为凭证缓存的关键字
realm = /var/svn/test
[sasl]
完成以上配置之后,我们要做的是服务器代码与本地代码同步,如下图所示:
下面,我们将本机电脑代码推送到SVN仓库后,服务器又将代码同步到项目目录。
3.同步代码到服务器项目目录
(1)在PC上将代码上传到svn仓库(PC上必须安装SVN)
代码语言:javascript复制# 将仓库中的代码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'
(2)服务器同步代码
代码语言:javascript复制# 将代码同步到项目目录
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
(3)自动同步代码
实际上,如果我们用于开发的PC每一次向服务器提交一次代码,服务器都需要手动执行一下同步命令,本地代码才会同步到服务器的项目目录。想必很麻烦,于是我们可以使用SVN提供的钩子去实现代码自动更新。
代码语言:javascript复制# 进入钩子配置文件目录
cd /var/svn/test/hooks
# 复制钩子文件
cp post-commit.tmpl post-commit
我们将post-commit.tmpl钩子文件的后缀名去掉即可生效,于是我们复制一份。接下来我们编辑post-commit文件,注释掉发送邮件的代码。然后在下面加上两行代码即可,如下:
代码语言:javascript复制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仓库搭建,编好脚本后,可以使用一条命令即可完成以上复杂的内容。