svn 相关应用与管理

SVN 概要

一、SVN简介

Subversion（SVN）是一个开放源代码的版本控制系统，用于管理文件和目录的版本。它采用集中式的版本控制方式，即有一个中央仓库存储所有文件的版本信息，多个开发者可以从这个中央仓库获取文件副本（称为工作副本），并在完成修改后将修改提交回中央仓库。

1. 核心概念
   • 工作副本（Working Copy）：是开发者从SVN仓库中检出（check out）的文件和目录的本地副本。开发者在工作副本上进行日常的开发工作，如编辑代码、修改文档等。工作副本包含了一个特殊的目录（.svn），这个目录存储了与SVN相关的信息，如文件的版本号、原始文件的位置等。
   • 版本库（Repository）：是SVN存储所有文件版本信息的中央存储位置。它可以存储在本地文件系统中，也可以通过网络协议（如HTTP、HTTPS、SVN等）访问。版本库就像是一个文件和目录的时间胶囊，记录了每个文件和目录的历史修改情况。
   • 修订版本（Revision）：每次对版本库进行提交操作（commit），SVN都会为这次提交分配一个唯一的数字标识符，这个标识符就是修订版本号。通过修订版本号，可以追踪文件在不同时间点的状态，例如，查看某个文件在修订版本100时的内容。

二、SVN基本操作

1. 安装与配置

   • 不同操作系统有不同的安装方式。以Ubuntu为例，可以使用apt - get命令进行安装：sudo apt - get install subversion。安装完成后，需要配置SVN服务器。如果是小型团队使用，可以简单地在本地创建一个SVN仓库，使用命令svnadmin create /path/to/repository，其中/path/to/repository是仓库的实际路径。
   • 配置文件位于仓库的conf目录下，主要包括svnserve.conf（用于配置服务器选项）、passwd（用于设置用户账号和密码）和authz（用于配置用户权限）。

2. 检出（Check Out）

   • 检出操作是将版本库中的文件和目录复制到本地工作副本的过程。使用命令svn checkout [repository - url] [local - path]，例如svn checkout http://svn.example.com/repository my - working - copy，其中http://svn.example.com/repository是版本库的URL，my - working - copy是本地工作副本的路径。
   • 检出后，本地工作副本就包含了版本库中文件的初始状态，开发者可以开始在这个基础上进行修改。

3. 提交（Commit）和更新（Update）

   • 提交（Commit）：当开发者在工作副本中完成了对文件的修改并且测试通过后，可以将修改提交回版本库。使用命令svn commit -m "commit message"，其中-m选项后面的内容是提交说明，用于简要描述这次提交所做的修改。提交操作会将工作副本中的修改合并到版本库中，并为这次合并分配一个新的修订版本号。
   • 更新（Update）：在多人协作开发环境中，其他开发者可能已经将修改提交到版本库。为了获取最新的修改内容，需要在本地工作副本中进行更新操作。使用命令svn update，这个命令会将版本库中的最新文件版本下载到本地工作副本中，并自动处理文件的合并（如果有冲突的话，会提示开发者解决冲突）。

4. 查看版本历史（Log）

   • 使用命令svn log [file - path]可以查看文件或目录的版本历史。例如svn log my - file.txt会显示my - file.txt文件的所有提交记录，包括提交日期、作者、提交说明和修订版本号等信息。这对于追踪文件的修改历程和理解代码的演变非常有用。

5. 文件和目录操作

   • 添加（Add）：当在工作副本中创建了新的文件或目录后，需要使用svn add [file - path/directory - path]命令将其添加到SVN的管理范围内。例如svn add new - file.txt会将new - file.txt文件添加到待提交的列表中。
   • 删除（Delete）：如果要删除工作副本中的文件或目录，并且希望这个删除操作也反映在版本库中，需要使用svn delete [file - path/directory - path]命令。例如svn delete old - file.txt会将old - file.txt文件标记为删除状态，下一次提交时，这个文件就会从版本库中删除。

三、SVN分支与合并（Branching and Merging）

