|
Subversion for Windows 安裝指南
|
|||||||||||||
作者:蔡煥麟
|
| 問題排除 如果 Apache HTTP Server 無法啟動，請依下列步驟檢查：
|
2.3 設定 Subversion 檔案庫的路徑
現在要設定 URL 路徑與檔案庫實體路徑的對應關係。對應的方式有兩種，分別是 SVNPath 與 SVNParentPath。
2.3.1 SVNPath
SVNPath 適合用來個別指定檔案庫的路徑，語法是：
<Location /svn/repos_name>
DAV svn
SVNPath /absolute/path/to/repository
</Location>
其中 "/svn/repos_name" 就是用戶端存取特定檔案庫的 URI（Uniform Resource Indentifier），SVNPath 後面指定的路徑則是檔案庫的絕對路徑，假設我們的檔案庫實際存放的路徑是 d:/svn/MyProject，並且希望用戶端使用 "http://myserver/svn/myprj" 的 URL 來存取檔案庫，那麼要加入 httpd.conf 的內容就是：
<Location /svn/myprj>
DAV svn
SVNPath d:/svn/MyProject
</Location>
注意 Location 標籤後面的 /svn/myprj 的第一個斜線不可少！
2.3.2 SVNParentPath
如果你的檔案庫都集中放在某個目錄之下，例如：d:/svn，那你就可以使用 SVNParentPath 的方式指定檔案庫的根路徑，例如：
<Location /svn>
DAV svn
SVNParentPath d:/svn
</Location>
這表示可以讓任何人都可以透過 http://myserver/svn/<檔案庫名稱> 的方式，存取位於 d:/svn 這個目錄以下的所有檔案庫。也就是說，這個設定動作只需要一次，如果使用 SVNPath，你必須為各個檔案庫分別指定對應的路徑。
以上兩種設定方式都可以，方便起見，這裡我用 SVNParentPath 來統一指定所有檔案庫的父層 URL 路徑。
將 <Location> 的設定加到 Apache HTTP Server 的 httpd.conf 檔尾就行了。
接著便可以開始建立檔案庫。
2.4 建立檔案庫
假設我們要把所有的檔案庫都放在 d:/svn 目錄下，現在要建立一個測試用的檔案庫，名稱叫做 在 repository，指令為：
md d:/svn svnadmin create d:/svn/repository
命令執行完後，檢查看看 d:/svn/repository 目錄底下產生了哪些目錄和檔案。
| 警告 檔案庫絕對不可以在建立在任何遠端的儲存媒體上，例如：網路磁碟機。 |
這時候你已經建立了一個檔案庫，你可以先在本機用瀏覽器測試一下，網址輸入 http://svn/repository，看看能不能看到檔案庫的內容，正常的話應該像下圖一樣。
如果以上的測試可以通過，應該就行了。如果你還想要測試一下能不能從檔案庫取出整個工作複本，可以執行下列指令（非必要）：
c:
cd\temp
svn co http://localhost/svn/repository WholeRepos
上述指令會切換到一個暫時的目錄 c:\temp，然後從檔案庫取出整個工作複本。最後一行指令是要 svn.exe 執行 check out 動作（縮寫 co），如果正確的話，應該會顯示 "Checked out revision 0." 的訊息，此時 /svn/repository 這個檔案庫底下的所有檔案目錄都已經取出，並且複製一份到 c:/temp/WholeRepos 目錄下了。
| 問題排除 如果顯示的錯誤訊息是： svn: PROPFIND request failed on '/svn/repository' svn: PROPFIND of '/svn/repository': 405 Method Not Allowed (http://localhost) 請檢查 Apache HTTP Server 的 httpd.conf 檔案裡面的 <Location> 標籤x的位置是否跟你指定的 URL 樣式相同，注意一定要完全相同，以上面的例子而言，你的 httpd.conf 的最後面應該會有以下文字： <Location /svn>
DAV svn
SVNPath 指向檔案庫的絕對路徑
</Location> 如果顯示的錯誤訊息是： svn: PROPFIND request failed on '/svn/repository' svn: Could not open the requested SVN filesystem 那表示在 /svn 對應的實體目錄（即 d:/svn）下找不到 reposiroty 這個目錄。 註：PROPFIND 是給 WebDAV 用的 HTTP method，用來從資源中取得屬性。 |
測試完畢就可以把 WholeRepos 這個目錄整個刪掉了。
到目前為止，可以確定檔案庫已經建立完成，接下來就可以匯入專案了。
2.5 匯入專案
不用急著把你現有的正式專案匯入檔案庫，先建立一個用來測試的專案目錄就好了。我們先在 c:/temp 底下建一個 ProjectA 的專案目錄結構，參考下面的指令：
c: cd temp md ProjectA md ProjectA/trunk md ProjectA/branches md ProjectA/tags svn import . http://localhost/svn/repository -m "Initial repository layout"
| 提示 本文在執行 svn 命令時，都是使用 http 協定的方式，這樣我們可以確知 Subversion 與 Apache HTTP Server 的設定無誤，其他人就可以透過 Internet 存取檔案庫。當然你也可以用其他的協定，例如：file:///，如果使用 file 協定，最後一行指令就變成： svn import . file:///d:/svn/repository -m "Initial repository layout" |
命令執行無誤的話，應會看到如下的畫面：
這時候 ProjectA 這個專案已經匯入檔案庫了，也就是說，其他使用者可以開始存取這個檔案庫的專案取出文件和程式碼了。你可以參考 Subversion 的官方手冊中關於 svn.exe 這個用戶端命令列工具的使用方法，多練習一下取出檔案、加入檔案、以及存入檔案等指令。萬一練習的過程中發生錯誤，或者檔案庫弄亂了，你可以把整個檔案庫的目錄砍掉，回到 2.4 節重新做一遍。
以下會進一步討論檔案庫和專案目錄結構的安排方式，如果你急著想試試看用戶端如何存取 Subversion 檔案庫，可以先跳到2.6 節或第 3 節。
2.5.1 檔案庫與專案的配置方式
延續前面的範例，如果你再匯入其他專案，例如 ProjectB，那麼整個檔案庫的結構會變成這樣：
/svn/repository/ +-- ProjectA/ +-- ProjectB/
也就是說 repository 這個檔案庫裡面包含了兩個專案。
如果你希望為每個專案建立一個檔案庫，那麼在 2.4 節中建立檔案庫的指令就變成：
md d:/svn svnadmin create d:/svn/ProjectA svnadmin create d:/svn/ProjectB
這樣就變成有兩個檔案庫了，檔案庫名稱分別是 ProjectA 與 ProjectB。
| 提示 如果專案之間有共享的檔案，建議把這些相關的專案放進同一個檔案庫；如果專案之間彼此毫無關係，那就採用一個檔案庫放一個專案的方式，這種方式等於專案就是檔案庫。 第一種方式有個比較奇怪的「功能」你應該要知道，就是一個專案的 check in 動作，也會令其他專案的檔案的修訂版次遞增 ，如果這不是你想要的，請選擇第二種方式，即一個檔案庫只存放一個專案。 |
2.5.2 專案的目錄結構
這裡補充說明一下 ProjectA 的目錄結構。在 ProjectA 專案的根目錄下建立的 trunk、branches、和 tags 這三個目錄是有特別意義的，它們的作用分別是：
- trunk 目錄用來存份目前專案正在進行開發的程式檔案和文件（又稱為主線，即 mainline）；
- branches 用來存放主線的各個仍在發展中的分支；
- tags 則用來存放已經不再變動的分支，也就是其中的檔案不會再修改了。
這是 Subverion 官方手冊建議的目錄結構安排方式，你可以自己決定要不要用這種配置方式，詳細說明請參考官方手冊的第五章，子標題為 "Choosing a Repository Layout"。
| 提示 目錄名稱建議盡量不要用中文名稱，這樣在使用命令列時比較方便，也比較不會有問題。 |
2.6 使用 Windows 網域帳戶驗證
照著前面的步驟做，你會發現存取檔案庫時都不用輸入帳號密碼，這是因為我們之前的設定沒有啟用身分驗證的功能。但是我們通常不希望所有人都能任意存取你的檔案庫，免得重要資產外洩，或者資料被破壞，因此了解如何加入身分驗證也是必要的。
Serversion 提供了多種驗證使用者身份的方式，這裡只介紹 Windows 身分驗證的方式，這種方式很適合用在開發團隊成員都在區域網路內的情況。請依下列步驟進行：
- 取得 SSPI 模組，下載網址為 http://tortoisesvn.tigris.org/mod_auth_sspi.zip。
- 把 zip 裡面的 mod_auth_sspi.so 解壓縮到 <Apache_root>\modules 目錄下。
- 把下面這行加入到 Apache 的 httpd.conf 裡面：
LoadModule sspi_auth_module modules/mod_auth_sspi.so
注意上面加入的這行一定要放在下面這行的前面：LoadModule auth_module modules/mod_auth.so
- 修改 httpd.conf 的 <Location> 設定如下：
<Location /svn> DAV svn SVNParentPath d:/svn AuthType SSPI AuthName "Subversion 檔案庫" Require valid-user SSPIAuth On SSPIAuthoritative On SSPIDomain <domaincontroller> SSPIOfferBasic On </Location>其中 <domaincontroller> 就是你的 Windows 網域控制器的電腦名稱（例如：WIN2KDC），注意兩邊的括號 <> 不用保留。如果你的環境沒有網域控制器，就維持原來的 <domaincontroller> 就行了。在我的環境下，我發現即使有網域控制器，但是這裡不去設定它，還是能夠正常的驗證使用者身分。
- 重新啟動 Apache。
好了，現在開啟瀏覽器，輸入網址 http://127.0.0.1/svn/repository 看看，你預期應該會看到如下的驗證畫面：
但是卻沒有出現這個畫面，而是直接顯示檔案庫內容，怎麼回事？
因為我們現在是使用 Windows 帳戶驗證，你目前已經登入這台機器了，而你要存取的也是本機的資源，換句話說，你的身分已經被驗證過了，所以就不會再要求你輸入帳號跟密碼，這是採用 SSPI 網域驗證的好處。
那麼，如果你的同事 John 的電腦有加入網域，但是他平時都是登入本機，而非登入網域，在存取檔案庫時會不會要求輸入帳號密碼？答案是如果 John 登入他本機的帳號和密碼跟他在網域使用者的帳號密碼完全一樣的話，就無需再輸入密碼；相反的，如果登入本機的使用者帳號和密碼與網域使用者帳號密碼不同，第一次存取時就必須輸入密碼。
你可以在別台機器上，用一個網域裡沒有的使用者帳號去存取 Subverion 檔案庫，如果正確的話，應該就會出現要求輸入帳號密碼的視窗。
以上還只是最基本的設定，如果你希望做些進階的設定，例如允許所有人都可以檢視檔案庫的內容，但是不能修改；或者要加入 SSL 加密機制，建議您參考 [2] 的第三章。
| 提示 啟用身分驗證之後，你會發現用命令列工具 svn.exe 存取檔案庫時，如果是用 http:// 協定，有些子命令（subcommand）執行時會出現 "authorization failed" 的錯誤，這時候你可以在 svn 命令中加入 --username 和 --password 來提供使用者名稱和密碼，例如： svn co http://myserver/svn/ --username michael --password guesswhat 或者你也可以改用 file:/// 協定。 |
3 安裝用戶端：TortoiseSVN
現在你已經有一個可以運作的 Subversion 伺服器，可以試著在其他電腦上存取檔案庫了。如果你習慣使用命令列工具，那就只要在用戶端電腦上安裝 Subversion 就行了，存取檔案庫都是透過命令列工具（主要是 svn.exe）。這裡要介紹的是一個專門為 Windows 作業系統設計的 Subversion 用戶端：TortoiseSVN（以下簡稱 TSVN）。
3.1 安裝 TortoiseSVN
- 到 http://tortoisesvn.tigris.org 下載最新的安裝程式，下載後直接安裝。安裝過程大都是按下一步，只有在問你
安裝完成後會要求你重新開機。 - 到 http://tortoisesvn.tigris.org 下載繁體中文的語言包（language pack），請注意語言包的版本應該要跟你安裝的 TSVN 版本相同，否則最好不要安裝。語言包裝完之後，用檔案總管在 Windows 桌面上或任何一個資料夾上點一下滑鼠右鍵，選擇 TortoiseSVN -> Settings 以開啟設定視窗，在 "Main" 頁夾中更改 Language 設定為「中文(繁體)」，再按「確定」鈕即可。
- 如果你是透過 proxy server 存取 Internet，請在 TSVN 的設定視窗中，切到「網路」頁夾，然後輸入你的 proxy server 相關資訊，否則你將無法存取位於 Internet 上的檔案庫。
安裝完成之後，在任何目錄名稱上點一下滑鼠右鍵都可以看到 TSVN 的功能選項，這也是 TSVN 方便的地方，它不用跟開發工具整合，而是跟作業系統整合在一起，這樣不管你用什麼開發工具，都可以輕鬆的使用 TSVN 來存取檔案庫。
接下來你可以用 TSVN 練習一下存取之前建立好的檔案庫，試著把你現有的專案匯入檔案庫中，並且在用戶端使用 TSVN 執行取出、存入、更新等動作。
TSVN 雖然是用戶端工具，不過它也提供了建立檔案庫、以及匯入、匯出等功能，因此安裝在伺服器端也挺方便的。
4 結語
按照本文說明的安裝步驟，希望能讓你順利在 Windows 環境下把 Subversion 安裝起來。但是安裝成功以後，真正的工作要才開始，如果你沒有花點時間閱讀 Subversion 的相關文件，在使用版本控制系統的過程中，一定會碰到許多問題。
在正式將你的專案加入 Subversion 檔案庫之前，建議您多考慮一下：
- 檔案庫的配置方式。究竟要為每一個專案建立一個檔案庫，還是把多個專案放進同一個檔案庫裡？
- 專案目錄的結構。你要依照官方手冊的方式，在專案的根目錄下建立 trunk、branches、和 tags 嗎？
- 哪些東西要放進檔案庫裡？
前兩個問題你可以參考 [1] 的建議（第五章），再衡量自己的需求來決定。你不見得要依照官方的建議，第一次也許採用最單純的配置方式會比較好，例如：一個檔案庫就只放一個專案，而且只把程式的原始碼 放進檔案庫，也不去分主線支線了，因此專案的目錄結構可以很單純，程式原始碼的根目錄就是專案的根目錄。自己動手做過幾次以後， 再去觀察檔案庫的內容，就會比較有感覺了，然後再來考慮自己團隊的需求，自然就能找到最適合自己團隊的配置方式了。
後記
這份文件快要寫完時，才發現 [2] 已經提供一份類似的文件了，不過既然寫了，還是公佈出來吧，中文資源多一些總是好的。
網路資源
| [1] | Subversion 電子書。http://svnbook.red-bean.com/ 繁體中文版：http://svn.ntcu.net/svnbook/ |
| [2] | TortoiseSVN 官方文件。http://tortoisesvn.tigris.org/docs.html#DocDir |
| [3] | http://svn.ntcu.net/kwiki/ |
原文请参考：http://sun.cis.scu.edu.tw/~nms9115/articles/softeng/scm/svn/2-install/svn_install.htm