aicoder实习svn内部培训教程

1 svn介绍

都已经用了git，为什么还要介绍svn呢？为了让aicoder.com的学员能够掌握多种的源代码管理工具的使用方法，更快的融入到项目开发中，特整理此文档。

1.1 项目管理中的版本控制问题

通常软件开发由多人协作开发，如果对代码文件、配置文件、文档等没有进行版本控制，将会出现很多问题：

• 备份多个版本，占用磁盘空间大
• 解决代码冲突困难
• 容易引发BUG
• 难于追溯问题代码的修改人和修改时间
• 难于恢复至以前正确版本
• 无法进行权限控制
• 项目版本发布困难

1.2 什么是版本控制

版本控制(Revision control)是维护工程蓝图的标准做法，能追踪工程蓝图从诞生一直到定案的过程。是一种记录若干文件内容变化，以便将来查阅特定版本修订情况的系统。

1.3 svn是什么？

SVN（Subversion）是一个开源的版本管理工具。

svn是基于客户/服务器模式：

 

image

复制-修改-合并方案(Subversion默认的模式)：

在这种模型里，每一个客户读取项目配置库建立一个私有工作副本——版本库中文件和目录的本地映射。用户并行工作，修改各自的工作副本，最终，各个私有的复制合并在一起，成为最终的版本，这种系统通常可以辅助合并操作，但是最终要靠人工去确定正误。

锁定-修改-解锁方案：

在这样的模型里，在一个时间段里配置库的一个文件只允许被一个人修改。 此模式不适合软件开发这种工作。

2 svn服务端安装配置

2.1 linux（centos7）下搭建svn服务器端

1. 从普通用户模式进入管理员模式

su

1. 安装svn

yum install subversion -y

检验是否安装上了

svnser --version
#（注意是两个 - ）

1. 创建仓库所在文件夹

mkdir /home/svndata/objects

在该文件夹下创建版本库

svnadmin create /home/svndata/objects

1. 配置SVN

找到SVN配置文件夹

cd /home/svndata/hgd/conf/

成功进入后，输入命令 ls 可以看到该目录下的文件:authz passwd svnserve.conf

• 配置svnserve.conf

vim svnserve.conf

进入文件后 按i进行编辑，将下列代码前的#和空格删去，直至顶格

anon-access=none
auth-access=write
password-db=password
realm=/home/svndata/objects #该路径为仓库路径

编辑结束后 按esc退出修改模式 后再输入:wq，即保存退出

• 配置passwd

vim passwd

密码文件内容如下：

[user]
username = password

格式：用户名=密码

修改后同上保存退出

• 配置authz

vim authz

