Prayer

轉(zhuǎn)載說(shuō)明 此轉(zhuǎn)載基于原作者最后更新于2002-06-15 23:18:05的版本。原作可以在這里找到，本文的版權(quán)歸原作者所有。本文作者原為網(wǎng)易公司的資深開(kāi)發(fā)人員。

版權(quán)聲明 可以任意轉(zhuǎn)載，轉(zhuǎn)載時(shí)請(qǐng)務(wù)必標(biāo)明原始出處和作者信息

概述：CVS是一個(gè)C/S系統(tǒng)，多個(gè)開(kāi)發(fā)人員通過(guò)一個(gè)中心版本控制系統(tǒng)來(lái)記錄文件版本，從而達(dá)到保證文件同步的目的。

       CVS服務(wù)器（文件版本庫(kù)）
     /     |       \
（版本同步）
   /       |         \
開(kāi)發(fā)者1 開(kāi)發(fā)者2   開(kāi)發(fā)者3

以下是本文主要內(nèi)容：開(kāi)發(fā)人員可以主要挑選2, 6看就可以了，CVS的管理員則更需要懂的更多一些

標(biāo)題	內(nèi)容簡(jiǎn)介	讀者對(duì)象
CVS環(huán)境初始化	CVS環(huán)境的搭建	管理員
CVS的日常使用	日常開(kāi)發(fā)中最常用的CVS命令	開(kāi)發(fā)人員、管理員
CVS的分支開(kāi)發(fā)	項(xiàng)目按照不同進(jìn)度和目標(biāo)并發(fā)進(jìn)行	管理員
CVS的用戶(hù)認(rèn)證	通過(guò)SSH的遠(yuǎn)程用戶(hù)認(rèn)證，安全，簡(jiǎn)單	管理員
CVSWEB	CVS的WEB訪(fǎng)問(wèn)界面大大提高代碼版本比較的效率	管理員
CVS TAG	將$Id$加入代碼注釋中，方便開(kāi)發(fā)過(guò)程的跟蹤	開(kāi)發(fā)人員

一個(gè)系統(tǒng)20%的功能往往能夠滿(mǎn)足80%的需求，CVS也不例外，以下是CVS最常用的功能，可能用到的還不到它全部命令選項(xiàng)的10%，更多的功能請(qǐng)?jiān)趯?shí)際應(yīng)用過(guò)程中體會(huì)，學(xué)習(xí)過(guò)程中應(yīng)該是用多少，學(xué)多少，用到了再學(xué)也不遲。

CVS環(huán)境初始化
============

環(huán)境設(shè)置：指定CVS庫(kù)的路徑CVSROOT

tcsh
setenv CVSROOT /path/to/cvsroot
bash
CVSROOT=/path/to/cvsroot ; export CVSROOT

后面還提到遠(yuǎn)程CVS服務(wù)器的設(shè)置：

CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH

初始化：中心庫(kù)版本庫(kù)的初始化，其實(shí)就是一個(gè)目錄

cvs init

項(xiàng)目首次導(dǎo)入

cvs import -m "write some comments here" project_name vender_tag r_tag

項(xiàng)目導(dǎo)出：將代碼從CVS庫(kù)里導(dǎo)出

cvs checkout project_name

CVS的日常使用
=============

確認(rèn)修改：確認(rèn)自己的修改并寫(xiě)入到CVS庫(kù)里

cvs commit -m "write some comments here" file_name

注意：CVS的很多動(dòng)作都是通過(guò)cvs commit進(jìn)行最后確認(rèn)并修改的，在確認(rèn)的前，還需要用戶(hù)填寫(xiě)修改注釋?zhuān)詭椭渌_(kāi)發(fā)人員了解修改的原因。如果不用寫(xiě)-m "comments"而直接確認(rèn)`cvs commit file_name` 的話(huà)，cvs會(huì)自動(dòng)調(diào)用系統(tǒng)缺省的文字編輯器(一般是vi)要求你寫(xiě)入注釋。
注釋的質(zhì)量很重要：所以不僅必須要寫(xiě)，而且必須寫(xiě)一些比較有意義的內(nèi)容：以方便其他開(kāi)發(fā)人員能夠很好的理解。不好的注釋?zhuān)茈y讓其他的開(kāi)發(fā)人員快速的理解：比如： -m "bug fixed" 甚至 -m ""。好的注釋?zhuān)踔量梢杂弥形? -m "在用戶(hù)注冊(cè)過(guò)程中加入了Email地址校驗(yàn)"

同步最近修改：開(kāi)始工作前和將自己的工作導(dǎo)入到CVS庫(kù)里前都要做一次：先同步后修改

cvs update -m "write some comments here" file_name

注意：不要使用項(xiàng)目首次導(dǎo)出后，以后就要用cvs update在導(dǎo)出的項(xiàng)目目錄下進(jìn)行同步了，而不是每次重新cvs checkout來(lái)同步文件了。如果導(dǎo)出后修改了文件，然后再次從導(dǎo)出的項(xiàng)目目錄的上一級(jí)cvs checkout proj等于是刪除了proj目錄然后重新導(dǎo)出，上次導(dǎo)出后的修改就全丟了。

