文档

部署和使用SVN

更新时间:

Subversion(简称SVN)是一个开源的版本控制系统,通过分支管理系统,可以高效管理随时间改变的数据。本文介绍如何基于ECS部署和使用SVN。

准备工作

创建用于部署SVN的ECS实例,具体操作,请参见自定义购买实例

该实例必须满足以下条件:

  • 实例已分配公网IP地址或绑定弹性公网IP(EIP)。具体操作,请参见绑定EIP

  • 操作系统:Alibaba Cloud Linux 3、Alibaba Cloud Linux 2、CentOS 7.x。

  • 实例规格:部署SVN服务所需的实例规格与项目规格和团队规模有关,建议您使用4 vCPU、4 GiB以上的实例规格。

  • 实例安全组的入方向规则已放行22、80、443端口。具体操作,请参见添加安全组规则

    说明

    svnserve模式还需要放行3690端口。

部署SVN

SVN有HTTP和svnserve两种访问模式,两种模式主要有以下区别。您可以根据业务需要,选择以下其中一种部署方式。

功能

HTTP模式

svnserve模式

协议

使用HTTP协议进行通信。

使用自定义的SVN协议进行通信。

访问方式

支持通过Web浏览器或者SVN客户端进行访问。

仅支持通过SVN客户端进行访问。

端口

使用80端口进行通信。

使用3690端口进行通信。

安全性

通过HTTPS进行加密通信。

默认使用明文通信,可以通过启用加密选项进行加密通信。

配置

需要在Web服务器上进行配置。

需要在SVN服务器上进行配置。

功能支持

支持更多的功能,比如权限管理、日志查看等。

相对简单,功能较少。

部署HTTP访问SVN

步骤一:安装SVN

  1. 远程连接安装SVN的Linux实例。

    具体操作,请参见通过密码或密钥认证登录Linux实例

  2. 运行以下命令,安装SVN。

    sudo yum install -y subversion
  3. 运行以下命令,查看SVN版本。

    svnserve --version

    当回显类似如下所示时,说明SVN已安装。

    查看SVN版本

步骤二:安装Apache

  1. 运行以下命令,安装httpd。

    sudo yum install httpd -y
  2. 运行以下命令,查看httpd版本。

    httpd -version

    返回下图所示信息时,表示httpd服务已安装。

    image.png

步骤三:安装mod_dav_svn

mod_dav_svn是一个Apache HTTP服务器的模块,用于提供SVN(Subversion)版本控制系统的Web访问功能。

运行以下命令,安装mod_dav_svn。

sudo yum install mod_dav_svn -y

步骤四:配置SVN

  1. 依次运行以下命令,创建SVN版本库。

    sudo mkdir /var/svn
    cd /var/svn
    sudo svnadmin create /var/svn/svnrepos
  2. 运行以下命令,将SVN仓库的用户组修改为apache。

    sudo chown -R apache:apache /var/svn/svnrepos
  3. 依次运行以下命令,查看自动生成的版本库文件。

    cd svnrepos
    ls

    查看版本库文件

    Subversion目录说明如下表:

    目录

    说明

    db

    存放所有的版本控制数据文件。

    hooks

    放置hook脚本文件。

    locks

    用来追踪存取文件库的客户端。

    format

    一个文本文件,文件中只包含一个整数,表示当前文件库配置的版本号。

    conf

    SVN版本库的配置文件(版本库的访问账号、权限等)。

  4. 运行以下命令,增加SVN版本库的用户和密码。

    SVN默认使用明文密码,而HTTP并不支持明文密码,所以需要单独生成passwd文件。本示例中,增加用户userTest,密码设置为passWDTest。请根据实际情况选择并运行以下命令:

    • 如果您第一次增加用户,运行命令时需要带上参数-c生成文件。

      sudo htpasswd -c /var/svn/svnrepos/conf/passwd userTest
    • 如果您已经增加过用户,当后续还需要增加用户时,请运行以下命令。

      sudo htpasswd /var/svn/svnrepos/conf/passwd userTest

    根据提示设置用户的密码。

  5. 运行以下命令,进入conf目录下。

    cd /var/svn/svnrepos/conf/
  6. 设置账号的读写权限。

    1. 运行以下命令,打开权限控制文件。

      sudo vim authz
    2. i键进入编辑模式。

    3. 移动光标至文件末尾,并添加如下代码(其中,userTest表示账号,r表示读权限,w表示写权限)。

      [/]
      userTest=rw

      svn-4

    4. Esc键后,输入:wq保存并退出文件。

  7. 修改SVN服务配置。

    1. 运行以下命令,打开SVN服务配置文件。

      sudo vim svnserve.conf
    2. i键进入编辑模式。

    3. 移动光标找到如下配置行,删除行前面的注释符#和空格。

      说明

      每行不能以空格开始,且等号两端要有一个空格。

      anon-access = read
      auth-access = write
      password-db = passwd
      authz-db = authz
      realm = /var/svn/svnrepos

      image

    4. Esc键后,输入:wq保存并退出文件。

  8. 运行以下命令,启动SVN版本库。

    本文示例中,启动命令直接指定到版本库。

    sudo svnserve -d -r /var/svn/svnrepos/
    说明

    运行killall svnserve命令可停止SVN服务。

  9. 运行命令,查看SVN服务是否开启。

    ps -ef |grep svn

    返回下图所示信息时,表示SVN服务已经开启。查看SVN服务状态

