SVN快速指南(轉)


假設subversion倉庫的地址是[url]http://server/svn[/url]

a) check out
svn checkout [url]http://server/svn[/url]
即可在當前目錄下建立一個工作拷貝,目錄名是svn

b) update
使用命令svn update可以用服務器的版本更新你的工作拷貝

c) add
使用命令 svn add filename可以把filename這個文件或者目錄以及目錄下面的所有文件標誌爲添加狀態(實際上它並沒有立即添加,你可以查看服務器,這些文件都 還沒有添加進去的!),下一次你提交(commit)這些文件的時候,服務器就會把他們添加到版本庫。


d) stat
使用svn stat可以查看文件狀態(也就是是否被修改等)

e) commit
使用svn commit filename --message "leave words about this commit",可以提交本地修改到服務器。如果不使用--message選項,則svn會自動打開一個配置文件所指向的編輯器,裏面默認有一些修改信 息,你可以把這些信息作爲附註提交到服務器。或者你也可以不使用--message而使用--file 來指定一個文件作爲提交時的附註。

f) switch

有時候管理員修改了版本庫的地址,比如修改了主機地址,修改了url等,此時客戶端也需要相應的修改:

svn switch --relocate [url]http://xiao/svn[/url] [url]http://xiao:81/svn[/url]

第一個地址是原來的版本庫地址(用svn info可以看到),後面的是新的版本庫地址。

優點:

1) 基於目錄的版本控制

傳統的CVS或VSS都是基於單個文件進行版本控制的,這實際上滿足不了實際需求,因爲在實際應用中,我們都希望按照項目或者工程進行管理,例如假設我們想要取出某個歷史時間點的整個項目文件,那麼基於文件的版本控制系統就存在弊端,只能單個單個文件的處理。而SVN則能很方便的做到這一點,你可以隨意的取出任何一個文件、任何一個目錄的任何一個歷史版本。

SVN還允許對文件和目錄進行增加、刪除以及複製和重命名等操作,這些都會被記錄到歷史信息中,實現真正的版本控制功能。

2) 原子提交

SVN裏的每次操作都是原子的,要麼全部成功,要麼全部失敗。假設你要提交多個文件,如果有一個存在衝突,那麼其它修改都不會被提交。

3) 高效的分支(branching)與標籤(tagging)功能

先說標籤功能,通俗的講,標籤就是某個時間點的快照(snapshot),我們可以在項目進行到一些重要的里程碑之時爲之建立標籤,這樣可以方便以後隨時取出這些歷史版本。我想你會有一個疑問:SVN不是本身就有隨意取出任何一個歷史版本的功能嗎?是的,標籤的作用主要是爲了給這些特定的歷史版本取一個友好的名字,以方便使用和維護。

分支則是用於創建多個並行的工作線,比如,當我們的一個項目需要爲某個用戶提供一些特殊的功能時,那麼就可以爲之創建一個分支,這樣能夠保正大部分代碼的共用,也使得整個項目變得容易維護和管理。

SVN對於分支和標籤的實現都是一樣的,並且採用了與Unix/Linux硬鏈接(Hard-Link)類似的機制,即是說,當我們創建分支或標籤時,SVN並不會立即爲之創建一份拷貝,而是創建一個鏈接,只有當這些文件以後被修改時纔會真正產生一份副本。這種“緩式拷貝”方法是一種常見的優化方法,能夠有效的節約空間。

那分支和標籤又有什麼不同呢?不同之處僅僅在於其“約定成俗”的含義,標籤意味着你不會再對其進行修改,而分支意味着你會對它進行開發。

4) 多種訪問方式

SVN提供了一個抽象的網絡訪問層,可以通過不同的協議來對其進行訪問。首先,SVN提供了自定義的svn協議訪問方式,通過形如svn://host/repository的URL就能使用。再有,SVN還提供了與Apache Web服務器相集成的功能,這樣,我們就可以通過http://host/repository的方式來訪問SVN了。

