1、WM-130-006-A-0_SVN服務(wù)端配置管理使用指導(dǎo)SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0SVN 服務(wù)端配置管理使用指導(dǎo)作者確認(rèn)批準(zhǔn)姓潘濤許娟萍林瀾名日 2007-12- 2007-12- 2007-12-期2425272SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0版權(quán)所有， ? 北京福富軟件技術(shù)股份有限公司福州分公司電信信息化部修訂歷史記錄版改日期作者修訂要點號號A 0 2007- 潘濤 新做成12-243SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0目錄1概述.62SVN 簡介 .63SVN 安裝指南 .73

2、.1相關(guān)軟件 .73.2軟件安裝配置 .83.2.1安裝配置 SVN 服務(wù)器 .83.2.2安裝配置 apache 服務(wù)器 .93.2.3安裝配置修改密碼的 cgi 程序 .124SVN 庫目錄結(jié)構(gòu) .154.1部門 SVN 工作目錄 .154.2部門 SVN 備份目錄 .185創(chuàng)建配置 SVN 工作庫 .195.1使用 TORTOISE SVN 建 SVN 空庫 .195.2在 A PACHE 中配置 SVN 工作庫 .196創(chuàng)建配置 SVN 備份庫 .216.1使用 TORTOISE SVN 建 SVN 空庫 .216.2在 A PACHE 中配置 SVN 備份庫 .217SVN 用戶管理

3、 .234SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-08SVN 庫權(quán)限配置255SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-01 概述軟件配置管理是項目運作的一個支撐平臺，它將項目所有成員的工作協(xié)同起來，實現(xiàn)高效的團(tuán)隊溝通，使工作成果及時共享。為進(jìn)一步規(guī)范配置管理，提高軟件協(xié)同開發(fā)的工作效率，電信信息化部引入開源軟件 Subversion（以下簡稱 SVN）作為統(tǒng)一的版本管理工具，本文主要對 SVN服務(wù)端配置管理進(jìn)行指導(dǎo)性說明。本指導(dǎo)書適用于電信信息化部的各產(chǎn)品部及南京分公司。2 SVN簡介SVN全名 Subversion ，是一種開放源碼的全新版

4、本控制系統(tǒng)。SVN支持客戶端通過 http ，https ，專用的 SVN協(xié)議，以及 SVN+ssh來訪問，庫目錄可以不用以目錄寫共享的方式讓客戶端直接訪問。可以有效的進(jìn)行權(quán)限控制，支持客戶端設(shè)置代理，能有效保證數(shù)據(jù)源安全性以及數(shù)據(jù)傳輸安全性。6SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0對于我們的應(yīng)用，將采用 https 的方法訪問 SVN 庫，使用的 web服務(wù)器需要是 apache。3 SVN安裝指南3.1 相關(guān)軟件? SVN server ：SVN1.4.5 ，for windows ，是目前最新版本File ：svn-win32-1.4.5.zip下載地址：h

5、ttp://project_pa ckages.html? SVN client：TortoiseSVN 1.4.5，是目前最新版本下載地址：/? Apache server ：apache2.2.4 加 SSL支持，for windowsFile ： httpd-2.2.4-win32-x86-ssl.zip下載地址：/download/bi7SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0naries/httpd-2.2.

6、4-win32-x86-ssl.zip用戶通過網(wǎng)頁修改密碼的cgi 程序： passwd.cgi3.2 軟件安裝配置以下以軟件安裝在 D:svn 目錄為例， SVN server 安裝目錄為 d:svnsvn-win32-1.4. , apache 的 安 裝 目 錄 為 D:svnApache2 。 tortoiseSVN 安裝路徑可以任意指定。3.2.1安裝配置 SVN 服務(wù)器將 SVN1.4.5 解壓在 d:svnsvn-win32-1.4.5下，安裝 TortoiseSVN 。因為采用 apache 來訪問SVN庫，因此 SVN服務(wù)器的主要作用僅為 apache提供必要的動態(tài)庫。服務(wù)端

