5154

在服务器运维和软件开发领域，CentOS 以其稳定性和企业级特性备受青睐，而 SVN（Subversion）作为一款成熟的集中式版本控制系统，在团队协作与文件同步管理中扮演着重要角色，本文将详细介绍如何在 CentOS 环境下搭建、配置 SVN 服务，并实现版本库与指定目录的文件自动同步,以确保代码或文档的更新能够实时反映到生产或测试环境中。

环境准备与 SVN 安装

确保您拥有一台可正常访问的 CentOS 服务器（本文以 CentOS 7 为例），并具备 root 或 sudo 权限，安装 SVN 的过程非常直接，通过 yum 包管理器即可完成。

打开终端，执行以下命令来安装 SVN 及其相关模块：

sudo yum install -y subversion

安装完成后，可以通过以下命令验证 SVN 是否成功安装及其版本信息：

svnserve --version

如果终端能够正常显示版本号,则说明安装成功。

创建与配置 SVN 版本库

版本库是 SVN 存储和管理所有文件及历史记录的核心，我们通常会选择一个合适的路径来存放所有的版本库，/svn。

1. 创建主目录：

   sudo mkdir -p /svn

2. 创建项目版本库： 假设我们要为一个名为 myproject 的项目创建版本库。

   sudo svnadmin create /svn/myproject

   执行后，/svn/myproject 目录下会生成一系列配置文件和子目录，如 conf、db、hooks 等。

3. 配置版本库： 配置文件位于 conf 目录下，我们需要修改三个关键文件：svnserve.conf、passwd 和 authz。

   • svnserve.conf：主配置文件,用于控制版本库的访问策略。

     [general]
     # 禁止匿名访问
     anon-access = none
     # 授权用户可读写
     auth-access = write
     # 指定密码文件路径
     password-db = passwd
     # 指定权限控制文件路径
     authz-db = authz
     # 指定版本库认证域
     realm = My Project Repository

   • passwd：用户密码文件，格式为 用户名 = 密码。

     

     [users]
     user1 = password123
     user2 = password456

   • authz：权限控制文件,可以精细地控制用户或用户组对版本库内不同路径的访问权限。

     [groups]
     # 定义用户组
     developers = user1, user2
     [myproject:/]
     # 给 developers 组根目录的读写权限
     @developers = rw
     # 其他用户无任何权限
     * =

启动 SVN 服务与客户端操作

配置完成后，即可启动 SVN 服务。svnserve 是 SVN 自带的独立服务器程序。

1. 启动服务： 使用 -d 参数以守护进程模式运行，-r 参数指定版本库的根目录。

   sudo svnserve -d -r /svn/

   服务默认监听 3690 端口，可以使用 netstat -ln | grep 3690 或 ps aux | grep svnserve 来检查服务是否正常启动。

2. 客户端基本操作： 在开发机器上，可以使用 TortoiseSVN（Windows）或命令行客户端进行操作,核心流程如下：

实现文件自动同步

标准的 SVN 工作流程需要手动 update 来获取最新文件，但在 Web 开发等场景中，我们常常希望代码提交后能自动同步到 Web 站点目录（如 /var/www/html/myproject），这可以通过 post-commit 钩子脚本来实现。

1. 创建 Web 目录：

   sudo mkdir -p /var/www/html/myproject

2. 首次检出： 将版本库内容先检出到该 Web 目录,以便后续更新。

   sudo svn checkout svn://localhost/myproject /var/www/html/myproject

   注意：此处使用 localhost 是因为脚本在服务器本机运行。

3. 编写 post-commit 钩子： 进入版本库的 hooks 目录，复制 post-commit.tmpl 模板文件并命名为 post-commit。

   cd /svn/myproject/hooks
   sudo cp post-commit.tmpl post-commit

   编辑 post-commit 文件，清空原有内容,填入以下脚本：

   

   #!/bin/sh
   # 设置SVN更新目标目录
   EXPORT_PATH="/var/www/html/myproject"
   # 执行更新操作
   /usr/bin/svn update $EXPORT_PATH --username user1 --password password123

   这里的用户名和密码需要有对该版本库的读取权限。

4. 赋予执行权限：

   sudo chmod +x /svn/myproject/hooks/post-commit

5. 处理权限问题： 确保 Web 服务器运行用户（如 apache 或 nginx）对 /var/www/html/myproject 目录有写入权限，否则 svn update 会失败。

   sudo chown -R apache:apache /var/www/html/myproject

至此，当任何有权限的用户通过客户端向 svn://[server_ip]/myproject 提交代码时，post-commit 钩子会自动触发，将最新的文件更新到 /var/www/html/myproject 目录,实现了无缝的文件同步。

相关问答FAQs

我配置了 post-commit 钩子，但提交代码后，Web 目录下的文件没有更新，该怎么办？

解答： 这是一个常见问题,请按以下步骤排查：

1. 检查脚本权限：确认 /svn/myproject/hooks/post-commit 文件具有可执行权限（chmod +x）。
2. 检查脚本内容：确保脚本中的 svn update 命令路径正确（可用 which svn 查询），用户名和密码正确无误，目标路径 EXPORT_PATH 也正确。
3. 检查日志：为了便于调试，可以在脚本中加入日志输出，/usr/bin/svn update $EXPORT_PATH --username user1 --password password123 >> /var/log/svn_hook.log 2>&1，提交后查看 /var/log/svn_hook.log 文件，里面会记录详细的错误信息,通常是权限不足或路径错误。
4. 检查目录权限：这是最常见的原因，确保运行 svn update 命令的进程（通常是 svnserve 服务以特定用户运行）或 Web 服务器用户（如 apache）对 Web 目录有完整的读写权限。

如何让不同用户只能访问 SVN 版本库中的特定子目录？

解答： 这需要通过精细配置 authz 文件来实现。authz 文件的权限控制是基于路径的，假设版本库 myproject 下有 frontend 和 backend 两个目录，您希望 user_a 只能访问 frontend，user_b 只能访问 backend，可以这样配置 authz 文件：

[groups]
# 定义用户组
frontend_devs = user_a
backend_devs = user_b
# 根目录设置，默认禁止所有访问
[myproject:/]
* =
# 为 frontend 目录设置权限
[myproject:/frontend]
@frontend_devs = rw
# 为 backend 目录设置权限
[myproject:/backend]
@backend_devs = rw

这样配置后，user_a 在检出或更新时，只能看到和操作 frontend 目录及其内容，对 backend 目录则无权访问,从而实现了严格的目录隔离。