5) 對二進制文件的支持

CVS雖然對二進制文件也有支持,但實現得並不完善,你或許遇到過文本文件裏有中文字符而被認爲是二進制文件的事情,SVN則提供了對二進制文件全面的支持,使得非文本文件也能跟文本文件一樣進行良好的版本控制。

6) Windows下與資源管理器集成的客戶端:TortoiseSVN

SVN本身只提供命令行的操作方式,TortoiseSVN是第三方開發的圖形化界面,它的出現使Windows下的版本管理變得非常方便。不過,由於是嵌入到資源管理器中,它可能會影響系統的速度——微乎其微,你可以自己評測一下。

7) 平臺無關

SVN秉承了開源軟件的一貫優點,無論是Windows還是Linux平臺,都可以相互訪問SVN服務器。

 

如果你過去是VSS用戶,那麼這裏還要提一點,與VSS相比,SVN還有一個理念不一樣,VSS將版本衝突控制放在操作之前,你要操作某個項目必須先執行CheckOut以進行鎖定、防止他人同時修改。SVN提供了同樣的Lock功能,但通常情況下,我們只需各自獨立的進行修改而無需鎖定項目,如果有衝突在提交的時候再做處理,也就是說,SVN是將衝突控制放在操作之後、提交之時。也許你會覺得VSS更合理,但實際情況卻相反,因爲在我們的實際使用中經常發生有人將整個項目CheckOut後忘了CheckIn,或者未選擇Recursive忘了將子目錄中的文件CheckIn,這就讓其他人無法修改,於是不得不人爲的通知其本人,非常麻煩。

 

2. SVN服務器搭建

本節是針對管理員寫的,普通用戶可以跳過本節。我這裏只以Windows上的安裝爲例,Linux上可按類似方式進行(有些配置參數會存在差別,具體參考幫助手冊)。

1) 安裝SVN服務器

a. 下載

SVN的官方網站爲http://subversion.tigris.org/,當前最新版本爲1.4.2。Windows下的二進制安裝包分爲兩種,一種是以setup結尾的安裝文件,另一種是普通的壓縮包文件,setup文件會自動註冊一些信息,比如環境變量以及服務等,這些都是可以自己手動實現的。在我寫這篇文章時,官方網站上就只有普通二進制文件,估計setup文件稍晚些時候會出來。特別注意,下載時要詳細閱讀注意事項,看清與之配套的軟件的版本號,避免出現問題。

我選擇的版本爲svn-win32-1.4.2.zip

b. 安裝

將svn-win32-1.4.2.zip解壓縮到安裝目錄下,我選擇的是C:/Program Files/Subversion,如果是setup文件,直接運行安裝文件即可。對於壓縮包,我們可以將bin路徑添加到系統環境變量中,以方便操作。可以看到,bin目錄下主要有如下幾個文件:

svnadmin:倉庫管理工具,包括創建、修復和備份等操作。

svnlook:倉庫查看工具,包括信息、日誌和鎖定狀態等內容,不會造成倉庫的改動。

svnserve:svn服務程序,允許通過svn網絡協議來訪問倉庫。

svn:SVN客戶端,用於訪問倉庫,對項目進行版本管理。

svnversion:客戶端工具,用於查看本地拷貝的修訂信息。

c. 創建倉庫(Repository)

SVN是以倉庫爲版本控制單位的,一個SVN服務器可以管理多個倉庫,每個倉庫擁有獨立的修訂號(REVISION),倉庫中的任何一次更新都會帶來修訂號的遞增。你可以根據需要選擇建立一個或者多個倉庫,這裏,我以創建多個倉庫爲例子,假設我們將倉庫都放到D:/SVN_REPOS目錄下,下面的命令將會在該目錄下創建一個Test倉庫:

svnadmin create D:/SVN_REPOS/Test