7、上對 SVN庫的直接操作則通過 tortoiseSVN 來進(jìn)行。設(shè)置相關(guān)的環(huán)境變量：1）增加 svn 的 bin 目錄到 path 環(huán)境變量中setpath=d:svnsvn-win32-1.4.5bin;%path%2）設(shè)置 APR_ICONV_PATH8SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0setAPR_ICONV_PATH=d:svnsvn-win32-1.4.5iconv3.2.2安裝配置 apache 服務(wù)器將 apache 服務(wù)器安裝在 d:svnApache2 目錄下。然后進(jìn)行配置。1） 將 svn 服務(wù)器 bin 目錄下的mod_dav_svn.s

8、o、mod_authz_svn.so 錄復(fù)制到 apache 的 modules 目錄下。2） 修改 d:svnApache2confhttp.conf? 修改 apache 的安裝目錄將原先配置文件里頭 Apache 的目錄替換為本次的 apache 的安裝目錄。配置文件里頭缺省是 c:apache2 ，我們此次安裝目錄是 d:svnApache2 ，將 c:apache2 全部替換為 d:svnApache2 。? 修改 apache 導(dǎo)入的模塊，導(dǎo)入 DAV，SVN相關(guān)模塊去除下面兩行行頭的注釋號 #，使 apache 導(dǎo)入這兩個模塊：#LoadModule dav_fs_module9

9、SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0modules/mod_dav_fs.so#LoadModule dav_modulemodules/mod_dav.so在 Load 模 最后增加如下兩行：LoadModule dav_svn_module modules/mod_dav_svn.so LoadModule authz_svn_module modules/mod_authz_svn.so? 修改 confhttpd.conf配置文件，使其包含 ssl 配置文件 httpd-ssl.conf 。在 httpd.conf 里 ，有如下配置# Secure (S

10、SL/TLS) connections #Includeconf/extra/httpd-ssl.conf .去除 #Includeconf/extra/httpd-ssl.conf前的注 號，將其改 10SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0Include conf/extra/httpd-ssl.conf3） 修改 confextra httpd-ssl.conf文件? https 缺省監(jiān)聽端口是 443，調(diào)整為 4443，相關(guān)內(nèi)容如下：Listen 4443? 修改 apache 的相關(guān)目錄，將其替換為 apache 的安裝目錄DocumentRoot d:

11、/svn/Apache2 /htdocsErrorLogd:/svn/Apache2/logs/error_logTransferLogd:/svn/Apache2/logs/access_log? 修改 SSL相關(guān)證書密鑰文件路徑# Server Certificate: SSLCertificateFile d:/svn/Apache2 /conf/server.crt11SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0#Server Private Key:SSLCertificateKeyFile d:/svn/Apache2/ conf/server.keySSL

12、要求有 Server Certificate和Server Private Key。需要在相應(yīng)目錄下生成需要的認(rèn)證和 key 文件。4） 將 apache 的 bin 目錄添加到系統(tǒng)的 path變量中5） 創(chuàng)建名為“ svn-apache ”的 apache 服務(wù)敲入命令： httpd n svn-apache k install ，即創(chuàng)建了名為“ svn-apache ”的 apache 服務(wù)。然后可以通過 windows 服務(wù)管理程序來起停該服務(wù)。連接到:4443/檢查缺省網(wǎng)頁是否能夠正常顯示。3.2.3安裝配置修改密碼的cgi 程序Passwd.cgi 需

13、要放在 apache 的 cgi-bin 目錄下，可以根據(jù)需要更改名字，其對應(yīng)的配置文件12SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0是其名字加上 .ini 后綴。一個 cgi 及其配置為一組合，可以修改一個密碼文件。多個部門，需要有多套的 cgi 及對應(yīng)的 ini 文件。該文件同時需要舊版 （2.0 版）的 apache 的動態(tài)鏈接庫 libapr.dll、libapriconv.dll、libaprutil.dll。這三個文件需要也放在cgi-bin目錄下。Ini文件格式樣例如下：pathauthuserfile=F:/svn_data/ddrv/ddrv_pas