1. 分支（Branching）

   • 分支是在版本库中从一个特定的修订版本（通常是主干，trunk）创建出一个独立的开发线。创建分支的目的是为了同时进行多个不同方向的开发工作，例如，开发新功能、修复旧版本的漏洞等。使用命令svn copy [source - path] [branch - path]，例如svn copy trunk branches/new - feature会从主干trunk复制一份到branches/new - feature分支。
   • 分支创建后，开发者可以像在主干上一样在分支上进行检出、修改、提交等操作。每个分支都有自己独立的版本号序列，和主干的版本号是相互独立的。

2. 合并（Merging）

   • 当分支上的开发工作完成后，通常需要将分支的修改合并回主干或者其他分支。使用命令svn merge [source - branch - path] [target - branch - path]，例如svn merge branches/new - feature trunk会将branches/new - feature分支的修改合并到主干trunk中。
   • 合并过程可能会遇到冲突，例如，在分支和主干上对同一个文件的同一行进行了不同的修改。当遇到冲突时，SVN会在工作副本的文件中标记冲突位置，开发者需要手动解决冲突，然后重新提交合并后的文件。

四、SVN的优势与局限性

1. 优势
   • 集中管理：方便管理员对版本库进行统一管理，包括用户权限控制、备份等操作。例如，在一个公司的开发团队中，管理员可以根据不同的项目组和角色分配不同的访问权限，确保代码的安全性。
   • 简单易用：基本操作相对简单，对于初学者来说容易上手。其命令行工具的操作方式比较直观，并且有很多图形化客户端（如TortoiseSVN）可以辅助开发人员进行操作。
   • 成熟稳定：经过多年的发展和广泛应用，SVN是一个成熟的版本控制系统，在很多企业级项目中都有良好的应用记录，能够有效地管理大规模的代码库。
2. 局限性
   • 集中式架构：所有的开发工作都依赖于中央仓库，如果中央仓库出现故障（如服务器宕机、存储损坏等），会导致整个开发团队无法正常工作。虽然可以通过备份等方式来缓解这个问题，但仍然是一个潜在的风险。
   • 合并冲突处理复杂：在复杂的分支和合并场景下，尤其是多人在不同分支上对相同代码进行大量修改时，合并冲突的处理可能会比较复杂，需要开发者花费较多的时间和精力来解决。

svn 权限控制

以下是一个使用Subversion（SVN）进行团队成员权限控制的操作实例：

一、创建SVN仓库和用户账号

1. 创建仓库

   • 假设你已经安装了SVN，首先创建一个SVN仓库。使用命令svnadmin create /path/to/repository，例如svnadmin create /var/svn/myrepository。这将在/var/svn目录下创建一个名为myrepository的仓库。

2. 配置用户账号和权限文件

   • 仓库创建好后，进入仓库的conf目录（在这个例子中是/var/svn/myrepository/conf）。
   • 编辑passwd文件来添加用户账号和密码。格式如下：

   [users]
   user1 = password1
   user2 = password2
   

   • 这里创建了两个用户user1和user2，并分别设置了密码。

3. 配置权限文件（authz）

   • 编辑authz文件来设置用户对仓库不同部分的访问权限。例如：

   [groups]
   developers = user1, user2[/myrepository/trunk]
   @developers = rw
   [/myrepository/branches]
   @developers = rw
   [/myrepository/tags]
   @developers = r
   

   • 首先定义了一个名为developers的用户组，包含user1和user2。然后分别设置了用户组对仓库的trunk（主干）、branches（分支）和tags（标签）目录的访问权限。rw表示读写权限，r表示只读权限。这意味着开发人员可以对trunk和branches进行读取和写入操作（如检出、提交修改等），但对tags只能进行读取操作（因为标签通常是用于发布版本的快照，不应该被修改）。

二、客户端访问权限验证

1. 检出仓库（以用户user1为例）

   • 当用户user1想要从仓库检出文件时，使用命令svn checkout svn://your - server - ip/myrepository/trunk my - working - copy。在这个过程中，SVN会提示用户输入账号和密码，此时用户输入user1和对应的password1。如果账号密码正确并且权限设置允许，就可以成功检出trunk目录下的文件到本地my - working - copy目录。

2. 提交和更新操作

   • 当用户user1在本地工作副本中修改了文件后，可以使用svn commit -m "commit message"命令来提交修改。因为在权限文件中user1有对trunk的写入权限，所以只要提交的内容符合仓库的规则（如没有合并冲突等），就可以成功提交。
   • 同样，用户user1可以使用svn update命令来更新本地工作副本，获取其他开发人员提交的最新修改。因为有读取权限，更新操作也可以正常进行。