修改某個(gè)版本注釋?zhuān)好看沃淮_認(rèn)一個(gè)文件到CVS庫(kù)里是一個(gè)很好的習(xí)慣，但難免有時(shí)候忘了指定文件名，把多個(gè)文件以同樣注釋commit到CVS庫(kù)里了，以下命令可以允許你修改某個(gè)文件某個(gè)版本的注釋?zhuān)?/font>

cvs admin -m 1.3:"write some comments here" file_name

刪除文件：
文件刪除后，比如：

rm file_name
cvs rm file_name
cvs ci -m "write some comments here"

以上面前2步合并的方法為：

cvs rm -f file_name
cvs ci -m "why delete file"

注意：很多cvs命令都有縮寫(xiě)形式：commit=>ci; update=>up; checkout=>co; remove=>rm;

添加文件文件添加后，比如：

touch new_file
cvs add new_file
cvs ci -m "write some comments here"

添加目錄：

cvs add dir_name

查看修改歷史：

cvs log file_name
cvs history file_name

查看當(dāng)前文件不同版本的區(qū)別

cvs diff -r1.3 -r1.5 file_name

查看當(dāng)前文件（可能已經(jīng)修改了）和庫(kù)中相應(yīng)文件的區(qū)別

cvs diff file_name

cvs的web界面提供了更方便的定位文件修改和比較版本區(qū)別的方法，具體安裝設(shè)置請(qǐng)看后面的cvsweb使用

正確的通過(guò)CVS恢復(fù)舊版本的方法：
如果用

cvs update -r1.2 file.name

這個(gè)命令是給file.name加一個(gè)STICK TAG： "1.2" ，雖然你的本意只是想將它恢復(fù)到1.2版本
正確的恢復(fù)版本的方法是

cvs update -p -r1.2 file_name >file_name

如果不小心已經(jīng)加成STICK TAG的話(huà)：用cvs update -A 解決

移動(dòng)文件：文件重命名
cvs里沒(méi)有cvs move或cvs rename，因?yàn)檫@兩個(gè)操作是先cvs remove old_file_name，然后cvs add new_file_name實(shí)現(xiàn)的。

刪除，移動(dòng)目錄：
最方便的方法是讓管理員直接移動(dòng)，刪除CVSROOT里相應(yīng)目錄（因?yàn)镃VS一個(gè)項(xiàng)目下的子目錄都是獨(dú)立的，移動(dòng)到$CVSROOT目錄下都可以作為新的獨(dú)立項(xiàng)目：好比一顆樹(shù)，其實(shí)砍下任意一枝都能獨(dú)立存活），對(duì)目錄進(jìn)行了修改后，要求其開(kāi)發(fā)人員重新導(dǎo)出項(xiàng)目cvs checkout project_name 或者用cvs update -dP同步。

CVS Branch：項(xiàng)目多分支同步開(kāi)發(fā)
=============================

確認(rèn)版本里程碑：多個(gè)文件各自版本號(hào)不一樣，項(xiàng)目到一定階段，可以給所有文件統(tǒng)一指定一個(gè)階段里程碑版本號(hào)，方便以后按照這個(gè)階段里程碑版本號(hào)導(dǎo)出項(xiàng)目，同時(shí)也是項(xiàng)目的多個(gè)分支開(kāi)發(fā)的基礎(chǔ)。

cvs tag release_1_0

開(kāi)始一個(gè)新的里程碑：

cvs commit -r 2

標(biāo)記所有文件開(kāi)始進(jìn)入2.x的開(kāi)發(fā)

注意：CVS里的revsion和軟件包的發(fā)布版本可以沒(méi)有直接的關(guān)系。但所有文件使用和發(fā)布版本一致的版本號(hào)比較有助于維護(hù)。

在開(kāi)發(fā)項(xiàng)目的2.x版本的時(shí)候發(fā)現(xiàn)1.x有問(wèn)題，但2.x又不敢用，則從先前標(biāo)記的里程碑：release_1_0導(dǎo)出一個(gè)分支release_1_0_patch

cvs rtag -b -r release_1_0 release_1_0_patch proj_dir

一些人先在另外一個(gè)目錄下導(dǎo)出release_1_0_patch這個(gè)分支：解決1.0中的緊急問(wèn)題，

cvs checkout -r release_1_0_patch

而其他人員仍舊在項(xiàng)目的主干分支2.x上開(kāi)發(fā)

在release_1_0_patch上修正錯(cuò)誤后，標(biāo)記一個(gè)1.0的錯(cuò)誤修正版本號(hào)

cvs tag release_1_0_patch_1

如果2.0認(rèn)為這些錯(cuò)誤修改在2.0里也需要，也可以在2.0的開(kāi)發(fā)目錄下合并release_1_0_patch_1中的修改到當(dāng)前代碼中：