如果創建成功,D:/SVN_REPOS/下將會多一個Test目錄。

2) 搭建svnserve訪問方式

svn和http是兩種並列的訪問方式,你可以選擇其中一種,也可以都採用。

a. 註冊服務

爲了讓SVN服務程序每次開機後自動運行,我們需要將其註冊爲服務。在控制檯中執行如下命令:

sc create svnservice binPath= "/"C:/Program Files/Subversion/bin/svnserve.exe/" --service -r D:/SVN_REPOS" start= auto

注意,上述命令均在一行中。sc.exe是Windows 2000以後系統自帶的一個工具,2000下沒有,可以從XP上拷過來。svnservice爲服務名稱,後面的參數格式有嚴格要求,等號前面沒有空格而後面有。binPath本身帶有多個參數,因此用引號括起來,而由於路徑裏面又有空格,因此又加上了一層引號。 --service和-r均爲svnserve.exe的參數,前者要求它作爲服務運行,後者指明瞭倉庫的根路徑(多倉庫爲倉庫的父目錄)。

帶安裝包的SVN會自動註冊服務,這時我們可能需要修改-r參數,命令如下:

sc config svnservice binPath= "/"C:/Program Files/Subversion/bin/svnserve.exe/" --service -r D:/SVN_REPOS"

b. 訪問

註冊完後,通過運行sc start svnservice或者服務管理器(service.msc)啓動服務。

接下來,我們就可以通過下面的命令來測試系統是否工作正常:

svn info svn://localhost/Test

如果正確的顯示出倉庫的相關信息,那麼就大功告成了,否則請檢查服務的參數是否配置正確,比如,如果未在服務參數中指定正確的-r值,就會得到如下錯誤:

No repository found in 'svn://localhost/Test'

如果安裝了TortoiseSVN,則可以直接在瀏覽器中輸入svn://localhost/Test,這樣會調出TortoiseSVN的Repos-Browser。到此,你就可以通過TortoiseSVN來導入工程進行版本管理了(參見後文)。

c. 權限配置

在進行權限配置前,所有的用戶都能進行任何操作,在很多情況下是不允許的。在創建倉庫時,倉庫目錄下都會生成好幾個文件夾,其中conf裏面存儲的是配置信息,包括三個文件:

authz:訪問權限配置

passwd:用戶名和密碼配置

svnserve.conf:基本配置信息

先配置svnserve.conf,將裏面幾項配置前的註釋去掉,最後的內容如下:

[general]

anon-access = read

auth-access = write

password-db = passwd

authz-db = authz

這些參數的含義文件裏都有詳細說明,其中,anon-access和auth-access分別是對匿名用戶以及認證用戶的訪問控制,password-db指明用戶密碼文件路徑,authz-db指明權限配置文件路徑。另外還有一個參數realm用於指明倉庫所屬的認證域,默認情況下每個倉庫位於不同的域(每個倉庫有一個唯一的uuid),因此我們可以不設置該項,除非多個倉庫需要共用同一份passwd配置。

passwd文件的配置很簡單,格式如下(等號前面爲用戶名,後面爲密碼):

[users]

harry = 123

sally = 123

guest = 123

authz則可以創建用戶組並精確配置某個用戶或用戶組對某個文件或目錄的訪問權限,下面是一個例子:

[groups]

harry_and_sally = harry,sally

 

[/]

* = r

[/project1]

* =

harry = rw

sally = r

[/project1/foo]

sally =

[/project2]

@harry_and_sally = rw

guest = r

文件內容其實很簡單易懂,groups用於定義用戶組,後面便是對資源的具體訪問控制,/表示倉庫根目錄,*表示所有用戶,用戶組前面需加上@符號,r表示可讀,w表示可寫,等號右邊爲空則表示沒有權限。注意對於目錄結構,當用戶訪問某個資源時,SVN會先看有沒有直接針對該資源的訪問控制,如果沒有找到,則會繼承上一級目錄的訪問權限,如此遞推。