步骤五:配置Apache

  1. 运行以下命令,新增并编辑httpd配置文件。

    sudo vim /etc/httpd/conf.d/subversion.conf
  2. i键进入编辑模式。

  3. subversion.conf文件中输入以下配置信息。

    <Location /svn>
    DAV svn
    SVNParentPath /var/svn
    AuthType Basic
    AuthName "Authorization SVN"
    AuthzSVNAccessFile /var/svn/svnrepos/conf/authz
    AuthUserFile /var/svn/svnrepos/conf/passwd
    Require valid-user
    </Location>
  4. Esc键后,输入:wq保存并退出文件。

  5. 运行以下命令,启动Apache服务。

    sudo systemctl start httpd.service

部署svnserve访问SVN

步骤一:安装SVN

  1. 远程连接安装SVN的Linux实例。

    具体操作,请参见通过密码或密钥认证登录Linux实例

  2. 运行以下命令,安装SVN。

    sudo yum install -y subversion
  3. 运行以下命令,查看SVN版本。

    svnserve --version

    当回显类似如下所示时,说明SVN已安装。

    查看SVN版本

步骤二:配置SVN

  1. 依次运行以下命令,创建SVN版本库。

    sudo mkdir /var/svn
    cd /var/svn
    sudo svnadmin create /var/svn/svnrepos
  2. 依次运行以下命令,查看自动生成的版本库文件。

    cd svnrepos
    ls

    查看版本库文件

    Subversion目录说明如下表:

    目录

    说明

    db

    存放所有的版本控制数据文件。

    hooks

    放置hook脚本文件。

    locks

    用来追踪存取文件库的客户端。

    format

    一个文本文件,文件中只包含一个整数,表示当前文件库配置的版本号。

    conf

    SVN版本库的配置文件(版本库的访问账号、权限等)。

  3. 设置SVN版本库的账号和密码。

    1. 运行以下命令,打开用户配置文件。

      cd conf/
      sudo vim passwd
    2. i键进入编辑模式。

    3. 移动光标至[users]下,添加用户账号和密码。

      说明

      添加账号和密码的格式为:账号 = 密码。例如,userTest(账号) = passWDTest(密码),如下图所示(注意等号两端要有一个空格)。

      svn-3

    4. Esc键退出编辑模式,并输入:wq保存并退出。

  4. 设置账号的读写权限。

    1. 运行以下命令,打开权限控制文件。

      sudo vim authz
    2. i键进入编辑模式。

    3. 移动光标至文件末尾,并添加如下代码(其中,userTest表示账号,r表示读权限,w表示写权限)。

      [/]
      userTest=rw

      svn-4

    4. Esc键后,输入:wq保存并退出文件。

  5. 修改SVN服务配置。

    1. 运行以下命令,打开SVN服务配置文件。

      sudo vim svnserve.conf
    2. i键进入编辑模式。

    3. 移动光标找到如下配置行,删除行前面的注释符#和空格。

      说明

      每行不能以空格开始,且等号两端要有一个空格。

      anon-access = read
      auth-access = write
      password-db = passwd
      authz-db = authz
      realm = /var/svn/svnrepos

      image

    4. Esc键后,输入:wq保存并退出文件。

  6. 运行以下命令,启动SVN版本库。

    本文示例中,启动命令直接指定到版本库。

    sudo svnserve -d -r /var/svn/svnrepos/
    说明

    运行killall svnserve命令可停止SVN服务。

  7. 运行命令,查看SVN服务是否开启。

    ps -ef |grep svn

    返回下图所示信息时,表示SVN服务已经开启。查看SVN服务状态

使用SVN