3. 禁止访问测试（假设尝试访问禁止的区域）

   • 假设用户user1尝试对tags目录进行写入操作，如添加一个新文件。用户先使用svn add命令添加文件到本地工作副本的tags相关目录，然后尝试提交。在提交时，SVN会根据权限设置拒绝这个操作，并返回权限错误信息，提示用户没有写入tags目录的权限。

4. 添加新用户和修改权限

   • 如果团队有新成员加入，比如添加user3。在passwd文件中添加一行user3 = password3。
   • 假设要给user3只读权限访问trunk，可以在authz文件中修改如下：

   [groups]
   developers = user1, user2
   observers = user3[/myrepository/trunk]
   @developers = rw
   @observers = r
   

   • 这样新用户user3就被添加到observers组，并且可以只读访问trunk目录了。

svn 实操实例

1. SVN冲突处理

   • 冲突产生场景：
     • 假设团队中有两个开发者，开发者A和开发者B。他们都从SVN仓库的主干（trunk）检出了同一个文件（例如example.txt）进行修改。开发者A修改了文件的第一行内容为“这是A的修改”，开发者B修改了同一行内容为“这是B的修改”。
   • 冲突发现：
     • 当开发者A先提交了修改后的文件，开发者B在提交之前进行更新（svn update）操作时，SVN会检测到冲突。此时，在开发者B的工作副本中，example.txt文件会被标记为冲突状态。文件内容可能会类似如下：

     <<<<<<<.mine
     这是B的修改
     =======
     这是A的修改
     >>>>>>>.r10（这里的r10是假设A提交后的版本号）
     

   • 冲突处理：
     • 开发者B需要手动解决冲突。可以根据实际需求决定保留哪部分修改或者融合两者的修改。例如，开发者B决定融合修改，将文件第一行修改为“这是A和B融合后的修改”。
     • 然后使用svn resolved example.txt命令告诉SVN冲突已经解决。
   • 提交处理后的文件：
     • 开发者B可以使用svn commit -m "解决了example.txt文件的冲突"命令将处理后的文件提交回SVN仓库。

2. SVN版本回退

   • 查看版本历史：
     • 首先使用svn log [文件路径]命令查看文件的版本历史。例如，对于example.txt文件，使用svn log example.txt可以看到文件的所有提交记录，包括版本号、作者、提交时间和提交说明等信息。
   • 版本回退操作：
     • 假设想要将example.txt文件回退到之前的某个版本（例如版本号为r8）。可以使用svn update -r8 example.txt命令。这样，本地工作副本中的example.txt文件就会回退到版本r8的状态。
     • 如果想要将整个工作目录回退到某个版本，可以在工作目录下执行svn update -r [版本号]命令。
     • 不过要注意，版本回退可能会导致本地修改丢失，除非这些修改已经提交或者备份。

3. SVN文件修改与提交

   • 文件修改：
     • 假设在工作副本中有一个文件newfile.txt，开发者想要添加新内容。使用文本编辑器打开newfile.txt，添加内容“这是新添加的内容”。
   • 添加文件到SVN管理：
     • 如果这是一个新文件，需要先使用svn add newfile.txt命令将其添加到SVN的管理范围。
   • 提交修改：
     • 然后使用svn commit -m "添加了新内容到newfile.txt"命令将修改后的文件提交到SVN仓库。提交后，仓库中的newfile.txt文件就会更新，并且版本号会递增。

4. SVN打标签

   • 创建标签目录（如果没有）：
     • 通常在SVN仓库中有一个专门用于存放标签（tags）的目录。如果没有，可以使用svn mkdir -m "创建标签目录" [仓库URL]/tags命令创建，例如svn mkdir -m "创建标签目录" svn://your - server - ip/your - repository/tags。
   • 打标签操作：
     • 假设当前项目达到了一个重要的里程碑，想要为当前版本的文件（例如主干trunk中的所有文件）打一个标签。首先确保本地工作副本是最新的（svn update），然后使用svn copy -m "为版本v1.0打标签" [仓库URL]/trunk [仓库URL]/tags/v1.0命令。这里v1.0是标签名称，可以根据实际情况命名。
     • 这样就创建了一个代表当前版本的标签，以后如果需要查看或恢复到这个版本的文件，可以通过标签目录中的内容来实现。例如，想要检出标签为v1.0的文件，可以使用svn checkout [仓库URL]/tags/v1.0 [本地路径]命令。

