Version Control with Subversion

Transcription

1 Version Control with Subversion 指導教授郭忠義 邱茂森

2 Outline What is Subversion? 案例 : 從無到有的基本流程案例 : 衝突操作說明 : 安裝 Subversion Server 操作說明 : 常用 SVN 管理指令介紹操作說明 : 常用 SVN 客戶端指令介紹操作說明 :Branch and tagging 案例 : WiMAX 計畫的檔案庫結構配置案例 : Branch Reference 2

3 What is Subversion? Subversion is a version control system. Subversion manages files and directories over time. allows you to recover older versions of your data, or examine the history of how your data changed. Allow people on different computers to modify and manage the same set of data. 3

4 Version Control System 圖 4-1 4

5 案例 : 從無到有的基本流程 5

6 腳色 SVN 管理者 計劃 PM 計畫成員 x3 6

7 一.SVN 管理者開設 Repository SVN 管理者 Svnadmin create Server Repository SVN 管理者在 server 端建立 Repository 設定帳號密碼, 權限 7

8 二. 計畫 PM 上傳 (import) 專案資料夾 計畫 PM 刪除 SVN import Repository 計畫資料夾裡面放著程式碼跟相關文件的子目錄, 目錄結構應該有條理的整理好避免日後管理上的混亂 可以 import 空目錄, 或是已經具備程式碼跟相關文件檔案的資料夾, 或者只有目錄結構 8

9 三. 成員 checkout 一份複本 Svn checkout Repository 計畫成員 各自在自己的電腦新增一個空目錄做為工作區 下載 (checkout) 第一份工作副本到自己的工作區 這個步驟 PM 自己也要作 9

10 四. 在工作區進行基本工作 (1). 更新工作複本 (2). 對自己的工作區進行更動 (3). 檢視更動 (4). 合併其它人的更動 (5). 送交更動 10

11 四.(1) 更新工作複本 計畫成員 Svn update Repository * 在開始一個工作前先 update, 如果 server 上的檔案庫有任何更新就會反映到自己電腦裡的工作區 11

12 四.(2) 對自己的工作區進行更動 在自己的工作區編輯檔案 或是新增, 刪除, 移動, 複製 計畫成員 svn add svn delete svn copy svn move 編輯檔案. 等 12

13 四.(3) 檢視更動 檢查確認自己所作的每一項變更 svn status svn diff svn revert 計畫成員 13

14 四.(5) 送交更動 計畫成員 # Svn commit Repository 假如沒有發生任何衝突的話 就使用 svn commit 指令將自己所做的更動送交到 server 上的檔案庫 14

15 案例 : 衝突 15

16 # 計畫成員 A Svn commit 計畫成員 B Svn commit 當成員 A 與成員 B 同時對同一個檔案作修改, 就有可能會發生衝突 ( 如果發生 SVN 會指出有衝突的檔案 ) 16

17 這時就需要互相溝通以解決問題 計畫成員 A 計劃 PM 計畫成員 B 17

18 當大家達成共識之後, 再由其中一人送交合併 (merge) 後的版本 計畫成員 Svn commit Repository 18

19 操作說明 : 安裝 Subversion Server 19

20 安裝 Apache 2.0 Server 先安裝 Apache 2.0 server 下載 Apache HTTP Server 2.0.x for Win32 Note that the Apache modules included in this package was compiled against Apache HTTP Server 2.0, and thus will not work with Apache HTTP Server

21 故障排除 開啟瀏覽器看是否能連結到 如果不行 (1) 檢查防火牆設定 (2) 檢查 80 port 是否被其他服務所占用, 例如 :World Wide Web Publishing 21

22 安裝 Subversion 下載 Subversion released setup.exe 點兩下安裝 之後安裝設定可以使用自動或是手動設定 Apache 2.0 server 22

23 使用簡易安裝設定 23

24 使用手動安裝設定複製 Subversion 安裝目錄 \bin 資料夾裏的 mod_authz_svn.so 和 mod_dav_svn.so 兩個檔案到 Apache2 安裝目錄 \Apache2\modules 修改 Apache2 安裝目錄 \Apache2\conf\ 下的 httpd.conf 檔案 : 找到下面兩行並刪除 # 標記, #LoadModule dav_module modules/mod_dav.so #LoadModule dav_fs_module modules/mod_dav_fs.so 並新增以下兩行 : LoadModule dav_svn_module modules/mod_dav_svn.so LoadModule authz_svn_module modules/mod_authz_svn.so Save httpd.conf file, and restard Apache server 24

25 設定 Apache 2.0 server 編輯 httpd.conf 檔加入以下敘述 : <Location /repos> DAV svn SVNPath /the local path of /repository </Location> SVNPath 指的是 repository 實際上的目錄, 例 : D:\svn\repos Save httpd.conf file, and restard Apache server 25

