WM-130-006-A-0_SVN服务端配置管理使用指导.doc

SVN 服务端配置管理使用指导 作者作者确认确认批准批准 姓名姓名 潘涛许娟萍林澜 日期日期 2007 12 242007 12 252007 12 27 版权所有 北京福富软件技术股份有限公司福州分公司 电信信息化部 修订历史记录修订历史记录 版号版号改号改号日期日期作者作者修订要点修订要点 A02007 12 24 潘涛新做成 目录目录 1概述概述 4 2SVN 简介简介 4 3SVN 安装指南安装指南 4 3 1相关软件 4 3 2软件安装配置 5 3 2 1安装配置SVN服务器 5 3 2 2安装配置apache服务器 5 3 2 3安装配置修改密码的cgi程序 7 4SVN 库目录结构库目录结构 9 4 1部门 SVN 工作目录 9 4 2部门 SVN 备份目录 11 5创建配置创建配置 SVN 工作库工作库 11 5 1使用TORTOISESVN 建 SVN 空库 11 5 2在 APACHE中配置 SVN 工作库 12 6创建配置创建配置 SVN 备份库备份库 13 6 1使用TORTOISESVN 建 SVN 空库 13 6 2在 APACHE中配置 SVN 备份库 13 7SVN 用户管理用户管理 14 8SVN 库权限配置库权限配置 15 1 1 概述概述 软件配置管理是项目运作的一个支撑平台 它将项目所有成员的工作协同起来 实现高效 的团队沟通 使工作成果及时共享 为进一步规范配置管理 提高软件协同开发的工作效率 电信信息化部引入开源软件 Subversion 以下简称 SVN 作为统一的版本管理工具 本文主要 对 SVN 服务端配置管理进行指导性说明 本指导书适用于电信信息化部的各产品部及南京分公司 2 2 SVNSVN 简介简介 SVN 全名 Subversion 是一种开放源码的全新版本控制系统 SVN 支持客户端通过 http https 专用的 SVN 协议 以及 SVN ssh 来访问 库目录可以不用以目录写共享的方式 让客户端直接访问 可以有效的进行权限控制 支持客户端设置代理 能有效保证数据源安全 性以及数据传输安全性 对于我们的应用 将采用 https 的方法访问 SVN 库 使用的 web 服务器需要是 apache 3 3 SVNSVN 安装指南安装指南 3 1 相关软件相关软件 SVN server SVN1 4 5 for windows 是目前最新版本 File svn win32 1 4 5 zip 下载地址 http subversion tigris org project packages html SVN client TortoiseSVN 1 4 5 是目前最新版本 下载地址 http tortoisesvn tigris org Apache server apache2 2 4 加 SSL 支持 for windows File httpd 2 2 4 win32 x86 ssl zip 下载地址 ssl zip 用户通过网页修改密码的 cgi 程序 passwd cgi 3 2 软件安装配置软件安装配置 以下以软件安装在 D svn 目录为例 SVN server 安装目录为 d svn svn win32 1 4 apache 的安装目录为 D svn Apache2 tortoiseSVN 安装路径可以任意指定 3 2 1安装配置安装配置 SVN 服务器服务器 将 SVN1 4 5 解压在 d svn svn win32 1 4 5 下 安装 TortoiseSVN 因为采用 apache 来访问 SVN 库 因此 SVN 服务器的主要作用仅为 apache 提供必要的动态库 服务端上对 SVN 库的直接操作则通过 tortoiseSVN 来进行 设置相关的环境变量 1 增加 svn 的 bin 目录到 path 环境变量中 set path d svn svn win32 1 4 5 bin path 2 设置 APR ICONV PATH set APR ICONV PATH d svn svn win32 1 4 5 iconv 3 2 2安装配置安装配置 apache 服务器服务器 将 apache 服务器安装在 d svn Apache2 目录下 然后进行配置 1 将 svn 服务器 bin 目录下的 mod dav svn so mod authz svn so 录复制到 apache 的 modules 目录下 2 修改 d svn Apache2 conf http conf 修改 apache 的安装目录 将原先配置文件里头 Apache 的目录替换为本次的 apache 的安装目录 配置文件 里头缺省是 c apache2 我们此次安装目录是 d svn Apache2 将 c apache2 全部 替换为 d svn Apache2 修改 apache 导入的模块 导入 DAV SVN 相关模块 去除下面两行行头的注释号 使 apache 导入这两个模块 LoadModule dav fs module modules mod dav fs so LoadModule dav module modules mod dav so 在 Load 模块最后增加如下两行 LoadModule dav svn module modules mod dav svn so LoadModule authz svn module modules mod authz svn so 修改 conf httpd conf 配置文件 使其包含 ssl 配置文件 httpd ssl conf 在 httpd conf 里头 有如下配置 Secure SSL TLS connections Include conf extra httpd ssl conf 去除 Include conf extra httpd ssl conf 前的注释号 将其改为 Include conf extra httpd ssl conf 3 修改 conf extra httpd ssl conf 文件 https 缺省监听端口是 443 调整为 4443 相关内容如下 Listen 4443 修改 apache 的相关目录 将其替换为 apache 的安装目录 DocumentRoot d svn Apache2 htdocs ErrorLog d svn Apache2 logs error log TransferLog d svn Apache2 logs access log 修改 SSL 相关证书密钥文件路径 Server Certificate SSLCertificateFile d svn Apache2 conf server crt Server Private Key SSLCertificateKeyFile d svn Apache2 conf server key SSL 要求有 Server Certificate 和 Server Private Key 需要在相应目录下生成 需要的认证和 key 文件 4 将 apache 的 bin 目录添加到系统的 path 变量中 5 创建名为 svn apache 的 apache 服务 敲入命令 httpd n svn apache k install 即创建了名为 svn apache 的 apache 服务 然后可以通过 windows 服务管理程序来起停该服务 连接到 https 127 0 0 1 4443 检查缺省网页是否能够正常显示 3 2 3安装配置修改密码的安装配置修改密码的 cgi 程序程序 Passwd cgi 需要放在 apache 的 cgi bin 目录下 可以根据需要更改名字 其对应的配置 文件是其名字加上 ini 后缀 一个 cgi 及其配置为一组合 可以修改一个密码文件 多个部 门 需要有多套的 cgi 及对应的 ini 文件 该文件同时需要旧版 2 0 版 的 apache 的动态链接库 libapr dll libapriconv dll libaprutil dll 这三个文件需要也放在 cgi bin 目录下 Ini 文件格式样例如下 path authuserfile F svn data ddrv ddrv passwd logfile osspass log setup passminlen 6 html title 修改开发推进部用户 SubVersion 密码 description 修改开发推进部用户 SubVersion 密码 yourname 用户名 oldpasswd 旧密码 newpasswd1 新密码 newpasswd2 验证新密码 btn change 修 改 btn reset 重 置 changepassok 成功修改密码 changepassfailed 修改密码失败 oldpasserror 旧密码错误 servererror 服务器错误 passmustgreater 密码位数必须大于 twopassnotmatched 两密码不一致 entername 请输入用户名 back 返回 通常需要修改的是上面的蓝色字体部分 Authuserfile 是需要修改的密码文件的路径 Logfile 是 log 记录 Passminlen 规定密码的最短长度 Title description 是页面上看到的窗口标题以及页面标题 4 4 SVNSVN 库目录结构库目录结构 4 1 部门部门 SVN 工作目录工作目录 以下以电信产品三部为例 目录结构如下 oss 为电信三部门用户目录 其下有 repos manage password oss share 三个目录 以及 oss passwd 文件 具体说明如下 repos 目录 repos 目录下面存放 SVN 库 一个 SVN 库对应 repos 下的一个目录 部门用户目录下面可 以有多个 SVN 库目录 可以根据项目的需要来建 SVN 库 一般一个库包含一个项目或者多个相 关项目 电信产品三部目录 repos 结构样例如下 部门名 passwd 文件 部门用户密码文件 直接在部门目录下 上图没有列出 一个部门仅有一个 passwd 文件 该部门所有的 SVN 库共享使用该文件 对应于 oss 部门其文件为 oss oss passwd manage passwd 目录 管理用户密码的管理工具目录 其下有简化的脚本命令 用来维护部门用户密码文件 可 以增加删除用户 以及修改密码 部门名 share 目录 该目录通过网络共享 部门维护人员可以通过网络共享可以直接访问 其下有两个目录 svnaccess backup a svnaccess 目录 项目的权限配置文件 每个项目在 svnaccess 目录下对应一个权限配置文件 文件名称为 项目名 access 电信产品三部样例如下 b backup 目录 存放备份脚本以及备份日志 备份脚本 svn 部门名 backup bat 一个备份脚本同步该部门所有的 SVN 库 备份日志 backup log 电信产品三部样例如下 目录用户权限 用户权限 部门用户完全权限 开发推进部用户只读 system 完全权限 4 2 部门部门 SVN 备份目录备份目录 备份目录的一个部门用户目录下 就一个 repos 目录 以及一个部门用户密码文件 repos 目录下面放备份的 SVN 库 和工作用的 SVN 库一一对应 密码文件里仅需要两个帐号 syncuser reader 同步的时候使用 syncuser 帐号进行同 步 reader 帐号用于用户读取备份库 目录用户权限 用户用户权限权限 部门用户完全权限 开发推进部用户只读 system 完全权限 5 5 创建配置创建配置 SVNSVN 工作库工作库 5 1 使用使用 tortoiseSVN 建建 SVN 空库空库 在部门用户的 repos 目录下 建立新的 SVN 库目录 点中新建的目录 点击右键菜单 选 择 TortoiseSVN create repository here 然后弹出一个对话框 指定 SVN 存储格式 保持 缺省的 FSFS 类型 即创建完成 如下图 5 2 在在 Apache 中配置中配置 SVN 工作库工作库 对于工作库 每个 SVN 库需要在 apache 的 conf 中增加一个配置段 添加在 conf 文件的 最后 DAV svn SVNPath F svn data oss repos xnglxt AuthType Basic AuthName oss fj jzgj repositories AuthUserFile F svn data oss oss passwd AuthzSVNAccessFile F svn data oss svnaccess xnglxt access Require valid user Location oss xnglxt 表示相对的 URL 路径是 svn 也就是客户端用 http s IP 4443 oss xnglxt 来访问 SVNPath 是指 SVN 库的目录 本例中 SVN 目录为 F svn data oss repos xnglxt AuthUserFile passwd 是该库使用的用户密码文件 一个部门只需要一个用户密 码文件 用户密码管理详见 AuthzSVNAccessFile 是该库的目录权限控制文件 一个工作库需要配置一个权 限文件 修改 apache 的 conf 文件 需要重启 svn apache 服务才能生效 6 6 创建配置创建配置 SVNSVN 备份库备份库 6 1 使用使用 tortoiseSVN 建建 SVN 空库空库 建库方法同 SVN 工作库 还需要在库的 hook 目录下增加两个脚本文件 pre revprop change bat 和 start commit bat 这两个脚本文件限制只有 syncuser 这个用户才可以向备份 库提交数据 这两个文件内容不需要修改 直接复制到相应库的 hook 目录下即可 Hooks rar 6 2在在 Apache 中配置中配置 SVN 备份库备份库 SVN 备份库在配置文件里头只需要为一个部门配置一个配置段 不需要为每个备份库单独 配置 DAV svn SVNListParentPath on SVNParentPath h svn backup data mss repos AuthType Basic AuthName MSS backup repositories AuthUserFile h svn backup data mss mss passwd Require valid user 对于备份库 用户文件可以仅有两个用户 一个 syncuser 用于同步写库 一个 reader 用于读库 不需要权限配置文件 SVNParentPath 是指定备份库总的目录 该目录下的目录对应每一个实际的备份库 只要在库总的目录下建好备份库 该库即可使用 SVNListParentPath on 允许浏览备份库总的目录 从而可以看到每个部门当前的备 份库情况 因此 在初次配置好 conf 文件后 此后再增加一个部门的备份库 不需要调整 conf 文件的内容 也不需要重启 apache 服务 7 7 SVNSVN 用户管理用户管理 用户管理实际上是管理 svn conf 中指定的 AuthUserFilepasswd 文件 修改该文件内容不 需要重启 apache 服务 1 使用 manage password 目录下的简化脚本 Manage password 目录下面存放管理用户密码文件的简化命令 其实是对 apache 的 htpasswd 的封装 指定了密码文件以及参数选项 c bat 初始化运行环境 进行命令行状态 设置工作目录 如果运行 manage password 下面的脚 本来管理用户 则需要首先执行 c bat 脚本 并此后在这个命令行窗口中进行后继操作 addu bat 增加用户 不在命令行指定密码 由后继提示输入 用法 addu 用户名 addd bat 增加用户 在命令行直接指定密码 用法 addd 用户名 密码 updateu bat 修改用户密码 不在命令行指定密码 由后继提示输入 用