14、swdlogfile=osspass.logsetuppassminlen=6htmltitle= 修改開發(fā)推進(jìn)部用戶 SubVersion 密碼 description= 修改開發(fā)推進(jìn)部用戶SubVersion 密碼yourname = 用戶名oldpasswd =舊密碼13SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0newpasswd1 = 新密碼newpasswd2 = 驗證新密碼btn_change =修 改btn_reset =重 置changepassok=成功修改密碼 changepassfailed= 修改密碼失敗oldpasserror= 舊密碼錯誤

15、servererror= 服務(wù)器錯誤 passmustgreater= 密碼位數(shù)必須大于 twopassnotmatched= 兩密碼不一致entername=請輸入用戶名back=返回通常需要修改的是上面的藍(lán)色字體部分。 Authuserfile 是需要修改的密碼文件的路徑 Logfile 是 log 記錄。 Passminlen 規(guī)定密碼的最短長度。Title、description是頁面上看到的窗口標(biāo)題以及頁面標(biāo)題。14SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-04 SVN庫目錄結(jié)構(gòu)4.1 部門 SVN 工作目錄以下以電信產(chǎn)品三部為例，目錄結(jié)構(gòu)如下：oss 為電信

16、三部門用戶目錄，其下有 repos 、 manage password 、oss_share 三個目錄，以及 oss_passwd 文件，具體說明如下：repos （目錄）repos 目錄下面存放 SVN庫，一個 SVN庫對應(yīng)repos 下的一個目錄。部門用戶目錄下面可以有多個 SVN庫目錄，可以根據(jù)項目的需要來建 SVN 庫。一般一個庫包含一個項目或者多個相關(guān)項目。電信產(chǎn)品三部目錄repos 結(jié)構(gòu)樣例如下：15SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0部門名 _passwd（文件）部門用戶密碼文件，直接在部門目錄下，上圖沒有列出。一個部門僅有一個 passwd 文件

17、。該部門所有的 SVN庫共享使用該文件。對應(yīng)于 oss 部門其文件為 oss/oss_passwd 。manage passwd（目錄）管理用戶密碼的管理工具目錄，其下有簡化的腳本命令，用來維護(hù)部門用戶密碼文件，可以增加刪除用戶，以及修改密碼。部門名 _share( 目錄 )該目錄通過網(wǎng)絡(luò)共享，部門維護(hù)人員可以通過網(wǎng)絡(luò)共享可以直接訪問。其下有兩個目錄，svnaccess 、backup。a)svnaccess （目錄）項目的權(quán)限配置文件。每個項目在 svnaccess 目錄下對應(yīng)一個權(quán)限配置文件， 文件名稱為 項目名 _access 。電信產(chǎn)品三部樣例如下：16SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)

18、編號： WM-130-006-A-0b)backup （目錄）存放備份腳本以及備份日志。備份腳本： svn_部門名 _backup.bat ，一個備份腳本同步該部門所有的 SVN庫。備份日志： backup.log電信產(chǎn)品三部樣例如下：目錄用戶權(quán)限 :用戶權(quán)限部門用戶完全權(quán)限開發(fā)推進(jìn)部用只讀戶system完全權(quán)限17SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-04.2 部門 SVN 備份目錄備份目錄的一個部門用戶目錄下，就一個repos 目錄，以及一個部門用戶密碼文件。repos目錄下面放備份的SVN庫，和工作用的SVN庫一一對應(yīng)。密碼文件里僅需要兩個帳號： syncus