再提一點,當我們有多個倉庫時,我們會發現這些倉庫的用戶帳號在大多數情況下都是相同的,因此,我們可以將passwd文件放到公共的地方,然後將所有倉庫的password-db配置都指向該文件。相應的,authz-db也可以共用一個文件,不過需要在配置具體的訪問控制時指明所屬的倉庫,如下:

[/]

* = r

 

[repos1:/project1]

* = r

harry = rw

[repos2:/project1]

* = r

sally = rw

上述配置表明,所有人對所有倉庫的根目錄都有讀權限,但只有harry對倉庫repos1裏的project1有讀寫權限,只有sally對倉庫repos2裏的project1有讀寫權限。

3) 搭建HTTP訪問方式

SVN可以通過Apache實現Web訪問方式,但這不是必需的,除非你有此需求。

a) 下載

Apache的官方網站爲http://www.apache.org/,注意不要使用最新的2.2.x,而要選擇2.0.x,這一點在SVN官方網站上有特別說明,當初我就沒有注意到這一點,而導致Apache2.2啓動時無法加載SVN的模塊,出現“perhaps this is not an Apache module DSO”錯誤。

我下載的版本爲apache_2.0.59-win32-x86-no_ssl.msi

b) 安裝和註冊

執行Apache安裝程序。由於2.0的版本不會自動註冊爲服務,因此我們需要手工處理。運行cmd.exe,進入apache安裝目錄下的bin文件夾,執行如下命令即可:

apache -k install

更多的命令可以通過apache help查看。

註冊完後,就可以通過系統托盤裏的Apache Monitor來啓動服務。如果80端口未被佔用,那麼服務器應正常啓動,通過http://127.0.0.1就能看到Apache的測試頁面。

c) 配置

Apache是通過conf目錄中的httpd.conf文件進行配置的,比如,默認的監聽端口爲80,在文件中搜索Listen 80,將80改成你所需的其它端口即可。配置完後必須重起Apache才能生效。更多關於Apache的配置說明請參見其幫助手冊或google之。下面網站爲幫助手冊的中文版本。

爲了讓Apache支持SVN,比如增加一些配置項,一個典型的配置如下:

# 加載mod_dav模塊,它是對WebDAV(Web-based Distributed Authoring and Versioning)協議的支持,由Apache自帶

LoadModule dav_module modules/mod_dav.so

 

# 加載mod_dav_svn模塊,它與mod_dav通信,使Apache支持SVN,它位於SVN的bin目錄下。

LoadModule dav_svn_module "D:/Program Files/Subversion/bin/mod_dav_svn.so"

 

# 加載mod_authz_svn模塊,用於進行權限管理

LoadModule authz_svn_module "D:/Program Files/Subversion/bin/mod_authz_svn.so"

 

# 配置SVN的訪問路徑以及相關相關參數

<Location /svn/>                             # 通過http://HOST/svn/訪問SVN服務器

    DAV svn                                  # 必需

    SVNParentPath D:/SVN_REPOS               # 說明D:/SVN_REPOS下的所有目錄均爲倉庫

    SVNListParentPath on                     # 在網頁中列出D:/SVN_REPOS下的所有倉庫

   

    AuthType Basic                           # 基本的用戶名密碼驗證方式

    AuthName "SVN REPOS"                     # 認證名稱,作提示用

    AuthUserFile D:/SVN_REPOS/users          # 用戶名密碼文件

    AuthzSVNAccessFile D:/SVN_REPOS/authz    # 權限控制文件

    Require valid-user                       # 只有通過認證才能訪問網頁

</Location>

 

# 重定向處理,用於將http://HOST/svn地址重定向爲http://HOST/svn/

RedirectMatch ^(/svn)$ $1/

下面對幾個重要的地方作以說明:

