Subvision SVN (svn的服務器端)安裝教程2

六、初始化導入
下面就是將我們的數據(項目)導入到這個版本庫,以後就由版本庫管理我們的數據。我們的任何改動都回被版本庫記錄下來,甚至我們自己丟失、改錯數據時版本庫也能幫我們找回數據。
比如,我在 d:/wwwroot 下有個 guestbook 文件夾,裏面存放的是我編寫的留言簿程序。在此文件夾上“右鍵 -> TortoiseSVN -> Import...” ,在彈出對話框的“URL of repository”輸入“svn://localhost/repos1/guestbook”。在“Import message”輸入“導入整個留言簿”作爲註釋。
點 OK 後要求輸入帳號。我們在用戶名和密碼處都輸入 test 。完成後 guestbook 中的內容全部導入到了 svn://localhost/svn/repo1/guestbook 。
我們看到在 e:/svn/repo1 沒有任何變化,連個 guestbook 文件夾都沒有建立,唯一的變化就是e:/svn/repo1容量變大了。實際上我們源guestbook中的內容已經導入 repo1 版本庫了,源 guestbook 文件夾可以刪除了。

需要注意的是,這一步操作可以完全在另一臺安裝了 TortoiseSVN 的客戶機上進行。例如運行svnserve的主機的IP是133.96.121.22,則URL部分輸入的內容就是“svn://133.96.121.22” 。


七、基本操作流程
1、取出(check out)
取出版本庫到一個工作拷貝:
來到任意空目錄下,比如在f分區建立一個空文件夾 f:/work 。“右鍵 -> SVN Checkout”。在“URL of repository”中輸入“svn://localhost/svn/repo1/guestbook”,這樣我們就得到了一份 guestbook 中內容的工作拷貝。

2、存入(check in)/提交(commit)
在工作拷貝中作出修改並提交:
在 guestbook 工作拷貝中隨便打開一個文件,作出修改,然後“右鍵 -> SVN Commit... ”。這樣我們就把修改提交到了版本庫,版本庫根據情況存儲我們提交的數據。

在修改過的文件上“右鍵 -> TortoiseSVN -> Show Log” ,可以看到對這個文件所有的提交。在不同的 revision 條目上“右鍵 -> Compare with working copy”,我們可以比較工作拷貝的文件和所選 revision 版本的區別。

 

 

安裝 ApacheSVN 服務器教程:

Subversion的設計包括一個抽象的網絡層,這意味着版本庫可以通過各種服務器進程訪問。理論上講,Subversion可以使用無限數量的網絡協議實現,目前實踐中存在着兩種服務器。
?        SVNServer:svnserve是一個小的(也叫輕型的)、獨立服務器,使用自己定義的協議和客戶端。(作者注:以下稱這種服務器爲“svnserver服務器”,上面的安裝配置就是安裝svnserver服務器。)
?        ApacheSVN:Apache是最流行的web服務器,通過使用mod_dav_svn模塊,Apache可以訪問版本庫,並且可以使客戶端使用HTTP的擴展協議WebDAV/DeltaV進行訪問。(作者注:以下稱這種服務器爲“ApacheSVN服務器”)

通過 Http 協議訪問版本庫是 Subversion 的亮點之一。ApacheSVN服務器具備了許多svnserve服務器沒有的特性,使用上更加靈活,但是有一點難於配置,靈活通常會帶來複雜性。

