WM-130-006-A-0-SVN服務(wù)端配置管理使用指導(dǎo)

1、SVN服務(wù)端配置管理使用指導(dǎo)作者確認(rèn)批準(zhǔn)姓名潘濤許娟萍林瀾日期2007-12-242007-12-252007-12-27版權(quán)所有，北京福富軟件技術(shù)股份有限公司福州分公司電信信息化部修訂歷史記錄版號(hào)改號(hào)日期作者修訂要點(diǎn)A02007-12-24潘濤新做成目錄TOC o 1-3 h z u HYPERLINK l _Toc186368476 1概述 PAGEREF _Toc186368476 h 4 HYPERLINK l _Toc186368477 2SVN簡(jiǎn)介 PAGEREF _Toc186368477 h 4 HYPERLINK l _Toc186368478 3SVN安裝指南 PAGERE

2、F _Toc186368478 h 4 HYPERLINK l _Toc186368479 3.1相關(guān)軟件 PAGEREF _Toc186368479 h 4 HYPERLINK l _Toc186368480 3.2軟件安裝配置 PAGEREF _Toc186368480 h 5 HYPERLINK l _Toc186368481 3.2.1安裝配置SVN服務(wù)器 PAGEREF _Toc186368481 h 5 HYPERLINK l _Toc186368482 3.2.2安裝配置apache服務(wù)器 PAGEREF _Toc186368482 h 5 HYPERLINK l _Toc186

3、368483 3.2.3安裝配置修改密碼的cgi程序 PAGEREF _Toc186368483 h 7 HYPERLINK l _Toc186368484 4SVN庫(kù)目錄結(jié)構(gòu) PAGEREF _Toc186368484 h 9 HYPERLINK l _Toc186368485 4.1部門SVN工作目錄 PAGEREF _Toc186368485 h 9 HYPERLINK l _Toc186368486 4.2部門SVN備份目錄 PAGEREF _Toc186368486 h 11 HYPERLINK l _Toc186368487 5創(chuàng)建配置SVN工作庫(kù) PAGEREF _Toc1863

4、68487 h 11 HYPERLINK l _Toc186368488 5.1使用tortoiseSVN建SVN空庫(kù) PAGEREF _Toc186368488 h 11 HYPERLINK l _Toc186368489 5.2在Apache中配置SVN工作庫(kù) PAGEREF _Toc186368489 h 12 HYPERLINK l _Toc186368490 6創(chuàng)建配置SVN備份庫(kù) PAGEREF _Toc186368490 h 13 HYPERLINK l _Toc186368491 6.1使用tortoiseSVN建SVN空庫(kù) PAGEREF _Toc186368491 h 13

5、 HYPERLINK l _Toc186368492 6.2在Apache中配置SVN備份庫(kù) PAGEREF _Toc186368492 h 13 HYPERLINK l _Toc186368493 7SVN用戶管理 PAGEREF _Toc186368493 h 14 HYPERLINK l _Toc186368494 8SVN庫(kù)權(quán)限配置 PAGEREF _Toc186368494 h 15概述軟件配置管理是項(xiàng)目運(yùn)作的一個(gè)支撐平臺(tái)，它將項(xiàng)目所有成員的工作協(xié)同起來(lái)，實(shí)現(xiàn)高效的團(tuán)隊(duì)溝通，使工作成果及時(shí)共享。為進(jìn)一步規(guī)范配置管理，提高軟件協(xié)同開(kāi)發(fā)的工作效率，電信信息化部引入開(kāi)源軟件Subversi

6、on（以下簡(jiǎn)稱SVN）作為統(tǒng)一的版本管理工具，本文主要對(duì)SVN服務(wù)端配置管理進(jìn)行指導(dǎo)性說(shuō)明。本指導(dǎo)書適用于電信信息化部的各產(chǎn)品部及南京分公司。SVN簡(jiǎn)介SVN全名Subversion，是一種開(kāi)放源碼的全新版本控制系統(tǒng)。SVN支持客戶端通過(guò)http，https，專用的SVN協(xié)議，以及SVN+ssh來(lái)訪問(wèn)，庫(kù)目錄可以不用以目錄寫共享的方式讓客戶端直接訪問(wèn)?？梢杂行У倪M(jìn)行權(quán)限控制，支持客戶端設(shè)置代理，能有效保證數(shù)據(jù)源安全性以及數(shù)據(jù)傳輸安全性。對(duì)于我們的應(yīng)用，將采用https的方法訪問(wèn)SVN庫(kù)，使用的web服務(wù)器需要是apache。SVN安裝指南相關(guān)軟件SVN server：SVN1.4.5，for