i. 網上很多文章提到將mod_dav_svn.so和mod_authz_svn.so兩個文件直接拷貝到Apache的modules目錄下,當初我按照這種方法做時結果在一臺Windows 2000 Server上無法啓動Apache服務,爲此折騰了半天。後來才明白,這些模塊文件其實就是一些動態鏈接庫,它需要依賴SVN的bin目錄下的其它幾個dll文件(可以把後綴改爲dll,然後通過VC帶的depends查看其依賴關係),因此如果沒有設置環境變量,那麼Apache加載這些模塊時就會失敗,當然也可以把所有依賴文件(主要是libdb43.dll )拷貝過去。實際上,我們只需要通過絕對路徑來引用這些模塊即可,這樣SVN升級後也不用再次拷貝。

ii. URL的訪問路徑爲/svn/而不是/svn,因爲後者可能有問題,導致通過http://HOST/svn訪問出現如下錯誤信息

iii. SVNParentPath用於有多個倉庫的情況,如果只有單個倉庫,可以直接用SVNPath指明倉庫路徑。

iv. AuthUserFile指明用戶名密碼文件,但它與前面提到的SVN倉庫下的passwd文件不是同一個文件,AuthUserFile是Apache的認證文件格式,二者的區別主要是用戶名和密碼的分割符不同,passwd是等號,這裏的users是冒號,當初我就是把它們當成一個文件而造成客戶端無法訪問(爲什麼SVN不把passwd的格式定義成和AuthUserFile的一樣呢?這樣二者可以共用一個文件)。如果要對密碼加密,那麼users文件需通過Apache附帶的htpasswd工具生成,實際上我們也可直接採用明文方式。

v. 權限控制文件AuthzSVNAccessFile與前面SVN裏的authz一樣,因此可以共用。

4) 其它管理功能

a. 備份

b. 修復

 

3. SVN客戶端使用

本節針對客戶端用戶,主要介紹一些常用的操作方法。

1) 客戶端安裝

客戶端可以採用命令行方式,也可以採用TortoiseSVN圖形化方式,個人認爲還是後者方便些。

TortoiseSVN從http://tortoisesvn.tigris.org/上獲取,注意版本應與服務器保持一致。如果是命令行方式的話,那麼從http://subversion.tigris.org/下載一個SVN二進制包就行了,此處不多講。

TortoiseSVN屬於圖形化的客戶端軟件,其實前面的SVN安裝包裏已經含有客戶端程序,只不過是命令行方式的,你可以根據需要選擇是否安裝。TortoiseSVN的官方網站爲http://tortoisesvn.tigris.org/,同樣,注意選擇與SVN服務器配套的版本。

我這裏使用的版本爲TortoiseSVN-1.4.0.7501-win32-svn-1.4.0.msi

安裝完後,會提示重起機器,實際上不用重起就能直接使用,只不過重起後會更新SVN文件圖標的顯示。下圖是SVN工作區的右鍵菜單內容:

2) 主要操作

TortoiseSVN使用起來很簡單,所有操作都通過右鍵菜單來完成。命令內容也很直觀,而且有非常詳細的幫助手冊,這裏只簡單的介紹一下。

a) 導入項目(Import)

首先要把需要進行版本管理的工程(目錄)整理好,去掉不必要的文件,比如編譯器生成的臨時文件。然後在最上層文件夾上單擊右鍵,選擇“TortoiseSVN -> Import...”,輸入要存放的SVN服務器路徑,確認即可。這樣就將本地的項目導入到了服務器上。

命令行:svn import [PATH] URL

b) 檢出項目(Checkout)

項目初次導入成功後,剛纔本地的內容就沒有用了,我們需要建立一個新的工作區,重新從SVN服務器下載受控的項目文件,執行“TortoiseSVN -> Checkout...”,選擇或者輸入項目的URL,確認即可,以後的工作都應在這個工作區裏進行。