权限有三种：rw(读写）r（只读）w(只能写）

[group]
用户组=成员1,成员2.。。。。
[/]#总权限
@用户组 = 权限
[objects:/]#下级子仓库权限
@用户组 = 权限

• 关闭防火墙

systemtcl stop firewalld.service

关闭开机启动

systemctl disable firewalld.service

查看防火墙状态

firewall-cmd --state

出现not running就表示关闭成功了

1. 启动SVN

svnserve -d -r /home/svndata/objects

至此svn就可以用了

1. 配置SVN的钩子
   进入服务器端仓库的目录，会有hooks目录。

 

hooks目录

对应修改post-commit文件就是当有提交的时候自动执行的钩子。

例如：

REPOS="$1"
REV="$2"
#DIRS=$(svnlook dirs-changed $REPOS)
#echo $DIRS | grep -c trunk
#touch /usr/local/webserver/nginx/html/index.txt
/usr/bin/svn up --force /home/svndata/scratchFile/hgd/branches/dev --username "admin" --password "xxxxxxxx"
cd /usr/local/webserver/nginx/html
rm -rf ./*
cd /home/svndata/scratchFile/hgd/branches/dev
npm i
gulp dist
cp -R /home/svndata/scratchFile/hgd/branches/dev/dist/* /usr/local/webserver/nginx/html
exit 0

3 TortoiseSVN客户端

3.1 svn客户端类型

svn客户端需要通过网络访问svn服务端提交文件、查询文件等，可通过以下客户端类型访问svn服务端：

1、使用Subversion提供的客户端命令

使用方式：在命令行下输入命令操作。

2、使用Torotise图形化界面操作（推荐）

3、使用开发工具插件操作（推荐）

3.2 下载安装

TortoiseSVN是Subversion版本控制系统的一个免费开源客户端，不需要为使用它而付费。

TortoiseSVN是 Subversion 的 Windows 扩展。它使你避免接触 Subversion 枯燥而且不方便的 Command Line。它完全嵌入 Windows Explorer，使用时只需在正常的窗口里右键操作就可以了

 

image

下载地址：https://tortoisesvn.net/downloads.html, 页面里有语言包补丁的下载链接。

目前最新版为 1.11.0 下载地址： https://osdn.net/projects/tortoisesvn/storage/1.11.0/

 

在语言补丁包中我们可以找到中文的补丁并下载下来：

 

image

运行下载的 TortoiseSVN 安装程序

 

image

运行下载的 TortoiseSVN 中文语言包

 

image

3.3 修改默认语言

修改 TortoiseSVN 默认语言

TortoiseSVN 安装完后默认的界面是英文的，我们可以通过设置修改成已安装语言

 

3.4 浏览仓库

使用Tortoise浏览svn服务端的仓库的内容：

 

image

 

image

 

image

4 关于工作上手

进入公司后，第一步就是要获取公司的源码快速上手项目。

4.1 获取用户名和仓库地址

可以找老大要一下仓库的地址，并让代码管理员帮忙创建仓库的账号和密码。

5 TortoiseSVN日常使用

5.1 浏览仓库

Repo-browser ： 浏览仓库中资源信息

 

5.2 导入导出

Export ：导出项目 ，和checkout区别 （checkout检出后文件，含有.svn隐藏文件夹， 会和SVN仓库交互， export导出，没有.svn隐藏文件夹）

 

image

import 将本地资源导入到svn 服务器

 

image

5.3 修改提交

 

image

5.3.1 Checkout

检出项目，复制项目的副本到本地。

在要检出的目录中右键：

 

image

 

image

5.3.2 add

在检出的目录中添加文件：

 

image

图标： 这是一个新文件

n Add to ignore list ：添加到忽略列表 （标记该文件不需要版本控制 ）

 

image

n Add ： 标记这个文件添加到服务器

 

image

已经标记要添加到版本库

5.3.3 Commit

当检出目录或子目录中内容有修改，目录图标变为：

提交Commit 提交本地修改至svn服务器：

在检出目录或要提交修改的目录右键：

 

 

 

提交后目录中的内容与svn服务同步，目录图标变为：

 

5.3.4 update

更新仓库的文件到本地

在检出目录或子目标或文件上右键：

 

5.3.4.1 更新到最新版本

 

5.3.4.2 更新到指定版本

 

 

5.3.5 Delete

Delete ：删除版本库文件

标记删除后，本地文件删除，标记删除后需要提交。

 

5.3.6 恢复

在检出目录或子目录操作会记录操作日志，提交前可以回滚操作。

在要回滚的检出目录或子目录中右键：

 

 

5.4 冲突处理

两个客户端同时修改同一个文件， 改动同一个位置，发生冲突情况

     如果当commit 遇到文件已经过时，说明另一个人可能改动过 ----- update

 

     db.properties 将本地和服务器合并到一起的文件 （不要直接看）

     db.properties.mine 我本地自己修改后的文件

     db.properties.r16 我修改之前的文件

     db.properties.r17 别人修改后的文件

 

手动Merge 后，需要将编辑后冲突文件，标记为已经解决 ， 再进行commit

 

6. 分支管理

6.1 合并动作 merge

假如我们在 branch 分支中对文件进行了修改或增加了文件，要 merge 回 trunk 目录中，方法很简单。以上面的例子来说，我们在 D:\runoob01\trunk目录空白处，按下鼠标右键，选择 Merge(合并):

 

这个画面主要分为三个部份，前面的 From: 与 To: 是要问您打算从 Branch 中的哪个版本到哪个版本，merge 回原来的 trunk 目录中。因此，From 跟 To 的 URL 字段应当都是指定原来 branch 的目录下。剩下的就是指定要 merge 的 revision 范围。以上面的例子而言，我们从 Branch 的 Revision 7 开始 merge 到 Branch 下面的最新版本。您可以透过，Dry run 按钮，试作一次 Merge。这个 merge 只会显示一些讯息，不会真正的更新到 trunk 的目录去。只有按下 Merge 按钮后，才会真正的将 branch 的档案与 trunk 的档案合并起来。

 

如果您确认这次的 merge 没有问题，您可以直接使用 commit 来将这两个被修改的档案 commit 回 SVN repository 上。如果有问题，您可以直接修改这两个档案，直到确认 ok 了，再行 commit。

---

6.2 制作 Tag 或是 Release

所谓的 Tag 或是 Release 就是一个特别的版本，因为这个版本可能有特别的意义。例如：这个版本是特别的 Milestone 或是 release 给客户的版本。其实，Tag 与 Release 的作法与 Branch 完全相同。只是 Branch 可能会需要 merge 回原来的 trunk 中，而 tag 及 release 大部分都不需要 merge 回 trunk 中。

举例来说，今天我们的 trunk 做了一版，这个版本被认定是软件的 1.0 版。 1.0版对于开发来说是一个非常重要的里程碑。所以我们要特别为他做一个标记，亦即 Tag。假设，这个 1.0 版是要正式 release 给客户或是相关 vendor，我们要可以为他做一个 Release 的标记。基本上，SVN 只有目录的概念，并没有什么 Tag 的用法。所以您会看到在 SVN 的选单上面，Branch 与 Tag 是同一个项目。以这个 1.0 的例子来说，我们在 runoob01 目录下创建 tags 目录用于存放打 tag 的版本，并提交到版本库，然后在 Trunk 上面，按下鼠标右键，选择 Branch/Tag 的项目：

 

 

成功的话，您就在对应的 Tag 目录下面建立了一个 v1.0 的目录。当然，如果您这时到 Tag 的目录下面去，会看不到这个目录，您需要在 Tag 目录下面 update 一下，才能看到它。

 

6.3分支工作流管理

参考老马的git分支管理教程：https://ke.qq.com/course/368468?tuin=1eb4a0a4

7. svn注意事项

1. 每次操作必须要有cmmit的消息
2. 所有的提交之前必须经过严格测试，而且必须先获取最新，然后解决冲突后再提交。
3. 下班的时候要提交一次代码（即使没有完成的代码，最好注释掉不能编译通过的部分，也要提交一次）
4. 更新的公共代码后，通知一下小伙伴，一起update一下
5. commit的消息遵守公司的规范，最好严格按照规范走
6. 公共文件最好获取lock后再修改，然后尽快释放lock
7. 提交频率最好是一个功能完成后，测试没有问题大了，就立即提交。

参考

1. AICODER官网地址：https://www.aicoder.com/