7、windows，是目前最新版本File：svn-win32-1.4.5.zip下載地址： HYPERLINK /project_packages.html /project_packages.htmlSVN client：TortoiseSVN 1.4.5，是目前最新版本下載地址： HYPERLINK / /Apache server：apache2.2.4加SSL支持，for windowsFile： HYPERLINK /download/binaries/httpd-2.2.4-win32-x86-ssl.zip httpd-2.2.4-win32-x86-ssl.zip下載地址： HY

8、PERLINK /download/binaries/httpd-2.2.4-win32-x86-ssl.zip /download/binaries/httpd-2.2.4-win32-x86-ssl.zip用戶通過(guò)網(wǎng)頁(yè)修改密碼的cgi程序：passwd.cgi軟件安裝配置以下以軟件安裝在D:svn目錄為例，SVN server安裝目錄為d:svnsvn-win32-1.4., apache的安裝目錄為D:svnApache2。tortoiseSVN安裝路徑可以任意指定。安裝配置SVN服務(wù)器將SVN1.4.5解壓在d:svnsvn-win32-1.4.5下，安裝TortoiseSVN。因?yàn)椴?/p>

9、用apache來(lái)訪問(wèn)SVN庫(kù)，因此SVN服務(wù)器的主要作用僅為apache提供必要的動(dòng)態(tài)庫(kù)。服務(wù)端上對(duì)SVN庫(kù)的直接操作則通過(guò)tortoiseSVN來(lái)進(jìn)行。設(shè)置相關(guān)的環(huán)境變量：1）增加svn的bin目錄到path環(huán)境變量中set path= d:svnsvn-win32-1.4.5bin;%path%2）設(shè)置APR_ICONV_PATHset APR_ICONV_PATH= d:svnsvn-win32-1.4.5iconv安裝配置apache服務(wù)器將apache服務(wù)器安裝在d:svnApache2目錄下。然后進(jìn)行配置。將svn 服務(wù)器bin目錄下的mod_dav_svn.so、mod_auth

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

11、 modules/mod_dav.so在Load模塊最后增加如下兩行：LoadModule dav_svn_module modules/mod_dav_svn.soLoadModule authz_svn_module modules/mod_authz_svn.so修改confhttpd.conf配置文件，使其包含ssl配置文件httpd-ssl.conf。在httpd.conf里頭，有如下配置# Secure (SSL/TLS) connections#Include conf/extra/httpd-ssl.conf.去除#Include conf/extra/httpd-ssl.co

12、nf前的注釋號(hào)，將其改為Include conf/extra/httpd-ssl.conf修改confextra httpd-ssl.conf文件https缺省監(jiān)聽(tīng)端口是443，調(diào)整為4443，相關(guān)內(nèi)容如下：Listen 4443修改apache的相關(guān)目錄，將其替換為apache的安裝目錄DocumentRoot d:/svn/Apache2/htdocsErrorLog d:/svn/Apache2/logs/error_logTransferLog d:/svn/Apache2/logs/access_log修改SSL相關(guān)證書密鑰文件路徑# Server Certificate:SSLCe

13、rtificateFile d:/svn/Apache2/conf/server.crt# Server Private Key:SSLCertificateKeyFile d:/svn/Apache2/conf/server.keySSL要求有Server Certificate和Server Private Key。需要在相應(yīng)目錄下生成需要的認(rèn)證和key文件。將apache的bin目錄添加到系統(tǒng)的path變量中創(chuàng)建名為“svn-apache”的apache服務(wù)敲入命令：httpd n svn-apache k install，即創(chuàng)建了名為“svn-apache”的apache服務(wù)。然后可以

14、通過(guò)windows服務(wù)管理程序來(lái)起停該服務(wù)。連接到 HYPERLINK :4443/ :4443/檢查缺省網(wǎng)頁(yè)是否能夠正常顯示。安裝配置修改密碼的cgi程序Passwd.cgi需要放在apache的cgi-bin目錄下，可以根據(jù)需要更改名字，其對(duì)應(yīng)的配置文件是其名字加上.ini后綴。一個(gè)cgi及其配置為一組合，可以修改一個(gè)密碼文件。多個(gè)部門，需要有多套的cgi及對(duì)應(yīng)的ini文件。該文件同時(shí)需要舊版（2.0版）的apache的動(dòng)態(tài)鏈接庫(kù)libapr.dll、libapriconv.dll、libaprutil.dll。這三個(gè)文件需要也放在cgi-bin目錄下。Ini文件格式樣例如下：pathau