默認是獲取項目的最新版本(HEAD),如果要獲取歷史版本,指定相應的修訂號(Revision)即可。

命令行:svn checkout URL[@REV]... [PATH]

c) 更新與提交(Update and Commit)

他人修改了項目,我們需要從服務器下載最新版本,這通過“SVN Update”右鍵菜單實現。

命令行:svn update [PATH...]

如果是自己本地作了修改,則應及時將修改更新到服務器上去,這通過“SVN Commit...”實現。一個好的習慣是每次提交都應註明修改內容,以方便日後查證。

命令行:svn commit [PATH...]

d) 增加和刪除文件(Add and Delete)

如果我們要向一個受控項目中添加新文件或文件夾,只需在目標上執行“TortoiseSVN -> Add”操作。注意,這裏只是本地添加,要提交到服務器,還必須執行Commit纔行。

命令行:svn add PATH...

同樣,要刪除受控文件或文件夾只需執行“TortoiseSVN -> Delete”操作。

命令行:svn delete PATH/URL...

TortoiseSVN還提供了一個重命名操作“TortoiseSVN -> Rename”,這其實是添加和刪除的組合。

e) 撤銷操作(Revert)

有時候,我們可能進行了錯誤的修改或者增加和刪除,只要未進行提交,我們都可以通過“TortoiseSVN -> Revert”命令來撤銷本地的所有更改。

命令行:svn revert PATH...

f) 查看信息

SVN提供了幾種信息查看方式,其中Show log用於顯示每次版本變更的日誌信息,Repo-brower是倉庫瀏覽器,類似於資源管理器,Revision graph則以圖形化的方式讓我們很直觀的看到版本的變更情況,尤其是對於分支和標籤管理很有幫助。

3) 其它操作

a) 衝突解決(Resolved)

如果我們本地進行了修改,而別人又把他的修改提交到了服務器上,這時我們執行Update就可能出現衝突(Conflict)。Resolved的作用不是解決衝突,它不進行任何合併,而是忽略掉他人的修改,允許我們將自己的版本提交到服務器上。

簡單的說,Revent是撤銷本地修改,而Resolved是保留本地修改。

b) 清除異常狀態(Cleanup)

如果在執行某個命令的時候出現異常,比如服務器突然掛了,本地的工作區就會處於一種異常狀態,通過Cleanup能夠清除這種狀態,使工作區不受到影響。

c) 鎖定(Get lock)和解鎖(Release lock)

衝突都是由於不同的開發人員同時修改了同一份文件造成的,因此,爲了避免這種情況,我們可以強行鎖定自己要修改的內容,這樣其他人在我們解鎖前就無法提交其修改。

d) 分支和標籤(Branch/tag)

本文最開始就有說明,分支的目的是爲了創建並行的工作線,標籤的作用是爲了保存項目某個版本的快照。二者在實現上卻是一樣的,都是通過Branch/tag命令執行。

e) 導出(Export)

爲了實現版本管理,SVN會在工作區的每個目錄下都生成一個隱藏的.svn文件夾,而我們有時卻希望得到一個乾淨的沒有.svn文件夾的項目結構,比如發佈軟件時,這種情況下就可以使用Export功能。

f) 重定向(Relocate)

有時候,SVN服務器的IP地址可能會發生變動,如果遇到這種情況,我們每個人的本地工作區都要重新下載嗎?不用,只需通過Relocate重新配置一下本地工作區所對應的服務器地址就可以。

g) 補丁管理(patch)

不要被patch的名稱迷惑,實際上它不屬於SVN版本管理的範疇。這裏所謂的patch是指那些對項目沒有寫權限(Commit)的人所作的修改,通過“TortoiseSVN -> Create Patch”生成,然後他們採用電子郵件等方式將patch發給項目管理員,由管理員執行“TortoiseSVN -> Apply Patch”並確認修改內容後再進行提交。該功能主要用於開源項目的管理

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