使用SVN管理代码的常见流程为:

  1. Checkout(您提取源代码到本地)。

  2. 其他人修改并提交源代码到Repository。

  3. Update(您获得最新的代码)。

  4. 您修改并调试成功源代码。

  5. Commit(提交修改后的代码到Repository,其他程序员即可看到您的修改)。

提取源代码到本地(Checkout)

  1. 在本地Windows环境中下载并安装TortoiseSVN客户端

  2. 在本地项目文件夹内的空白区域单击鼠标右键。

    本示例中,项目文件夹为C:\Test

  3. 在弹出菜单中,选择SVN Checkout...

    snv-1

  4. 填写如下信息后,单击OK

    • URL of repository:版本库URL,源代码统一存放的地址。

      • HTTP访问模式:URL格式为http://<ECS实例公网IP>/svn/<SVN版本库名>

      • svnserve访问模式:URL格式为svn://实例公网IP地址/

        说明

        当在版本库的上层目录启动SVN服务时,SVN检出的URL要对应加上版本库的名称。

    • Checkout directory:检出到本地的目录,本文示例中,目录为C:\Test

    svn-2

    说明

    第一次登录需要输入账号和密码,即您在passwd文件中设置的用户名和密码。

    检出完成示例如下。svn-5

获取更新(Update

SVN服务端系统库上的项目更新后,您可在本地项目文件空白处单击右键,选择SVN Update,即可自动完成下载最新项目,并会显示所有更新内容。

image.png

说明

在原项目文件夹内选择SVN更新,会自动覆盖原有内容。建议您先备份,再更新,防止自己原有的项目内容丢失。

提交修改(Commit

完成以下操作,提交本地修改到服务端系统库中。

  1. 在项目文件空白处单击右键,选择SVN Commit...

    image.png

  2. 输入本次提交的版本更新信息(所做修改的注释),选中要提交的操作内容,单击OK

    即可将本地项目提交到SVN服务器资源库,覆盖资源库项目从而实现更新。

    image.png

    说明
    • 如果发生提交冲突,即两人都提交修改,后提交者由于版本落后会提交失败。这时,您可以先备份自己的项目,然后从服务端下载最新的项目,并将自己的项目覆盖到本地项目文件夹,再单击SVN提交即可成功提交。

    • 若您提交的项目中删除了某个文件,则会显示如下图所示的信息。显示删除文件

还原文件

完成以下操作,还原SVN中被删除的文件。

  1. 打开本地项目文件夹,右键单击选择SVN Checkout...来检出数据。

  2. 删除其中一个文件。

  3. 根据您是否已提交修改选择相应的操作:

    • 未提交时,右键单击空白处,选择TortoiseSVN > Revert...

      image.png

    • 已提交时,服务端系统库中数据已得到同步,系统也会将其保存的数据删除。此时,您需要采取以下方法还原数据:

      1. 右键单击空白处,选择TortoiseSVN > Show log查看操作日志。

      2. 在日志中,单击删除的日志行,下方会显示已删除的数据。

        image.png

      3. 右键单击已删除的数据,然后单击Save revision to...

        image.png

      4. 在保存对话框,设置文件名,单击保存(S),将已删除的文件保存版本至删除前的位置。image.png

  4. 打开原文件夹,单击SVN Commit...,即可同步文件和系统库中的数据。

常见问题

为什么使用TortoiseSVN访问SVN服务器时服务连接,提示“主机没有反应”?

image

出现“主机没有反应”可能有以下原因:

  • SVN服务器未启动

  • 安全组中未开放SVN服务器所需端口

  • ECS实例开启了firewalld防火墙,但是未放行SVN服务器所需的端口

您可以按照以下步骤排查:

  1. 查看SVN服务状态。

    ps -ef |grep svn

    返回下图所示信息时,表示SVN服务已经开启。如果未返回以下信息,请执行sudo svnserve -d -r /var/svn/svnrepos/启动SVN服务。查看SVN服务状态

  2. 查看ECS实例所在安全组规则是否满足SVN服务器要求。

    1. HTTP模式:开放22、80、443

    2. svnserve模式:开放22、80、443、3690

  3. 查看firewalld防火墙

    1. 查看firewalld防火墙状态。

      sudo firewall-cmd --state 
      • 回显信息为not running说明firewalld防火墙未开启,对SVN服务器无影响。

      • 回显信息为running说明firewalld防火墙已开启,请继续执行下一步骤。

    2. 在firewalld规则中放行SVN服务器所需端口(例如3690)。

      sudo firewall-cmd --add-port=3690/tcp --per
    3. 重新加载firewalld服务配置,使配置生效。

      sudo systemctl reload firewalld