15、thuserfile=F:/svn_data/ddrv/ddrv_passwdlogfile=osspass.logsetuppassminlen=6htmltitle=修改開(kāi)發(fā)推進(jìn)部用戶SubVersion密碼description=修改開(kāi)發(fā)推進(jìn)部用戶SubVersion密碼yourname = 用戶名oldpasswd = 舊密碼newpasswd1 = 新密碼newpasswd2 = 驗(yàn)證新密碼btn_change = 修 改btn_reset = 重 置changepassok=成功修改密碼changepassfailed=修改密碼失敗oldpasserror=舊密碼錯(cuò)誤servere

16、rror=服務(wù)器錯(cuò)誤passmustgreater=密碼位數(shù)必須大于twopassnotmatched=兩密碼不一致entername=請(qǐng)輸入用戶名back=返回通常需要修改的是上面的藍(lán)色字體部分。Authuserfile是需要修改的密碼文件的路徑Logfile是log記錄。Passminlen規(guī)定密碼的最短長(zhǎng)度。Title、description是頁(yè)面上看到的窗口標(biāo)題以及頁(yè)面標(biāo)題。SVN庫(kù)目錄結(jié)構(gòu)部門SVN工作目錄以下以電信產(chǎn)品三部為例，目錄結(jié)構(gòu)如下：oss為電信三部門用戶目錄，其下有 repos、manage password 、oss_share三個(gè)目錄，以及oss_passwd文件，具

17、體說(shuō)明如下：repos（目錄）repos目錄下面存放SVN庫(kù)，一個(gè)SVN庫(kù)對(duì)應(yīng)repos下的一個(gè)目錄。部門用戶目錄下面可以有多個(gè)SVN庫(kù)目錄，可以根據(jù)項(xiàng)目的需要來(lái)建SVN庫(kù)。一般一個(gè)庫(kù)包含一個(gè)項(xiàng)目或者多個(gè)相關(guān)項(xiàng)目。電信產(chǎn)品三部目錄repos結(jié)構(gòu)樣例如下：部門名_passwd（文件）部門用戶密碼文件，直接在部門目錄下，上圖沒(méi)有列出。一個(gè)部門僅有一個(gè)passwd文件。該部門所有的SVN庫(kù)共享使用該文件。對(duì)應(yīng)于oss部門其文件為 oss/oss_passwd。manage passwd（目錄）管理用戶密碼的管理工具目錄，其下有簡(jiǎn)化的腳本命令，用來(lái)維護(hù)部門用戶密碼文件，可以增加刪除用戶，以及修改密碼。

18、部門名_share(目錄)該目錄通過(guò)網(wǎng)絡(luò)共享，部門維護(hù)人員可以通過(guò)網(wǎng)絡(luò)共享可以直接訪問(wèn)。其下有兩個(gè)目錄，svnaccess、backup。a)svnaccess（目錄）項(xiàng)目的權(quán)限配置文件。每個(gè)項(xiàng)目在svnaccess目錄下對(duì)應(yīng)一個(gè)權(quán)限配置文件，文件名稱為 項(xiàng)目名_access。電信產(chǎn)品三部樣例如下：b)backup（目錄）存放備份腳本以及備份日志。備份腳本：svn_部門名_backup.bat，一個(gè)備份腳本同步該部門所有的SVN庫(kù)。備份日志：backup.log電信產(chǎn)品三部樣例如下：目錄用戶權(quán)限:用戶權(quán)限部門用戶完全權(quán)限開(kāi)發(fā)推進(jìn)部用戶只讀system完全權(quán)限部門SVN備份目錄備份目錄的一個(gè)部門

19、用戶目錄下，就一個(gè)repos目錄，以及一個(gè)部門用戶密碼文件。repos目錄下面放備份的SVN庫(kù)，和工作用的SVN庫(kù)一一對(duì)應(yīng)。密碼文件里僅需要兩個(gè)帳號(hào)：syncuser、reader。同步的時(shí)候使用syncuser帳號(hào)進(jìn)行同步，reader帳號(hào)用于用戶讀取備份庫(kù)。目錄用戶權(quán)限:用戶權(quán)限部門用戶完全權(quán)限開(kāi)發(fā)推進(jìn)部用戶只讀system完全權(quán)限創(chuàng)建配置SVN工作庫(kù)使用tortoiseSVN建SVN空庫(kù)在部門用戶的repos目錄下，建立新的SVN庫(kù)目錄。點(diǎn)中新建的目錄，點(diǎn)擊右鍵菜單，選擇TortoiseSVN-create repository here，然后彈出一個(gè)對(duì)話框，指定SVN存儲(chǔ)格式，保持缺省

