Subvision SVN (svn的服務(wù)器端)安裝教程: 一、準(zhǔn)備工作 1、獲取 Subversion 服務(wù)器程序 到官方網(wǎng)站(http://subversion./)下載最新的服務(wù)器安裝程序。目前最新的是1.4.6版本,具體下載地址在:http://subversion./ser ... 100&folderID=91 ,注意找for apache 2.2.x 版本的。
2、獲取 TortoiseSVN 客戶端程序 從官方網(wǎng)站 http:///downloads 獲取最新的TortoiseSVN 。TortoiseSVN 是一個客戶端程序,用來與 subversion 服務(wù)器端通訊。Subversion 自帶一個客戶端程序 svn.exe ,但 TortoiseSVN 更好操作,提高效率。
二、安裝服務(wù)器端和客戶端 首先安裝 Apache 2.2.6 ,具體安裝方法大家參考相關(guān)資料,或者參看我寫的《Windows下安裝Apache 2.2.x》。 其次安裝 Subversion(以下簡稱SVN)的服務(wù)器端和客戶端。下載下來的服務(wù)器端是個 zip壓縮包,直接解壓縮即可,比如我解壓到 E:/subversion ??蛻舳税惭b文件是個 exe 可執(zhí)行文件,直接運行按提示安裝即可,客戶端安裝完成后提示重啟。
三、建立版本庫(Repository) 運行Subversion服務(wù)器需要首先要建立一個版本庫(Repository)。版本庫可以看作是服務(wù)器上集中存放和管理數(shù)據(jù)的地方。 開始建立版本庫。首先建立 e:/svn 空文件夾作為所有版本庫的根目錄。然后,進入命令行并切換到subversion的bin目錄。輸入如下命令:
svnadmin create E:/svn/repos1
此命令在 E:/svn 下建立一個版本庫 repos1 。repos1 下面會自動生成一些文件夾和文件。
我們也可以使用 TortoiseSVN 圖形化的完成這一步: 先建立空目錄 E:/svn/repos1 ,注意一定是要空的。然后在 repos1 文件夾上“右鍵->TortoiseSVN->Create Repository here...”,然后可以選擇版本庫模式,這里使用默認(rèn)的FSFS即可,然后就創(chuàng)建了一系列文件夾和文件,同命令行建立的一樣。
四、運行獨立服務(wù)器 此時 subversion 服務(wù)還沒有開始,只是通過它的命令建立了版本庫。繼續(xù)在剛才的命令窗口輸入:
svnserve.exe –daemon
svnserve 將會在端口 3690 等待請求,--daemon(兩個短橫線)選項告訴 svnserve 以守護進程方式運行,這樣在手動終止之前不會退出。注意不要關(guān)閉命令行窗口,關(guān)閉窗口會把 svnserve 停止。
為了驗證svnserve正常工作,使用TortoiseSVN -> Repo-browser 來查看版本庫。在彈出的 URL 對話框中輸入:
svn://localhost/svn/repo1
點 OK 按鈕后就可以看見 repo1 版本庫的目錄樹結(jié)構(gòu)了,只不過這時 repo1 是個空庫。
你也可以使用--root選項設(shè)置根位置來限制服務(wù)器的訪問目錄,從而增加安全性和節(jié)約輸入svnserve URL的時間:
svnserve.exe --daemon --root drive:/path/to/repository
以前面的測試作為例,svnserve將會運行為:
svnserve.exe --daemon --root e:/svn
然后TortoiseSVN中的版本庫瀏覽器URL縮減為:
svn://localhost/repo1
五、配置用戶和權(quán)限 用文本編輯器打開E:/svn/repos1/conf目錄,修改svnserve.conf: 將: # password-db = passwd
改為: password-db = passwd
即去掉前面的 # 注釋符,注意前面不能有空格。 然后修改同目錄的passwd文件,增加一個賬號:
將: [users] # harry = harryssecret # sally = sallyssecret
增加賬號: [users] #harry = harryssecret #sally = sallyssecret test = test
六、初始化導(dǎo)入 下面就是將我們的數(shù)據(jù)(項目)導(dǎo)入到這個版本庫,以后就由版本庫管理我們的數(shù)據(jù)。我們的任何改動都回被版本庫記錄下來,甚至我們自己丟失、改錯數(shù)據(jù)時版本庫也能幫我們找回數(shù)據(jù)。 比如,我在 d:/wwwroot 下有個 guestbook 文件夾,里面存放的是我編寫的留言簿程序。在此文件夾上“右鍵 -> TortoiseSVN -> Import...” ,在彈出對話框的“URL of repository”輸入“svn://localhost/repos1/guestbook”。在“Import message”輸入“導(dǎo)入整個留言簿”作為注釋。 點 OK 后要求輸入賬號。我們在用戶名和密碼處都輸入 test 。完成后 guestbook 中的內(nèi)容全部導(dǎo)入到了 svn://localhost/svn/repo1/guestbook 。 我們看到在 e:/svn/repo1 沒有任何變化,連個 guestbook 文件夾都沒有建立,唯一的變化就是e:/svn/repo1容量變大了。實際上我們源guestbook中的內(nèi)容已經(jīng)導(dǎo)入 repo1 版本庫了,源 guestbook 文件夾可以刪除了。
需要注意的是,這一步操作可以完全在另一臺安裝了 TortoiseSVN 的客戶機上進行。例如運行svnserve的主機的IP是133.96.121.22,則URL部分輸入的內(nèi)容就是“svn://133.96.121.22” 。
七、基本操作流程 1、取出(check out) 取出版本庫到一個工作拷貝: 來到任意空目錄下,比如在f分區(qū)建立一個空文件夾 f:/work 。“右鍵 -> SVN Checkout”。在“URL of repository”中輸入“svn://localhost/svn/repo1/guestbook”,這樣我們就得到了一份 guestbook 中內(nèi)容的工作拷貝。
2、存入(check in)/提交(commit) 在工作拷貝中作出修改并提交: 在 guestbook 工作拷貝中隨便打開一個文件,作出修改,然后“右鍵 -> SVN Commit... ”。這樣我們就把修改提交到了版本庫,版本庫根據(jù)情況存儲我們提交的數(shù)據(jù)。
在修改過的文件上“右鍵 -> TortoiseSVN -> Show Log” ,可以看到對這個文件所有的提交。在不同的 revision 條目上“右鍵 -> Compare with working copy”,我們可以比較工作拷貝的文件和所選 revision 版本的區(qū)別。
安裝 ApacheSVN 服務(wù)器教程:
Subversion的設(shè)計包括一個抽象的網(wǎng)絡(luò)層,這意味著版本庫可以通過各種服務(wù)器進程訪問。理論上講,Subversion可以使用無限數(shù)量的網(wǎng)絡(luò)協(xié)議實現(xiàn),目前實踐中存在著兩種服務(wù)器。 SVNServer:svnserve是一個小的(也叫輕型的)、獨立服務(wù)器,使用自己定義的協(xié)議和客戶端。(作者注:以下稱這種服務(wù)器為“svnserver服務(wù)器”,上面的安裝配置就是安裝svnserver服務(wù)器。) ApacheSVN:Apache是最流行的web服務(wù)器,通過使用mod_dav_svn模塊,Apache可以訪問版本庫,并且可以使客戶端使用HTTP的擴展協(xié)議WebDAV/DeltaV進行訪問。(作者注:以下稱這種服務(wù)器為“ApacheSVN服務(wù)器”)
通過 Http 協(xié)議訪問版本庫是 Subversion 的亮點之一。ApacheSVN服務(wù)器具備了許多svnserve服務(wù)器沒有的特性,使用上更加靈活,但是有一點難于配置,靈活通常會帶來復(fù)雜性。
由于 Subversion 需要版本化的控制,因此標(biāo)準(zhǔn)的 Http 協(xié)議不能滿足需求。要讓 Apache 與 Subversion 協(xié)同工作,需要使用 WebDAV(Web-based Distributed Authoring and Versioning:)Web 分布式創(chuàng)作和版本控制)。WebDAV 是 HTTP 1.1 的擴展,關(guān)于 WebDAV 的規(guī)范和工作原理,可以參考 IETF RFC 2518 (http://www./rfc/rfc2518.txt)。
一、必備條件 為了讓你的版本庫使用HTTP網(wǎng)絡(luò),你必需具備以下幾個條件:
1、配置好httpd 2.2.x,并且使用mod_dav啟動。 2、為mod_dav安裝mod_dav_svn插件。 3、配置你的httpd.conf,使http協(xié)議能訪問版本庫。
下面以我的配置過程詳細(xì)講解。
環(huán)境: OS:Windows XP SP2 Web:Apache 2.2.6 SVN:svn-win32-1.4.6
二、安裝 1、安裝Apache 具體安裝方法見:《Windows下安裝Apache 2.2.x》
2、安裝 Subversion 將下載下來的 svn-win32-1.4.6.zip 直接解壓即可,比如我解壓到 e:/subversion 。 從Subversion安裝目錄的 bin 子目錄將 intl3_svn.dll、libdb44.dll、mod_authz_svn.so、mod_dav_svn.so 拷貝到Apache的模塊目錄(Apache 安裝目錄的 modules 文件夾)。
三、基本的Apache配置 修改Apache的配置文件 httpd.conf ,使用LoadModule來加載mod_dav_svn模塊。
將 #LoadModule dav_module modules/mod_dav.so
改成: LoadModule dav_module modules/mod_dav.so
即去掉前面的“#”號。
添加: LoadModule dav_svn_module modules/mod_dav_svn.so
一定確定它在 mod_dav 之后。
現(xiàn)在你已經(jīng)設(shè)置了Apache和Subversion,但是Apache不知道如何處理Subversion客戶端,例如TortoiseSVN。為了讓Apache知道哪個目錄是用來作為Subversion版本庫,你需要使用編輯器(例如記事本)編輯Apache的配置文件。
在配置文件最后添加如下幾行:
<Location / repository> DAV svn<
br /> SVNPath e:/svn/repos1 </Location>
這個配置告訴Apache首先需要啟用 dav_module,然后加載 dav_svn_module 。版本庫對外的URL是:http://服務(wù)器IP/repository ,所有的Subversion版本庫在物理上位于e:/svn/repos1 。 配置完畢后重新啟動 Apache,打開瀏覽器,輸入 http://服務(wù)器IP/ repository 將會看到如下畫面:
這表示 Apache 的 dav_svn 模塊已經(jīng)可以正常工作了。用戶可以使用任何一種 Subversion 的客戶端通過 Http 協(xié)議訪問你的版本庫。
如果想要指定多個版本庫,可以用多個 Location 標(biāo)簽,也可以使用 SVNParentPath 代替 SVNPath,例如在 e:/svn 下有多個版本庫 repos1,repos2 等等,用如下方式指定:
<Location /repository> DAV svn SVNParentPath e:/svn </Location>
“SVNParentPath e:/svn ” 表示 e:/svn 下的每個子目錄都是一個版本庫??梢酝ㄟ^ http://服務(wù)器IP/repository/repos1,http://服務(wù)器IP/repository/repos2 來訪問。
現(xiàn)在你的版本庫任何人都可以訪問,并且有完全的寫操作權(quán)限。也就是說任何人都可以匿名讀取,修改,提交,以及刪除版本庫中的內(nèi)容(注:這時不需要配置E:/svn/repos/conf/svnserve.conf 文件,并且也不需要啟動E:/subversion/bin/svnserve.exe。因為提交是通過Apache的dav模塊處理的,而不是由svnservice處理。)。我們用 TortoiseSVN 客戶端驗證即知。 顯然大部分場合這是不符合需求的。那么如何進行權(quán)限設(shè)置呢,Apache 提供了基本的權(quán)限設(shè)置:
四、認(rèn)證選項 1、基本 HTTP 認(rèn)證 最簡單的客戶端認(rèn)證方式是通過 HTTP 基本認(rèn)證機制,簡單的使用用戶名和密碼來驗證一個用戶的身份。Apache提供了一個 htpasswd 工具來管理一個用戶文件,這個文件包含用戶名和加密后的密碼,這些就是你希望賦予 Subversion 特別權(quán)限的用戶。htpasswd 可以在 Apache 的 bin 安裝目錄下找到。具體使用方法如下:
創(chuàng)建用戶文件: htpasswd -c /etc/svn/passwordfile username
添加新用戶(-m 表示以MD5加密密碼): htpasswd [-m] /etc/svn/passwordfile Newusername
更改用戶密碼: htpasswd [-m] /etc/svn/passwordfile username
刪除用戶(要用大寫的 D ): htpasswd –D /etc/svn/passwordfile username
接下來修改 httpd.conf,在 Location 標(biāo)簽中加入如下內(nèi)容:
AuthType Basic AuthName "svn repos" AuthUserFile E:/usr/Apache2.2/bin/passwd Require valid-user
說明: AuthType Basic:啟用基本的驗證,比如用戶名/密碼對。 AuthName "svn repos":當(dāng)一個認(rèn)證對話框彈出時,出現(xiàn)在認(rèn)證對話框中的信息。(最好用英文,TortoiseSVN 不支持中文,安裝語言包除外。) AuthUserFile E:/usr/Apache2.2/bin/passwd:指定E:/usr/Apache2.2/bin/passwd為用戶文件,用來驗證用戶的用戶名及密碼。 Require valid-user:限定用戶只有輸入正確的用戶名及密碼后才能訪問這個路徑
重新啟動 Apache ,打開瀏覽器訪問版本庫。Apache 會提示你輸入用戶名和密碼來認(rèn)證登陸了,現(xiàn)在只有 passwd 文件中設(shè)定的用戶才可以訪問版本庫。也可以配置只有特定用戶可以訪問,替換上述 "Require valid-user" 為 "Require user tony robert" 將只有用戶文件中的 tony 和 robert 可以訪問該版本庫。
有的時候也許不需要這樣嚴(yán)格的訪問控制,例如大多數(shù)開源項目允許匿名的讀取操作,而只有認(rèn)證用戶才允許寫操作。為了實現(xiàn)更為細(xì)致的權(quán)限認(rèn)證,可以使用 Limit 和 LimitExcept 標(biāo)簽。例如:
<LimitExcept GET PROPFIND OPTIONS REPORT> require valid-user </LimitExcept>
以上配置將使匿名用戶有讀取權(quán)限,而限制只有 passwd 中配置的用戶可以使用寫操作。 如果這還不能滿足你的要求,你希望精確的控制版本庫目錄訪問,可以使用 Apache 的 mod_authz_svn 模塊對每個目錄進行認(rèn)證操作。
2、用 mod_authz_svn 進行目錄訪問控制 首先需要讓 Apache 將 mod_authz_svn 模塊加載進來。在 Subversion 的安裝目錄中找到 mod_auth_svn 模塊,將其拷貝到 Apache 安裝目錄的 modules 子目錄下。修改 httpd.conf 文件,添加:
LoadModule authz_svn_module modules/mod_authz_svn.so
現(xiàn)在可以在 Location 標(biāo)簽中使用 authz 的功能了。一個基本的 authz 配置如下:
<Location /repository> DAV svn SVNParentPath e:/svn # our access control policy AuthzSVNAccessFile E:/usr/Apache2.2/bin/accesspolicy.conf # try anonymous access first, resort to real # authentication if necessary. Satisfy Any Require valid-user # how to authenticate a user AuthType Basic AuthName "Subversion repository" AuthUserFile E:/usr/Apache2.2/bin/passwd </Location>
AuthzSVNAccessFile 指向的是 authz 的策略文件,詳細(xì)的權(quán)限控制可以在這個策略文件中指定。訪問文件 accesspolicy.conf 的語法與svnserve.conf和 Apache 的配置文件非常相似,以(#)開頭的行會被忽略;在它的簡單形式里,每一小節(jié)命名一個版本庫和一個里面的路徑;認(rèn)證用戶名是在每個小節(jié)中的選項名;每個選項的值描述了用戶訪問版本庫的級別:r(只讀)或者rw(讀寫),如果用戶沒有提到或者值留空,訪問是不允許的; * 表示所有用戶,用它控制匿名用戶的訪問權(quán)限;@符號區(qū)分組和用戶。如:
[groups] committers = paulex, richard developers = jimmy, michel, spark, sean
[/] * = r @committers = rw
[/branches/dev] @developers = rw
[/tags] tony = rw [/private] * = @committers= r
使用 SVNParentPath 代替 SVNPath 來指定多個版本庫的父目錄時,其中所有的版本庫都將按照這個策略文件配置。例如上例中 tony 將對所有版本庫里的 /tags 目錄具有讀寫權(quán)限。如果要對具體每個版本庫配置,用如下的語法:
[groups] project1_committers = paulex, richard project2_committers = jimmy, michel, spark, tony, Robert
[repos1:/] * = r @ project1_committer = rw
[repos2:/] * = r @ project2_committer = rw
這樣 repos1的 project1_committer 組只能對 repos1 版本庫下的文件具有寫權(quán)限而不能修改版本庫 repos2 ,同樣 repos2 的 project2_commiter 組也不能修改 repos1 版本庫的文件。
FAQ:
1、路徑或權(quán)限不足時將出現(xiàn)錯誤信息提示:
http://localhost (路徑不對) Error * PROPFIND request failed on ''/'' PROPFIND of ''/'': 200 OK (http://localhost)
http://localhost/svn (權(quán)限不足) Error * PROPFIND request failed on ''/svn'' PROPFIND of ''/svn'': 403 Forbidden (http://localhost)
http://localhost/svn/repos (正常顯示)
http://localhost/repos (權(quán)限不允許) Error * PROPFIND request failed on ''/repos'' PROPFIND of ''/repos'': 405 Method Not Allowed (http://localhost)
2、不啟動E:/subversion/bin/svnserve.exe ,但啟動了ApacheSVN ,訪問(tortoiseSVN –> Repo – browser)或提交(SVN Commit)情形如下:
現(xiàn)象:svn://localhost/svn/repos 不能訪問或提交,提示:Error * Can''t connect to host ''localhost'': 由于目標(biāo)機器積極拒絕,無法連接。 但 file:///e:/svn/repos 和 http://localhost/svn/repos 可以訪問或提交。
原因:svn:// 是獨立服務(wù)器 svnserver 自己的協(xié)議。file:/// 是本地訪問,即服務(wù)器端和客戶端在一個機器上。
|