1.環境和軟體準備 作業系統: windowsXP sp2 Window-Subvsersion : http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 Windows 常用用戶端 TortoiseSVN : http://tortoisesvn.net/downloads 請下載下傳 subversion 伺服器軟體和用戶端,并預設安裝(可以重新啟動作業系統,以更新圖示顯示)。 2.配置管理 2.1. 建立倉庫 (svnadmin) 在硬碟上建立個空目錄,作為 SVN 的倉庫目錄。如: E:\subversion\repository 。下面使用兩種方式建立倉庫的初時檔案結構和存儲方式。指令方式和 TortoiseSVN 用戶端方式,後面所有文檔都采用兩種方式說明,其功能完全相同。請根據實際情況選擇使用。 指令方式( DOS 下): # 預設方式,采用 FSFS 方式存儲資料,這是推薦方式,管理和遷移相對 bdb 方式簡單 svnadmin create E:\subversion\repository 或 svnadmin create –fs-type bdb E:\subversion\repository TortoiseSVN 用戶端 注意在最新版本的 SVN1.4 ,采用本方式有相容性問題,該用戶端現在好想隻支援 1.3 版本的 SVN 建立倉庫 1.使用 window exporer 或我的電腦,定位到 E:\subversion\repository ,并確定本目錄為空。 2.在本目錄下,右鍵菜單中選擇“ TortoiseSVN ”- > “ Create repository here… ” 3.在彈出的視窗中選擇資料存在檔案系統方式,使用預設選取 (FSFS) ,點選确定。 4.檢查本目錄下是否有生産的系統檔案和檔案夾,如果有,成功! 2.2. 配置服務 進入倉庫目錄下的 conf 檔案夾。也就是 E:\subversion\repository\conf 裡面有 3 個預設的配置檔案: authz , passwd , svnserve.conf svnserve.conf 控制 svnserve 的啟動配置選項,可以配置認證和授權方式,典型的配置是設定由 authz 控制授權, passwd 控制認證的方式來控制通路權限。也可以使用匿名方式,但不推薦。 使用 authz 和 passwd 的典型配置: 請特别注意:以下三個配置檔案的配置,每行有效配置前不能有空格,不然配置會失敗。 服務配置檔案 svnserve.conf …… ### 匿名方式不允許通路 anon-access = none …… ### Uncomment the line below to use the default password file. ### 表示通路倉庫的認證有檔案 passwd 提供的賬戶确定 password-db = passwd …… ### Uncomment the line below to use the default authorization file. ### 表示認證後的賬戶通路權限由檔案 authz 定義 authz-db = authz ### This option specifies the authentication realm of the repository. …… 認證配置檔案 passwd passwd 檔案實際提供通路本倉庫的賬戶管理,檔案格式就是 ini 方式的格式 [users] harry = harryssecret sally = sallyssecret user=usersecret 這表示本倉庫配置了二個使用者及:其中一個使用者 harry, 他的通路密碼是 harryssecret 。通路密碼可以使用明文,也可以使用 htpasswd.exe ( apache 伺服器提供的工具方法,安裝 apache 伺服器後,在其 bin 目錄中有該程式檔案)進行加密處理。 授權配置檔案 authz 該檔案負責認證後的使用者的權限控制,配置稍微複雜,但其實也就是個 ini 配置檔案而已。 典型配置: # groups 段提供配置組的功能 , 但組成員必須是 passwd 檔案中定義的使用者才有效。可以對組 # 進行權限控制,所有組成員具有組對應的通路權限。 [groups] # 表示定義了一個管理組叫 admin_group, 包括 harry 和 sally , admin_group 前千萬不能有空格 admin_group= harry, sally # 下面就是定義具體倉庫下目錄的通路權限 # 一般對管理者來說都具有整個倉庫的讀寫權限,一般人員對整個敞開具有讀取權限,下面 # 就是這樣的配置 ,[/] 表示整個倉庫的根,組的引用使用 @ ,對應的權限可以是 r,w,rw 或空 [/] @admin_group = rw * = r 以上的配置完成後,我嗎就可以啟動伺服器了,下面說明伺服器的啟動。 注意,以上 authz 和 passwd 檔案在管理中因為具體項目的加入和人員的變動會經常的修改,這也是 SVN 管理主要的工作 2.3. 啟動服務 (svnserve) Svn 伺服器一般有三種方式, svnserve , apache 和 SSH 。其中常用的有 svnserve 和 apache 方式。本文隻以 svnserve 方式講解。總的來說 svnserve 是最高效的方式,一般應用于内部開發網中使用。 Apache 方式因為可以很好的部署在 internet 上,是以公網使用最友善,但配置稍微相對複雜點點,呵呵~~。三種方式具體的優缺點,請參考本文後面的參考文檔。 指令方式( DOS 下): svnserve –d –r E:\subversion\repository -d 參數是以獨立服務的方式啟動 -r 是制訂要加載的倉庫的實體路徑 Windows 系統服務 在 subversion1.4 後的版本,提供了安裝為服務的支援 可以參考本文安裝: . SC create svn1.4 binPath= "\"C:\Program Files\Subversion\bin\svnserve.exe\" --service --root \"E:\subversion\repository\"" depend= Tcpip start= auto 1. 紅色部分: SVN 的安裝目錄 2. 藍色部分:倉庫根目錄 3. 每個參數的格式是:參數名稱 = 值。參數名稱和 = 間沒有空格, = 後必須有空格, SC 的變态特性,完全的 BUG.. 注意就可以了 4. 本指令方式隻能用于 svn1.4 以上版本 5. 删除服務: sc delete svn1.4 2.4. 添加項目 (import) 上面的安裝配置工作完成後,啟動服務,現在進入使用的主題,首先一步是把需要進行版本管控的項目加入到倉庫中。在作這個工作前,需要先接受下, SVN 推薦的項目路徑結構。一般推薦是使用一個 trunk 儲存項目主幹最新版本, breaches 儲存以後的多個分支, tags 一般儲存釋出或階段性釋出的标簽版本。如下 Project1/trunk Project1/breaches Project1/tags 下面我嗎使用該目錄結構,加入一個測試的項目 project1 來示範添加項目的過程。 在任意目錄建立檔案夾 test ,然後在 test 下建立上面推薦的項目目錄結構。如下 test/project1/trunk test/project1/breaches test/project1/tags 指令方式: DOS 下定位到 test 的上級目錄 svn import test svn://localhost -m "init project1" --username harr y --password=harryssecret 新增 test\project1 新增 test\project1\trunk 新增 test\project1\readme.txt 新增 test\project1\breaches 新增 test\project1\tags 送出後的修訂版為 1 。 TortoiseSVN 用戶端 1.右鍵點選 test 目錄,選擇“ TortoiseSVN ”- > “ Import ” 2.在彈出的操作界面中 URL repository 中輸入伺服器位址 svn://localhost 3. 在彈出的操作界面中 Import message 下面的文本域輸入 init project1 4.點選 OK 5.如果第一次使用,會彈出輸入賬戶的界面,輸入對應的使用者賬戶,選擇儲存,下次使用就不用在輸入賬戶認證資訊了。 檢視是否添加成功: 1. 使用 window exporer 或我的電腦,定位到 E:\subversion\repository ,并確定本目錄為空。 2. 在本目錄下,右鍵菜單中選擇“ TortoiseSVN ”- > “ Repo-browser ” 3. 在彈出的輸入框中輸入 SVN 伺服器位址 svn://localhost 4. 在 Repository Browser 視窗中,你可以點選樹形結構的倉庫目錄,檢視是否存在你剛才添加的 project1 5. 如果你的使用者有足夠的權限,你可以在本界面的樹目錄上使用右鍵管理你的倉庫和項目。 2.5. 工作副本 (checkout) 工程加入到倉庫後,下面就可以進入實際的研發使用了,首先是要建立個本地的工作副本,使用 checkout 。 1.在任意開發機上建立工作目錄。如: D:\workspace\project1 2.進入具體項目的工作目錄,右鍵菜單中選擇“ SVN Checkout ” 3.在 checkout 視窗中: URL of Repository 是你具體的項目的主幹倉庫通路位址 如: svn://localhost/project1/trunk Checkout directory 是你本地副本的位址 如: D:\workspace\project1 其它的使用預設選項,如需要了解具體含義,請檢視參考文檔 4.點選 OK 2.6. 常用開發操作 以下主要都是在工作副本的開發中的常用操作。 2.6.1. 更新和同步 其它開發人員或在其它工作副本上送出到倉庫的最新版本檔案,需要更新到你自己的工作副本的操作。使用更新使你的工作副本于伺服器倉庫代碼同步。如果你更新的檔案中本地副本和伺服器倉庫中的檔案都是在同一版本上,本地副本作了修改檔案操作後, SVN 沒有辦法更新,因為它不知道是否該放棄本地的修改,它預設會操作合并的方式,但往往很多時候有些檔案是不能簡單的自動合并的,所有最好的辦法是以倉庫的版本為準進行更新,這就是同步操作。 下面主要說明使用用戶端工具 TortoiseSVN 的操作方式,其它用戶端工具和指令方式類似。 1. 在需要更新或同步檔案上或檔案夾内右鍵點選,選擇 SVN update 指令 2. 如果需要同步某個檔案或檔案夾,需要先删除本地版本,然後在使用 SVN update 2.6.2. 添加和送出 。。。 3.參考文檔 1. Svn 安裝後的官方文檔 2. SVN 中文官方網站: http://www.subversion.org.cn 3. 中文文檔: http://www.subversion.org.cn/svnbook/ |