20、的FSFS類型，即創(chuàng)建完成。如下圖：在Apache中配置SVN工作庫(kù)對(duì)于工作庫(kù)，每個(gè)SVN庫(kù)需要在apache的conf中增加一個(gè)配置段。添加在conf文件的最后：DAV svnSVNPath F:/svn_data/oss/repos/xnglxtAuthType BasicAuthName oss fj_jzgj repositoriesAuthUserFile F:/svn_data/oss/oss_passwdAuthzSVNAccessFile F:/svn_data/oss/svnaccess/xnglxt_accessRequire valid-userLocation /oss

21、/xnglxt 表示相對(duì)的URL路徑是/svn ，也就是客戶端用http(s):/IP:4443/oss/xnglxt/來(lái)訪問(wèn)。SVNPath 是指SVN庫(kù)的目錄，本例中SVN目錄為F:/svn_data/oss/repos/xnglxt， AuthUserFile passwd是該庫(kù)使用的用戶密碼文件，一個(gè)部門只需要一個(gè)用戶密碼文件。用戶密碼管理詳見(jiàn)AuthzSVNAccessFile 是該庫(kù)的目錄權(quán)限控制文件，一個(gè)工作庫(kù)需要配置一個(gè)權(quán)限文件。修改apache的conf文件，需要重啟svn-apache服務(wù)才能生效。創(chuàng)建配置SVN備份庫(kù)使用tortoiseSVN建SVN空庫(kù)建庫(kù)方法同SVN工

22、作庫(kù)。還需要在庫(kù)的hook目錄下增加兩個(gè)腳本文件，pre-revprop-change.bat和start-commit.bat。這兩個(gè)腳本文件限制只有syncuser這個(gè)用戶才可以向備份庫(kù)提交數(shù)據(jù)。這兩個(gè)文件內(nèi)容不需要修改，直接復(fù)制到相應(yīng)庫(kù)的hook目錄下即可。在Apache中配置SVN備份庫(kù)SVN備份庫(kù)在配置文件里頭只需要為一個(gè)部門配置一個(gè)配置段。不需要為每個(gè)備份庫(kù)單獨(dú)配置。DAV svnSVNListParentPath onSVNParentPath h:/svn_backup_data/mss/reposAuthType BasicAuthName MSS backup reposi

23、toriesAuthUserFile h:/svn_backup_data/mss/mss_passwdRequire valid-user對(duì)于備份庫(kù)，用戶文件可以僅有兩個(gè)用戶，一個(gè)syncuser，用于同步寫庫(kù)。一個(gè)reader，用于讀庫(kù)。不需要權(quán)限配置文件。SVNParentPath是指定備份庫(kù)總的目錄。該目錄下的目錄對(duì)應(yīng)每一個(gè)實(shí)際的備份庫(kù)。只要在庫(kù)總的目錄下建好備份庫(kù)，該庫(kù)即可使用。SVNListParentPath on允許瀏覽備份庫(kù)總的目錄，從而可以看到每個(gè)部門當(dāng)前的備份庫(kù)情況。因此，在初次配置好conf文件后，此后再增加一個(gè)部門的備份庫(kù)，不需要調(diào)整conf文件的內(nèi)容，也不需要重啟a

24、pache服務(wù)。SVN用戶管理用戶管理實(shí)際上是管理svn conf中指定的AuthUserFilepasswd文件，修改該文件內(nèi)容不需要重啟apache服務(wù)。1）使用manage password目錄下的簡(jiǎn)化腳本Manage password目錄下面存放管理用戶密碼文件的簡(jiǎn)化命令，其實(shí)是對(duì)apache的htpasswd的封裝，指定了密碼文件以及參數(shù)選項(xiàng)。c.bat：初始化運(yùn)行環(huán)境，進(jìn)行命令行狀態(tài)，設(shè)置工作目錄。如果運(yùn)行manage password下面的腳本來(lái)管理用戶，則需要首先執(zhí)行c.bat腳本，并此后在這個(gè)命令行窗口中進(jìn)行后繼操作。addu.bat增加用戶，不在命令行指定密碼，由后繼提示輸