svn服务器及客户端安装详解

SVN 服务器 如何快速建立 Subversion 服务器 并且在项目中使用起来 这是大家最关心的问题 与 CVS 相比 Sub version 有更多的选择 也更加的容易 几个命令就可以建立一套服务器环境 可以使用起来 本手册分为以下几个部分 为了说明简单是在 windows 下使用的方式 以方便资源有限的项目使用 在 UNIX 环境下 只是安装方式不同 命令执行并无太大区别 软件下载 服务器安装 建立版本库 Repository 配置用户和权限 运行独立服务器 初始化导入 1 软件下载软件下载 到官方网站的下载二进制安装文件 来到二进制包下载部分 找到 Windows NT 2000 XP and 2003 部分 然后选择 Apache 2 0 或者 Apache 2 2 这样我们可以看到许多下载的内容 目前可以下载 Setu p Subversion 1 5 3 msi 2 服务器安装服务器安装 1 服务器安装 直接运行 Setup Subversion 1 5 3 msi 根据提示安装即可 这样我们就有了一套服 务器可以运行的环境 2 将 SVN 添加到 Windows 服务 1 新建一个文件夹用来存放库文件 c SVN 2 运行命令 SVNService install d r c svn 安装 Windows 服务 3 通过 Windows 服务管理平台启动 SVN 服务 3 其它命令 1 改变服务设置 运行命令 SVNService setup d r 在实际操作中 代表与 SubVersion 服务启动时不同的电子仓库目录 2 删除服务 运行命令 SVNService remove 系统文件配置 svnserve conf 3 建立版本库 建立版本库 Repository 运行 Subversion 服务器需要首先要建立一个版本库 Repository 可以看作服务器上存放数据的数据 库 在安装了 Subversion 服务器之后 可以直接运行 如 svnadmin create E svndemo repository 就会在目录 E svndemo repository 下创建一个版本库 我们也可以使用 TortoiseSVN 图形化的完成这一步 在目录 E svndemo repository 下 右键 TortoiseSVN Create Repository here 然后可以选择版本 库模式 这里使用默认即可 然后就创建了一系列目录和文件 4 配置用户和权限 配置用户和权限 来到 E svndemo repository conf 目录 依据实际需要修改 svnserve conf general anon access none auth access write password db passwd authz db authz realm repository 改为 anon access none auth access write password db passwd authz db authz realm repository 然后修改同目录的 passwd 文件 去掉下面三行的注释 users harry harryssecret sally sallyssecret 最后变成 users harry harryssecret sally sallyssecret 在 passwd 文件中 前的字符就是用户名 后面的就是密码 还要注意 users 前面的注释 一定要 删除掉 在 passwd 文件中进行用户的添加 5 运行独立服务器 运行独立服务器 在任意目录下运行 svnserve d r E svndemo repository 我们的服务器程序就已经启动了 注意不要关闭命令行窗口 关 闭窗口也会把 svnserve 停止 6 初始化导入 初始化导入 来到我们想要导入的项目根目录 在这个例子里是 E svndemo initproject 目录下有一个 readme txt 文 件 右键 TortoiseSVN Import 在 URL of repository 输入 svn localhost trunk 在 Import Message 中输入你的日志信息 完成之后目录没有任何变化 如果没有报错 数据就已经全部导入到了我们刚才定义的版本库中 需要注意的是 这一步操作可以完全在另一台安装了 TortoiseSVN 的主机上进行 例如运行 svnserve 的 主机的 IP 是 133 96 121 22 则 URL 部分输入的内容就是 svn 133 96 121 22 trunk 环境和软件准备 操作系统 windowsXP sp2 Window Subvsersion http subversion tigris org servlets ProjectDocumentList folderID 91 Windows 常用客户端 TortoiseSVN 请下载 subversion 服务器软件和客户端 并默认安装 可以重新启动操作系统 以更新图 标显示 2 配置管理 2 1 创建仓库 svnadmin 在硬盘上创建个空目录 作为 SVN 的仓库目录 如 E subversion repository 下面使 用两种方式创建仓库的初时文件结构和存储方式 命令方式和 TortoiseSVN 客户端方式 后面所有文档都采用两种方式说明 其功能完全相同 请根据实际情况选择使用 命令方式 DOS 下 默认方式 采用 FSFS 方式存储数据 这是推荐方式 管理和迁移相对 bdb 方式简单 svnadmin create E subversion repository 或 svnadmin create fs type bdb E subversion repository TortoiseSVN 客户端 注意在最新版本的 SVN1 4 采用本方式有兼容性问题 该客户端现在好想只支持 1 3 版 本的 SVN 创建仓库 1 使用 window exporer 或我的电脑 定位到 E subversion repository 并确保本目录为空 2 在本目录下 右键菜单中选择 TortoiseSVN Create repository here 3 在弹出的窗口中选择数据存在文件系统方式 使用默认选取 FSFS 点击确定 4 检查本目录下是否有生产的系统文件和文件夹 如果有 成功 2 2 配置服务 进入仓库目录下的 conf 文件夹 也就是 E subversion repository conf 里面有 3 个默认的配置文件 authz passwd svnserve conf svnserve conf 控制 svnserve 的启动配置选项 可以配置认证和授权方式 典型的配置是设 置由 authz 控制授权 passwd 控制认证的方式来控制访问权限 也可以使用匿名方式 但不推荐 使用 authz 和 passwd 的典型配置 请特别注意 以下三个配置文件的配置 每行有效配置前不能有空格 不然配置会失败 服务配置文件 svnserve conf 匿名方式不允许访问 anon access none Uncomment the line below to use the default password file 表示访问仓库的认证有文件 passwd 提供的账户确定 password db passwd Uncomment the line below to use the default authorization file 表示认证后的账户访问权限由文件 authz 定义 authz db authz This option specifies the authentication realm of the repository 认证配置文件 passwd passwd 文件实际提供访问本仓库的账户管理 文件格式就是 ini 方式的格式 users harry harryssecret sally sallyssecret user usersecret 这表示本仓库配置了二个用户及 其中一个用户 harry 他的访问密码是 harryssecret 访 问密码可以使用明文 也可以使用 htpasswd exe apache 服务器提供的工具方法 安装 apache 服务器后 在其 bin 目录中有该程序文件 进行加密处理 授权配置文件 authz 该文件负责认证后的用户的权限控制 配置稍微复杂 但其实也就是个 ini 配置文件而已 典型配置 groups 段提供配置组的功能 但组成员必须是 passwd 文件中定义的用户才有效 可以 对组 进行权限控制 所有组成员具有组对应的访问权限 groups 表示定义了一个管理组叫 admin group 包括 harry 和 sally admin group 前千万不 能有空格 admin group harry sally 下面就是定义具体仓库下目录的访问权限 一般对管理员来说都具有整个仓库的读写权限 一般人员对整个敞开具有读取权限 下 面 就是这样的配置 表示整个仓库的根 组的引用使用 对应的权限可以是 r w rw 或空 admin group rw r 以上的配置完成后 我吗就可以启动服务器了 下面说明服务器的启动 注意 以上 authz 和 passwd 文件在管理中因为具体项目的加入和人员的变动会经常的修 改 这也是 SVN 管理主要的工作 2 3 启动服务 svnserve Svn 服务器一般有三种方式 svnserve apache 和 SSH 其中常用的有 svnserve 和 apache 方式 本文只以 svnserve 方式讲解 总的来说 svnserve 是最高效的方式 一般应 用于内部开发网中使用 Apache 方式因为可以很好的部署在 internet 上 所以公网使用 最方便 但配置稍微相对复杂点点 呵呵 三种方式具体的优缺点 请参考本文后面 的参考文档 命令方式 DOS 下 svnserve d r E subversion repository d 参数是以独立服务的方式启动 r 是制订要加载的仓库的物理路径 Windows 系统服务 在 subversion1 4 后的版本 提供了安装为服务的支持 可以参考本文安装 SC create svn1 4 binPath C Program Files Subversion bin svnserve exe service root E subversion repository depend Tcpip start auto 1 红色部分 SVN 的安装目录 2 蓝色部分 仓库根目录 3 每个参数的格式是 参数名称 值 参数名称和 间没有空格 后必须有空格 SC 的变态特性 完全的 BUG 注意就可以了 4 本命令方式只能用于 svn1 4 以上版本 5 删除服务 sc delete svn1 4 2 4 添加项目 import 上面的安装配置工作完成后 启动服务 现在进入使用的主题 首先一步是把需要进行版 本管控的项目加入到仓库中 在作这个工作前 需要先接受下 SVN 推荐的项目路径结 构 一般推荐是使用一个 trunk 保存项目主干最新版本 breaches 保存以后的多个分支 tags 一般保存发布或阶段性发布的标签版本 如下 Project1 trunk Project1 breaches Project1 tags 下面我吗使用该目录结构 加入一个测试的项目 project1 来演示添加项目的过程 在任意目录建立文件夹 test 然后在 test 下建立上面推荐的项目目录结构 如下 test project1 trunk test project1 breaches test project1 tags 命令方式 DOS 下定位到 test 的上级目录 svn import test svn localhost m init project1 username harr y password harryssecret 新增 test project1 新增 test project1 trunk 新增 test project1 readme txt 新增 test project1 breaches 新增 test project1 tags 提交后的修订版为 1 TortoiseSVN 客户端 1 右键点击 test 目录 选择 TortoiseSVN Import 2 在弹出的操作界面中 URL repository 中输入服务器地址 svn localhost 3 在弹出的操作界面中 Import message 下面的文本域输入 init project1 4 点击 OK 5 如果第一次使用 会弹出输入账户的界面 输入对应的用户账户 选择保存 下次使用 就不用在输入账户认证信息了 查看是否添加成功 1 使用 window exporer 或我的电脑 定位到 E subversion repository 并确保本目录为 空 2 在本目录下 右键菜单中选择 TortoiseSVN Repo browser 3 在弹出的输入框中输入 SVN 服务器地址 svn localhost 4 在 Repository Browser 窗口中 你可以点击树形结构的仓库目录 查看是否存在你刚才 添加的 project1 5 如果你的用户有足够的权限 你可以在本界面的树目录上使用右键管理你的仓库和项目 2 5 工作副本 checkout 工程加入到仓库后 下面就可以进入实际的研发使用了 首先是要建立个本地的工作副本 使用 checkout 1 在任意开发机上建立工作目录 如 D workspace project