作者:龔天乙 CVS 是 Concurrent Version System(並行版本系統)的縮寫,用於版本管理。在多人團隊開發中的作用更加明顯。CVS 的基本工作思路是這樣的:在一台服務器上建立一個倉庫,倉庫裡可以存放許多不同項目的源程序。由倉庫管理員統一管理這些源程序。這樣,就好象只有一個人在修改文件一樣。避免了沖突。每個用戶在使用倉庫之前,首先要把倉庫裡的項目文件下載到本地。用戶做的任何修改首先都是在本地進行,然後用 cvs 命令進行提交,由 cvs 倉庫管理員統一 修改。這樣就可以做到跟蹤文件變化,沖突控制等等。 由於CVS是建立在在原先 Unix 體系裡很成熟的 SCCS 和 RCS 的基礎上,所以CVS多是Linux(UNIX)系統中所使用,本文中服務器端設置也是以Linux為例。 一、CVS服務器的安裝 首先確認系統中是否安裝CVS服務: [root@localhost /]# rpm -qagrep cvs cvs-1.11.2-cvshome.7x.1 如果命令輸出類似於上面的輸出則說明系統已經安裝有cvs,否則就需要從安裝光盤中安裝cvs的rpm包,或者到http://www.cvshome.org下載。 1、建立 CVSROOT 目錄,因為這裡涉及到用戶對CVSROOT裡的文件讀寫的權限問題,所以比較簡單的方法是建立一個組,然後再建立一個屬於該組的帳戶,而且以後有讀寫權限的用戶都要屬於該組。假設我們建一個組叫cvs,用戶名是cvsroot。建組和用戶的命令如下 #groupadd cvs #adduser cvsroot 生成的用戶宿主目錄在/home/cvsroot(根據自己的系統調整) 2、用cvsroot 用戶登陸,修改 /home/cvsroot (CVSROOT)的權限,賦與同組人有讀寫的權限: $chmod 771 . (或者770應該也可以) 注意:這一部分工作是按照文檔說明做的,是否一定需要這樣沒有試驗,我會在做試驗後在以後版本的教程說得仔細一點。如果您有這方面的經驗請提供給我,謝謝。 3、建立CVS倉庫,(仍然是 cvsroot 用戶),用下面命令: $cvs -d /home/cvsroot init 4、以root身份登陸,修改 /etc/inetd.conf(使用 xinetd 的系統沒有此文件)和 /etc/services 如果用的是 inetd 的系統,在 /etc/inetd.conf 裡加入: cvsserver stream tcp nowait root /usr/bin/cvs cvs -f --allow-root=/home/cvsroot pserver 說明:上面的行是單獨一整行,/usr/bin/cvs 應該是你的cvs版本的命令路徑,請根據自己的系統調整./home/cvsroot是你建立的CVSROOT的路徑,也請根據上面建立目錄的部分的內容做調整。 如果是使用 xinetd 的系統,需要在 /etc/xinetd.d/ 目錄下創建文件 cvspserver(此名字可以自己定義),內容如下: # default: on # description: The cvs server sessions; service cvsserver { socket_type = stream wait = no user = root server = /usr/bin/cvs server_args = -f --allow-root=/cvsroot pserver log_on_failure += USERID only_from = 192.168.0.0/24 } 其中only_from是用來限制訪問的,可以根據實際情況不要或者修改。修改該文件權限: # chmod 644 cvspserver 在/etc/services裡加入: cvsserver 2401/tcp 說明:cvsserver 是任意的名稱,但是不能和已有的服務重名,也要和上面修改 /etc/inetd.conf 那行的第一項一致。 5、添加可以使用 CVS 服務的用戶到 cvs 組: 以 root 身份修改 /etc/group,把需要使用 CVS 的用戶名加到 cvs 組裡,比如我想讓用戶 laser 和gumpwu 能夠使用 CVS 服務,那麼修改以後的 /etc/group 應該有下面這樣一行: cvs:x:105:laser,gumpwu 在你的系統上GID可能不是105,沒有關系。主要是要把laser和gumpwu用逗號分隔開寫在最後一個冒號後面。當然,象RedHat等分發版有類似linuxconf這樣的工具的話,用工具做這件事會更簡單些。 6、重起inetd使修改生效: #killall -HUP inetd 如果使用的是 xinetd 的系統: # /etc/rc.d/init.d/xined restart 然後察看cvs服務器是否已經運行: [root@localhost /]# netstat -lnpgrep 2401 tcp 0 0 0.0.0.0:2401 0.0.0.0:* LISTEN 1041/xinetd 則說明cvs服務器已經運行。 二、管理CVS服務器 服務器可以用了,現在大家最關心的就是如何管理服務器,比如,我想讓一些人有讀和/或寫 CVS 倉庫的權限,但是不想給它系統權限怎麼辦呢? 不難,在 cvs 管理員用戶(在我這裡是 cvsroot 用戶)的家目錄裡有一個 CVSROOT 目錄,這個目錄裡有三個配置文件,passwd, readers, writers,我們可以通過設置這三個文件來配置 CVS 服務器,下面分別介紹這幾個文件的作用: passwd:cvs 用戶的用戶列表文件,它的格式很象 shadow 文件: {cvs 用戶名}:[加密的口令]:[等效系統用戶名] 如果你希望一個用戶只是 cvs 用戶,而不是系統用戶,那麼你就要設置這個文件,剛剛安裝完之後這個文件可能不存在,你需要以 cvs 管理員用戶手工創建,當然要按照上面格式,第二個字段是該用戶的加密口令,就是用 crypt (3)加密的,你可以自己寫一個程序來做加密,也可以用我介紹的偷懶的方法:先創建一個系統用戶,名字和 cvs 用戶一樣,口令就是准備給它的 cvs 用戶口令,創建完之後從 /etc/shadow 把該用戶第二個字段拷貝過來,然後再把這個用戶刪除。這個方法對付數量少的用戶比較方便,人一多就不合適了,而且還有沖突條件(race condition)的安全隱患,還要 root 權限,實在不怎麼樣。不過權益之計而已。寫一個小程序並不難,可以到 linuxforum 的編程版搜索一下,有個朋友已經寫了一個貼在上面了。 第三個字段就是等效系統用戶名,實際上就是賦與一個 cvs 用戶一個等效的系統用戶的權限,看下面的例子你就明白它的功能了。 readers:有 cvs 讀權限的用戶列表文件。就是一個一維列表。在這個文件中的用戶對 cvs只有讀權限。 writers:有 cvs 寫權限的用戶的列表文件。和 readers 一樣,是一個一維列表。在這個文件中的用戶對 cvs 有寫權限。 上面三個文件在缺省安裝的時候可能都不存在,需要我們自己創建,好吧,現在還是讓我們用一個例子來教學吧。假設我們有下面幾個用戶需要使用 cvs: laser, gumpwu, henry, betty, anonymous。 其中 laser 和 gumpwu 是系統用戶,而 henry, betty, anonymous 我們都不想給系統用戶權限,並且 betty 和 anonymous 都是只讀用戶,而且 anonymous 更是連口令都沒有。那麼好,我們先做一些准備工作,先創建一個 cvspub 用戶,這個用戶的責任是代表所有非系統用戶的 cvs 用戶讀寫 cvs 倉庫。 #adduser ... 然後編輯 /etc/group,令 cvspub 用戶在 cvs 組裡,同時把其它有系統用戶權限的用戶加到 cvs 組裡。(見上文) 然後編輯 cvs 管理員家目錄裡 CVSROOT/passwd 文件,加入下面幾行: laser:$xxefajfka;faffa33:cvspub gumpwu:$ajfaal;323r0ofeeanv:cvspub henry:$fajkdpaieje:cvspub betty:fjkal;ffjieinfn/:cvspub anonymous::cvspub 注意:上面的第二個字段(分隔符為 :)是密文口令,你要用程序或者用我的土辦法生成。 編輯 readers 文件,加入下面幾行: anonymous betty 編輯 writers 文件,加入下面幾行: laser gumpwu henry 注意:writers中的用戶不能在readers中,要不然不能上傳更新文件。 對於使用CVS的用戶要修改它的環境變量,例如laser用戶的環境變量,打開/home/laser(laser的宿主目錄)下的.bash_profile文件,加入 CVSROOT=/home/cvsroot eXPort CVSROOT 用laser登陸就可以建立CVS項目,如果要root使用,可以修改/etc/profile文件。 現在我們各項都設置好了,那麼怎麼用呢,我在這裡寫一個最簡單的(估計也是最常用的)命令介紹: 首先,建立一個新的CVS項目,一般我們都已經有一些項目文件了,這樣我們可以用下面步驟生成一個新的CVS項目: 進入到你的已有項目的目錄,比如叫 cvstest: $cd cvstest 運行命令: $cvs import -m "this is a cvstest project" cvstest v_0_0_1 start 說明:import 是cvs的命令之一,表示向cvs倉庫輸入項目文件。 -m參數後面的字串是描述文本,隨便寫些有意義的東西,如果不加 -m 參數,那麼cvs會自動運行一個編輯器(一般是vi,但是可以通過修改環境變量EDITOR來改成你喜歡用的編輯器。)讓你輸入信息,cvstest 是項目名稱(實際上是倉庫名,在CVS服務器上會存儲在以這個名字命名的倉庫裡。) v_0_0_1是這個分支的總標記。沒啥用(或曰不常用。) start 是每次 import 標識文件的輸入層次的標記,沒啥用。 這樣我們就建立了一個CVS倉庫了。 建立CVS倉庫的文件夾應該是“干淨”的文件夾,即只包括源碼文件和描述的文件加,而不應該包括編譯過的文件代碼等! 三、使用CVS winCVS是一個很好的CVS客戶端軟件,在http://cnpack.cosoft.org.cn/down/wincvsdailyguide.pdf可以下載到這個軟件的使用手冊。這裡不在贅述了。 四、用CVS管理項目 本人正在一加公司從事該公司ERP項目的開發,在沒有使用CVS的時候,多次出現了由於不同的開發人員修改同一程序,而導致程序錯誤,解決版本控制問題迫在眉睫。 由於這個項目采用Linux平台下Java開發,使用的開發工具Jbulider是支持CVS進行項目管理的,作為主程序員,我決定采用CVS進行版本控制,首先參照上文在Linux服務器上建立了CVS服務,然後我把我本地的工程文件傳至服務器。 例如:我的工程文件在F:\ERP下,我把ERP下的erp.jpx文件、defaultroot文件夾和src文件夾上傳至服務器/usr/local/erp下,然後登陸Linux服務器,登陸的用戶是CVS的用戶,其環境變量要正確(我的用戶名為admin) #cd /usr/local/erp #cvs import -m "this is a ERP project" erp v_0_0_1 start 這樣名為erp的CVS倉庫就建立了。 之後開發小組的成員可以用winCVS把該項目下載到本地: 打開winCVS 點擊工具欄Create -> Create a new repository... 彈出窗口 在Grenral中 Enter the CVSROOT填寫[email protected]:/home/cvsroot 其中admin是cvs的用戶,在本例中admin也是linux的系統用戶,192.168.1.9是服務器的地址,/home/cvsroot是CVS的主目錄,參考上文。 Authentication中選擇"passwd file on the cvs server" Use version中選擇cvs 1.10 (Standard) 其它項默認即可。 確認後,點工具欄Admin --> Login... 會提示輸入密碼,輸入密碼後,看看winCvs的狀態欄。如果提示 *****CVS exited normally with code 0***** 表示登錄正常。 點擊工具欄Create --> Checkout module...彈出對話框,其中的Checkout settings項中 Enter the module name and path on the server 填寫erp,即我們建立的名為erp的CVS倉庫 Local folder to checkout to 選擇要下載到本地的目錄,我選了F:\myerp 其它項目可以默認,確定後就可以下載到本地了,在F:\myerp\下會有一個erp文件夾,其文件結構和F:\erp下的文件結構是一樣的。 用Jbulider打開F:\myerp\erp\下的erp.jpx文件,這個工程文件就可以使用了。 在Jbuilder的工具欄Team --> Select Project VCS 彈出對話框,選擇CVS 對於你要進行修改的文件,在Project View中點中該文件,然後點右鍵,探出快捷菜單,選擇CVS --> CVS Edit "xxxx.java(文件名)" 第一次使用可能會提示CVS服務器的密碼。 在修改之前還要選擇CVS --> Update "xxxx.java(文件名)" 修改之後選擇CVS --> Commit "xxxx.java(文件名)" 這樣,修改的文件就保存到CVS服務器了,Update的目的是下載、比較文件。每次在修改之前都Update,保持最新版本。 CVS在項目管理使用中確實起到了良好的效果,仔細研究CVS的命令,可以更好的發揮CVS在版本控制上的能力。 參考資料:《CVS 簡單教程》 作者:何偉平 《CVS服務器快速指南》 作者:何偉平