cvs update -j release_1_0_patch_1

CVS的遠(yuǎn)程認(rèn)證：通過(guò)SSH遠(yuǎn)程訪(fǎng)問(wèn)CVS
================================

使用cvs本身的遠(yuǎn)程認(rèn)證很麻煩,需要定義服務(wù)器和用戶(hù)組，用戶(hù)名，設(shè)置密碼等，而且不安全，因此和系統(tǒng)本地帳號(hào)認(rèn)證并通過(guò)SSH傳輸是比較好的辦法，通過(guò)在客戶(hù)機(jī)的/etc/profile里設(shè)置一下內(nèi)容：

CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH

所有客戶(hù)機(jī)所有本地用戶(hù)都可以映射到CVS服務(wù)器相應(yīng)同名帳號(hào)了。

如果CVS所在服務(wù)器的SSH端口不在缺省的22，或者和客戶(hù)端與CVS服務(wù)器端SSH缺省端口不一致，有時(shí)候設(shè)置了：

:ext:$USER@test.server.address#port:/path/to/cvsroot

仍然不行，比如有以下錯(cuò)誤信息：

ssh: test.server.address#port: Name or service not known
cvs [checkout aborted]: end of file from server (consult above messages if any)

解決的方法是做一個(gè)腳本指定端口轉(zhuǎn)向（不能使用alias，會(huì)出找不到文件錯(cuò)誤）：
創(chuàng)建一個(gè)/usr/bin/ssh_cvs文件：

#!/usr/bin/sh
/path/to/ssh -p 34567 "$@"

然后：chmod +x /usr/bin/ssh_cvs
并CVS_RSH=ssh_cvs; export CVS_RSH

注意：port是指相應(yīng)服務(wù)器SSH的端口，不是cvs pserver的端口

CVSWEB：提高程序員比較文件修改效率
================================

CVSWEB就是CVS的WEB界面，可以大大提高程序員定位修改的效率:
使用的樣例可以看：http://www.freebsd.org/cgi/cvsweb.cgi

CVSWEB的下載：CVSWEB從最初的版本已經(jīng)演化出很多功能界面更豐富的版本，這個(gè)是個(gè)人感覺(jué)覺(jué)得安裝設(shè)置比較方便的：http://www.spaghetti-code.de/software/linux/cvsweb/

下載解包：

tar zxf cvsweb.tgz

把配置文件cvsweb.conf放到安全的地方（比如和apache的配置放在同一個(gè)目錄下），
修改：cvsweb.cgi讓CGI找到配置文件：

$config = $ENV{'CVSWEB_CONFIG'} || '/path/to/apache/conf/cvsweb.conf';

轉(zhuǎn)到/path/to/apache/conf下并修改cvsweb.conf：

修改CVSROOT路徑設(shè)置：
%CVSROOT = (
'Development' => '/path/to/cvsroot', #<==修改指向本地的CVSROOT
);
缺省不顯示已經(jīng)刪除的文檔：
"hideattic" => "1",#<==缺省不顯示已經(jīng)刪除的文檔
在配置文件cvsweb.conf中還可以定制頁(yè)頭的描述信息，你可以修改$long_intro成你需要的文字

CVSWEB可不能隨便開(kāi)放給所有用戶(hù)，因此需要使用WEB用戶(hù)認(rèn)證：
先生成 passwd:

/path/to/apache/bin/htpasswd -c cvsweb.passwd user

修改httpd.conf: 增加

<Directory "/path/to/apache/cgi-bin/cvsweb/">
AuthName "CVS Authorization"
AuthType Basic
AuthUserFile /path/to/cvsweb.passwd
require valid-user
</Directory>

CVS TAGS: who? when?
====================

將$Id$ 加在程序文件開(kāi)頭的注釋里是一個(gè)很好的習(xí)慣，cvs能夠自動(dòng)更新其中的內(nèi)容成：file_name version time user_name 的格式，比如：cvs_card.txt,v 1.1 2002/04/05 04:24:12 chedong Exp，可以這些信息了解文件的最后修改人和修改時(shí)間

幾個(gè)常用的缺省文件：
default.php

Default.java: 注意文件頭一般注釋用 /* 開(kāi)始 JAVADOC注釋用 /** 開(kāi)始的區(qū)別

/*
* Copyright (c) 2002 Company Name.
* $Id$
*/

package com.netease;

import java.io;

/**
* comments here
*/
public class Default {
    /**
    *
    * @param
    * @return
    */
    public toString() {

    }
}

default.pl:

#!/usr/bin/perl -w
# Copyright (c) 2002 Company Name.
# $Id$

# file comments here

use strict;

相關(guān)資源：

CVS HOME：
http://www.cvshome.org/

CVS FAQ：
http://www.loria.fr/~molli/cvs-index.html

相關(guān)網(wǎng)站:
Google: CVS

CVS 免費(fèi)書(shū):
http://cvsbook.red-bean.com/

CVS 命令的速查卡片：
http://www.refcards.com/about/cvs.html