19、er 、 reader 。同步的時候使用 syncuser 帳號進(jìn)行同步， reader 帳號用于用戶讀取備份庫。目錄用戶權(quán)限 :用戶權(quán)限部門用戶完全權(quán)限開發(fā)推進(jìn)部用戶只讀system完全權(quán)限18SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-05 創(chuàng)建配置 SVN工作庫5.1 使用 tortoiseSVN建 SVN 空庫在部門用戶的 repos 目錄下，建立新的 SVN庫目錄。點中新建的目錄，點擊右鍵菜單，選擇TortoiseSVN-create repository here，然后彈出一個對話框，指定 SVN存儲格式，保持缺省的 FSFS類型，即創(chuàng)建完成。如下圖：5.2

20、在 Apache 中配置 SVN 工作庫對于工作庫，每個 SVN庫需要在 apache 的 conf 中增加一個配置段。添加在 conf 文件的最后：DAV svnSVNPath F:/svn_data/oss/repos/xnglxt19SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0AuthType BasicAuthName oss fj_jzgj repositories AuthUserFile F:/svn_data/oss/oss_passwd AuthzSVNAccessFileF:/svn_data/oss/svnaccess/xnglxt_access

21、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是該 庫的目錄權(quán)限控制文件，一個工作庫需要配置一個權(quán)限文件。20SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-1

22、30-006-A-0修改 apache 的 conf 文件，需要重啟 svn-apache 服務(wù)才能生效。6 創(chuàng)建配置 SVN備份庫6.1 使用 tortoiseSVN建 SVN 空庫建庫方法同 SVN工作庫。還需要在庫的 hook 目錄下增加兩個腳本文件，pre-revprop-change.bat和 start-commit.bat。這兩個腳本文件限制只有 syncuser 這個用戶才可以向備份庫提交數(shù)據(jù)。這兩個文件內(nèi)容不需要修改，直接復(fù)制到相應(yīng)庫的 hook 目錄下即可。6.2在 Apache 中配置 SVN 備份庫SVN備份庫在配置文件里頭只需要為一個部門配置一個配置段。不需要為每個備

23、份庫單獨配置。DAV svnSVNListParentPath on21SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0SVNParentPathh:/svn_backup_data/mss/reposAuthType BasicAuthName MSS backup repositoriesAuthUserFileh:/svn_backup_data/mss/mss_passwdRequire valid-user對于備份庫，用戶文件可以僅有兩個用戶，一個 syncuser ，用于同步寫庫。一個reader ，用于讀庫。不需要權(quán)限配置文件。SVNParentPath 是指

24、定備份庫總的目錄。該目錄下的目錄對應(yīng)每一個實際的備份庫。只要在庫總的目錄下建好備份庫，該庫即可使用。SVNListParentPath on 允許瀏覽備份庫總的目錄，從而可以看到每個部門當(dāng)前的備份庫情況。因此，在初次配置好 conf 文件后，此后再增加一個部門的備份庫，不需要調(diào)整 conf 文22SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0件的內(nèi)容，也不需要重啟apache 服務(wù)。7 SVN用戶管理用戶管理實際上是管理svn conf中指定的AuthUserFilepasswd 文件，修改該文件內(nèi)容不需要重啟 apache 服務(wù)。1）使用 manage password

25、 目錄下的簡化腳本Manage password 目錄下面存放管理用戶密碼文件的簡化命令，其實是對 apache 的 htpasswd 的封裝，指定了密碼文件以及參數(shù)選項。c.bat ：初始化運行環(huán)境，進(jìn)行命令行狀態(tài)，設(shè)置工作目錄。如果運行 manage password 下面的腳本來管理用戶，則需要首先執(zhí)行 c.bat 腳本，并此后在這個命令行窗口中進(jìn)行后繼操作。addu.bat增加用戶，不在命令行指定密碼，由后繼提示輸入。用法： addu 用戶名addd.bat23SVN服務(wù)端配置管理使用指導(dǎo)標(biāo)準(zhǔn)編號： WM-130-006-A-0增加用戶，在命令行直接指定密碼。用法： addd 用戶名 密碼updateu.bat修改用戶密碼，不在命令行指定密碼，由后繼提示輸入。用法： updateu 用戶名resetu:修改用戶密碼，在命