svn 备份

1. 热备份（使用svnadmin hotcopy命令）
   • 场景和目的：
     • 热备份是在SVN仓库处于运行状态下进行备份，不会中断SVN服务，适用于不能停止服务的生产环境。例如，一个团队正在进行紧张的开发工作，需要在不影响开发的情况下备份仓库。
   • 操作步骤：
     • 假设你的SVN仓库位于/var/svn/repository，想要备份到/backup/svn_repository_backup。
     • 首先确保/backup目录存在，如果不存在可以使用mkdir /backup命令创建。
     • 然后使用svnadmin hotcopy /var/svn/repository /backup/svn_repository_backup命令进行备份。
     • 这个命令会完整地复制仓库的所有内容，包括版本库的配置文件、数据文件等。备份完成后，/backup/svn_repository_backup目录下就会有一个和原始仓库结构相同的备份仓库。
2. 冷备份（停止SVN服务后备份）
   • 场景和目的：
     • 冷备份需要先停止SVN服务，然后进行备份。这种方法相对简单，但会中断服务。适用于对备份时间要求不高，且可以接受服务短暂中断的情况。
   • 操作步骤：
     • 假设使用svnserve来运行SVN服务。首先使用killall svnserve命令停止SVN服务（如果是通过其他方式运行的SVN服务，需要使用相应的停止方法）。
     • 假设SVN仓库位于/var/svn/repository，想要备份到/backup/svn_repository_backup_cold。可以使用cp -R /var/svn/repository /backup/svn_repository_backup_cold命令进行备份。这是一个简单的文件系统复制操作，复制完成后，就得到了一个仓库的备份。
     • 备份完成后，重新启动SVN服务。如果之前是使用svnserve，可以使用svnserve -d -r /var/svn/repository命令重新启动。
3. 使用脚本定期备份
   • 场景和目的：
     • 为了确保仓库数据的安全性，通常需要定期进行备份。可以编写一个脚本，结合系统的任务调度工具（如Linux下的cron）来实现自动备份。
   • 脚本示例（以热备份为例）：
     • 创建一个名为svn_backup.sh的脚本，内容如下：

     #!/bin/bash
     BACKUP_DIR="/backup/svn_repository_backup_$(date +%Y%m%d)"
     mkdir -p $BACKUP_DIR
     svnadmin hotcopy /var/svn/repository $BACKUP_DIR
     

     • 这个脚本首先创建一个以当前日期（%Y%m%d格式，表示年、月、日）命名的备份目录，然后使用svnadmin hotcopy命令将仓库备份到这个目录。
   • 设置定期执行（以Linux cron为例）：
     • 使用crontab -e命令编辑用户的定时任务。添加一行如下内容（假设每天凌晨2点备份）：

     0 2 * * * /bin/bash /path/to/svn_backup.sh
     

     • 这样，系统就会每天在凌晨2点自动执行svn_backup.sh脚本，对SVN仓库进行备份。
4. 备份到远程服务器（结合rsync）
   • 场景和目的：
     • 为了防止本地灾难（如服务器硬盘损坏）导致备份数据丢失，最好将备份数据存储到远程服务器。rsync是一个很好的工具，可以用于在本地和远程服务器之间同步文件。
   • 操作步骤：
     • 假设已经在本地完成了热备份，备份目录为/backup/svn_repository_backup，远程服务器的IP地址为192.168.1.100，远程服务器上用于存储备份的目录为/remote/backup。
     • 首先需要在本地安装rsync（如果没有安装），在Ubuntu下可以使用apt - get install rsync命令安装。
     • 然后使用rsync -avz /backup/svn_repository_backup/ 192.168.1.100:/remote/backup/命令将本地备份目录下的所有内容同步到远程服务器。-avz选项分别表示归档模式（-a）、显示详细信息（-v）和使用压缩（-z）。
     • 这样，备份数据就同时存储在本地和远程服务器上，提高了数据的安全性。