由於 Subversion 需要版本化的控制,因此標準的 Http 協議不能滿足需求。要讓 Apache 與 Subversion 協同工作,需要使用 WebDAV(Web-based Distributed Authoring and Versioning:)Web 分佈式創作和版本控制)。WebDAV 是 HTTP 1.1 的擴展,關於 WebDAV 的規範和工作原理,可以參考 IETF RFC 2518 (http://www.ietf.org/rfc/rfc2518.txt)。

一、必備條件
爲了讓你的版本庫使用HTTP網絡,你必需具備以下幾個條件:

1、配置好httpd 2.2.x,並且使用mod_dav啓動。
2、爲mod_dav安裝mod_dav_svn插件。
3、配置你的httpd.conf,使http協議能訪問版本庫。

下面以我的配置過程詳細講解。

環境:
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 之後。

現在你已經設置了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://服務器IP/repository ,所有的Subversion版本庫在物理上位於e:/svn/repos1 。
配置完畢後重新啓動 Apache,打開瀏覽器,輸入 http://服務器IP/ repository 將會看到如下畫面:

 

這表示 Apache 的 dav_svn 模塊已經可以正常工作了。用戶可以使用任何一種 Subversion 的客戶端通過 Http 協議訪問你的版本庫。

如果想要指定多個版本庫,可以用多個 Location 標籤,也可以使用 SVNParentPath 代替 SVNPath,例如在 e:/svn 下有多個版本庫 repos1,repos2 等等,用如下方式指定:

<Location /repository>
        DAV svn
        SVNParentPath e:/svn
</Location>

“SVNParentPath e:/svn ” 表示 e:/svn 下的每個子目錄都是一個版本庫。可以通過 http://服務器IP/repository/repos1,http://服務器IP/repository/repos2 來訪問。

現在你的版本庫任何人都可以訪問,並且有完全的寫操作權限。也就是說任何人都可以匿名讀取,修改,提交,以及刪除版本庫中的內容(注:這時不需要配置E:/svn/repos/conf/svnserve.conf 文件,並且也不需要啓動E:/subversion/bin/svnserve.exe。因爲提交是通過Apache的dav模塊處理的,而不是由svnservice處理。)。我們用 TortoiseSVN 客戶端驗證即知。
顯然大部分場合這是不符合需求的。那麼如何進行權限設置呢,Apache 提供了基本的權限設置:

四、認證選項
1、基本 HTTP 認證
最簡單的客戶端認證方式是通過 HTTP 基本認證機制,簡單的使用用戶名和密碼來驗證一個用戶的身份。Apache提供了一個 htpasswd 工具來管理一個用戶文件,這個文件包含用戶名和加密後的密碼,這些就是你希望賦予 Subversion 特別權限的用戶。htpasswd 可以在 Apache 的 bin 安裝目錄下找到。具體使用方法如下:

創建用戶文件:
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 標籤中加入如下內容:

AuthType Basic
AuthName "svn repos"
AuthUserFile E:/usr/Apache2.2/bin/passwd
Require valid-user

說明:
AuthType Basic:啓用基本的驗證,比如用戶名/密碼對。
AuthName "svn repos":當一個認證對話框彈出時,出現在認證對話框中的信息。(最好用英文,TortoiseSVN 不支持中文,安裝語言包除外。)
AuthUserFile E:/usr/Apache2.2/bin/passwd:指定E:/usr/Apache2.2/bin/passwd爲用戶文件,用來驗證用戶的用戶名及密碼。
Require valid-user:限定用戶只有輸入正確的用戶名及密碼後才能訪問這個路徑

重新啓動 Apache ,打開瀏覽器訪問版本庫。Apache 會提示你輸入用戶名和密碼來認證登陸了,現在只有 passwd 文件中設定的用戶纔可以訪問版本庫。也可以配置只有特定用戶可以訪問,替換上述 "Require valid-user" 爲 "Require user tony robert" 將只有用戶文件中的 tony 和 robert 可以訪問該版本庫。

有的時候也許不需要這樣嚴格的訪問控制,例如大多數開源項目允許匿名的讀取操作,而只有認證用戶才允許寫操作。爲了實現更爲細緻的權限認證,可以使用 Limit 和 LimitExcept 標籤。例如:

<LimitExcept GET PROPFIND OPTIONS REPORT>
require valid-user
</LimitExcept>

以上配置將使匿名用戶有讀取權限,而限制只有 passwd 中配置的用戶可以使用寫操作。
如果這還不能滿足你的要求,你希望精確的控制版本庫目錄訪問,可以使用 Apache 的 mod_authz_svn 模塊對每個目錄進行認證操作。

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

現在可以在 Location 標籤中使用 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 的策略文件,詳細的權限控制可以在這個策略文件中指定。訪問文件 accesspolicy.conf 的語法與svnserve.conf和 Apache 的配置文件非常相似,以(#)開頭的行會被忽略;在它的簡單形式裏,每一小節命名一個版本庫和一個裏面的路徑;認證用戶名是在每個小節中的選項名;每個選項的值描述了用戶訪問版本庫的級別:r(只讀)或者rw(讀寫),如果用戶沒有提到或者值留空,訪問是不允許的; * 表示所有用戶,用它控制匿名用戶的訪問權限;@符號區分組和用戶。如:

[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 目錄具有讀寫權限。如果要對具體每個版本庫配置,用如下的語法:

[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 版本庫下的文件具有寫權限而不能修改版本庫 repos2 ,同樣 repos2 的 project2_commiter 組也不能修改 repos1 版本庫的文件。

 


FAQ:

1、路徑或權限不足時將出現錯誤信息提示:

http://localhost (路徑不對)
Error * PROPFIND request failed on ''/'' PROPFIND of ''/'': 200 OK (http://localhost)

http://localhost/svn (權限不足)
Error * PROPFIND request failed on ''/svn'' PROPFIND of ''/svn'': 403 Forbidden (http://localhost)

http://localhost/svn/repos (正常顯示)

http://localhost/repos (權限不允許)
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)情形如下:

現象:svn://localhost/svn/repos 不能訪問或提交,提示:Error * Can''t connect to host ''localhost'': 由於目標機器積極拒絕,無法連接。 但 file:///e:/svn/reposhttp://localhost/svn/repos 可以訪問或提交。

原因:svn:// 是獨立服務器 svnserver 自己的協議。file:/// 是本地訪問,即服務器端和客戶端在一個機器上。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章