26 安裝 TortoiseSVN (optional) 圖形使用者介面環境 Download and double click to install 26

27 操作說明 : 常用 SVN 管理指令介紹 27

28 svnadmin Subcommands (Repository Administration) (1) Create a new, empty repository svnadmin create (2)Dump the contents of filesystem to stdout svnadmin dump (3)Read a dumpfile -formatted stream from stdin. svnadmin load 28

29 Create a new, empty repository 1. Create a directory for repository (ex. repos) 2. Run svnadmin create --fs-type fsfs /path/repos (ex.d:/svn/repos) 29

30 Create a repository (using GUI) 2. Or you can use TortoiseSVN to create a repository. 30

31 Create a new, empty repository(continued) 3. After finished creating, you can see something like this. 31

32 操作說明 : 常用 SVN 用戶端指令介紹 32

33 Import a new project Suppose you already have a project on your computer. And you want to upload to SVN server. 33

34 先整理好計畫的資料夾 假設計畫的目錄結構像這樣.. ( 應該要 有條理 的整理好 ) 子計劃 PEP PEP SRS SRS Dir1 Dir2 Dir3 34

35 應該把全部的檔案所放置的目錄取名為 trunk, 並增加兩個空目錄 branches tags 子計劃 trunk branches tags tags PEP PEP SRS SRS Dir1 Dir2 Dir3 35

36 然後由計畫 PM 一起 import 到自己所屬的 Repository 36

37 37

38 The address of repository : Your id : jykuo Your pw : ***** ( 前提 :Server 端已經建置完成, 並且管理員已經為你設定好帳號密碼 ) 38

39 39

40 40

41 41

42 checkout Most of the time, you will start using a Subversion repository by doing a checkout of your project. Checking out a repository creates a copy of it on your local machine. 42

43 43

44 44

45 The typical work cycle 1. Update your working copy 2. Make changes 3. Examine your changes 4. Merge others' changes into your working copy 5. Commit your changes 45

46 1.Update your working copy svn update (updates your working copy, and only prints information about files that it updates.) 46

47 2.Make changes svn add svn delete svn copy svn move 47

48 3.Examine your changes svn status svn diff svn revert 48

49 49

50 50

51 4.Merge others' changes into your working copy svn merge svn resolved 51

52 52

53 5.Commit your changes svn commit (Send changes from your working copy to the repository.) 53

54 操作說明 : Branch and tagging 54

55 Branching and tagging The tags directory contains snapshots of the trunk at particular milestones, usually major releases or perhaps prior to a major departure in development. The trunk directory holds the main copy of this project. The branches directory holds versions of the project that a developer or group of developers may be working on. 55

56 tagging 圖 4-1 改 56

57 Branching The branches directory holds versions of the project that a developer or group of developers may be working on. 57

58 兩種 branch 的建立方式 Basically stable 經過 QA 或是 unit test 的檔案才放在 trunk 所有開發 錯誤修正 QA(quality assurance) 都在 branch 上進行 Basically unstable 所有開發 錯誤修正 QA(quality assurance) 都在 trunk 上進行 準備釋出 (release) 時才建立 branch 來進行 QA 58

59 案例 : Branch 59

60 WiMAX 計畫的檔案庫結構配置 根目錄網址為 : / ( 總計劃根目錄 ) trunk sub01 ( 子計畫一根目錄 ) sub02 ( 子計畫二根目錄 ).. 以下類推 tags 60

61 檔案庫結構配置 ( 續 ) sub01 ( 子計畫一根目錄 ) trunk tags branches 61

62 檔案庫結構配置 ( 續 ) branches private ( 子計畫成員 ID) ( 子計畫成員 ID).. 以下類推 可以視需要新增其他 branch 62

63 anko01 假設 anko01 是一個計畫成員, 他負責撰寫一部分的 modulea 他正忙著 Debug, 所以不希望被其他人所作的更動所影響 sub01 trunk module A module B module C branches private 63

64 sub01 trunk module A module B 於是他在自己的 private 目錄下建立了一個 branch 取名為 bugfix-1-05 module C branches private anko01 Bugfix 其他 branch 其他成員 64

65 sub01 anko01 trunk Bugfix-1-05 module A module B branch module A module B module C module C Branch 其實是建立在檔案庫上的一份 trunk 的 Copy 65

66 sub01 anko01 trunk Bugfix-1-05 module A module B svn merge module A module B module C module C 等到工作完成再將 branch 合併到 trunk 66

67 Branching and tagging 67

68 68

69 Reference Subversion book Subversion for Windows with Apache server Subversion FAQ TortoiseSVN Documentation SVN vs CVS quick comparison Apache HTTP Server Version 2.0 Documentation 69