通过Subversion的命令行,快速搭建版本库服务器端
软件环境:
Svn:CollabNetSubversion-server-1.5.5-1.win32
搭建步骤:
1 建立版本库
Svnadmin create A:/B/repository
例如:>svnadmin create d:/repository
在D盘根目录下,建立版本库svnrepository,当然版本库的目录可以任意指定。
2 修改属性文件
修改repository/conf中的文件内容
文件:Passwd
修改前:
[users]
# harry = harryssecret
# sally = sallyssecret
修改后:
[users]
harry = harryssecret
sally = sallyssecret
这样你就为版本库增加了两个用户:harry,sally,密码分别是“=”后面的内容。我们也可以增加用户,例如
svnuser=svnuser123
文件:svnserve.conf
修改前:
[general]
### These options control access to the repository for unauthenticated
### and authenticated users. Valid values are "write", "read",
### and "none". The sample settings below are the defaults.
# anon-access = read
# auth-access = write
修改后:
[general]
### These options control access to the repository for unauthenticated
### and authenticated users. Valid values are "write", "read",
### and "none". The sample settings below are the defaults.
anon-access = read
auth-access = write
3 添加svn_path环境变量
有可能不是必须要完成的步骤,此部分调查中。。。
4 启动服务
启动建立好的版本库服务。
命令:svnserve -d -r 版本库路径
例如:svnserve -d -r D:/repository
注意:启动后请勿关闭窗口,否则服务会被停掉。
5 导入工程到版本库中
命令:svn important 导入文件PATH 版本库PATH [参数]
通过import命令,将本地未版本化的工程导入到版本库中。导入完成后,svn会为导入的文件设定版本号。
例如:将本地机器上的E:/eclipse_workspace/jdk51导入到版本库中
命令:C:/>svn import E:/eclipse_workspace/jdk5 file:///d:/repository/jdk5 -m "first import jdk5 on 20090317"
运行结果:
Adding E:/eclipse_workspace/jdk5/.classpath
Adding E:/eclipse_workspace/jdk5/.project
Adding E:/eclipse_workspace/jdk5/src
Adding E:/eclipse_workspace/jdk5/src/jdk
Adding E:/eclipse_workspace/jdk5/src/jdk/autoboxing
Adding E:/eclipse_workspace/jdk5/src/jdk/autoboxing/Autoboxing.java
Adding E:/eclipse_workspace/jdk5/src/jdk/bigdecimal
Adding E:/eclipse_workspace/jdk5/src/jdk/bigdecimal/Bigdecimal.java
Adding E:/eclipse_workspace/jdk5/src/jdk/compare
Adding E:/eclipse_workspace/jdk5/src/jdk/compare/Compare.java
Committed revision 1.
命令说明:
-m :指定导入的log信息。-m参数是必须的,但是可以指定空内容。否则的话svn会启动外部编辑器,编辑log内容
/ :svn的版本库path,通过/进行分割,而不是windows的/
运行结果说明:
Adding :表示向版本库中追加文件
Committed revision 1. :表示当前版本为1
注意:
1 import命令导入时,并不会在版本库中建立一个跟工程名同样的文件目录。只是将本地目录下的文件导入到指定版本库的目录下面。上面的导入操作,就是将jdk5下面的文件以及子目录导入到repository下面。所以导入的时候,最好先在版本库repository中建立好目录
2 对版本库下的文件进行删除,移动,拷贝,请务必使用svn的命令,或者客户端工具完成。如果直接在windows下进行删除,拷贝,粘贴操作,svn是无法记录这些操作,同时也就失去了版本控制的意义了。
关于导入时发生的一些问题,参考文章最后。
8 查看版本库文件
命令:svn list 版本库文件目录
通过list命令查看版本库任意目录下的文件夹,以及文件。
例如:查看版本库repository根目录下的文件目录
命令:C:/>svn list file:///d:/repository/jdk5
运行结果:
.classpath
.project
bin/
src/
注意:
我是在C盘下运行的list命令,版本库并不在C分区下,所以必须指定版本库所在的分区。假如,我门直接在版本库所在的分区下运行list命令,无需指定版本库所在的分区
命令:D:/>svn list file:///repository/jdk5
运行结果:
.classpath
.project
bin/
src/
7 取得版本库文件到本地机器
命令:svn checkout 版本库文件PATH 本地路径文件PATH [参数]
通过import命令,仅仅是将本地代码,导入到版本库中。但是版本库中的代码并没有跟本地代码关联起来,即使我们修改了本地代码,也无法反应到版本库中的。
通过checkout命令,从版本库中取得工程的拷贝到本地,所取得的拷贝是和版本库关联在一起的。
例如:将导入的工程到取到本地机器上
命令:D:/>svn checkout file:///repository/jdk5 e:/jdk5 -r 1
运行结果:
A E:/jdk5/.classpath
A E:/jdk5/.project
A E:/jdk5/src
A E:/jdk5/src/jdk
A E:/jdk5/src/jdk/autoboxing
A E:/jdk5/src/jdk/autoboxing/Autoboxing.java
A E:/jdk5/src/jdk/bigdecimal
A E:/jdk5/src/jdk/bigdecimal/Bigdecimal.java
A E:/jdk5/src/jdk/compare
A E:/jdk5/src/jdk/compare/Compare.java
Checked out revision 1.
命令说明:
-r :指定要取得的文件的版本
运行结果说明:
checkout命令会自动为每个文件夹在本地建立一个.svn的隐藏文件文件夹,这个是存放记录本地文件和版本库关联信息文件的。请勿删除,如果删除了,也就失去了和svn版本库的关联关系。
注意:
Checkout命令取得文件时,并不会在指定的本地路径下,自动建立同名目录,需要事先做成相应的文件目录。
9 修改文件,并且提交到svn
命令:svn commit 本地文件PATH
Commit命令是
例如:修改E:/jdk5/src/jdk/autoboxing/Autoboxing.java文件后,提交到svn版本库中
命令:D:/>svn commit E:/jdk5/src/jdk/autoboxing/Autoboxing.java -m "change 20090317"
运行结果
Sending E:/jdk5/src/jdk/autoboxing/Autoboxing.java
Transmitting file data .
Committed revision 2.
命令说明:
执行commit时,只需要指定要提交的文件的路径即可,svn会根据“.svn”文件夹中记录的内容,将命令解析成“svn commit 本地文件PATH 版本库PATH”的形式,然后再执行。这里需要注意的是,被解析的“版本库PATH”中并不包含分需信息,所以必须在版本库所在的目录下面执行commit命令。
上面的命令如果不在D分区下执行,会发生下面的错误:
C:/>svn commit E:/jdk5/src/jdk/autoboxing/Autoboxing.java -m "change 20090317"
svn: Commit failed (details follow):
svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///repository/jdk5/src/jdk/autoboxing'
运行结果说明:
Committed revision 2. :为版本库所有文件设定统一的版本号。这里我们可以看到,即使修改了一个文件,但是svn是将整个版本库的版本设定成2了,也就是说svn并不对单独文件设定版本号
10 追加新文件到svn
命令:svn add 本地目录PATH
add命令会将指定的文件目录以及其包含的文件提交到svn版本库中,同时会为此文件,建立本地文件到版本库的关联关系(建立.svn文件夹)。但是,add命令并不会将文件追加到版本库中,而是需要commit命令进行提交。
例如:把E:/jdk5/src/jdk/Unboxing添加到版本库中
命令:D:/>svn add E:/jdk5/src/jdk/Unboxing
运行结果:
A E:/jdk5/src/jdk/unboxing
A E:/jdk5/src/jdk/unboxing/Unboxing.java
注意:
1 add命令是没有-m参数的,原因调查中。。。
2 add命令并不是真正的把本地文件追加到版本库中,而是让文件或者文件夹在版本控制中,也就是仅仅为文件或者文件夹建立一个和版本库的关联关系。我们用svn list可以发现,Unboxing并没有被追加到版本库中。如下:D:/>svn list file:///d:/repository/jdk5/src/jdk
autoboxing/
bigdecimal/
compare/
generic/
通过commit命令,将文件提交到版本库中。
D:/>svn commit E:/jdk5/src/jdk/unboxing -m "add unboxing"
Adding E:/jdk5/src/jdk/unboxing
Adding E:/jdk5/src/jdk/unboxing/Unboxing.java
Transmitting file data .
Committed revision 6.
注意:
因为我是add一个文件夹到版本库中的,所以不能单独的commit此文件夹下面的某一个文件,只能commit整个文件夹,只提交某一个文件,会发生下面的错误。
D:/>svn commit E:/jdk5/src/jdk/unboxing/Unboxing.java
svn: Commit failed (details follow):
svn: 'E:/jdk5/src/jdk/unboxing' is not under version control and is not part of
the commit, yet its child 'E:/jdk5/src/jdk/unboxing/Unboxing.java' is part of the commit
13 删除版本库文件
命令:svn delete 本地文件path
svn delete 版本库文件path
delete命令,可以执行两种删除,一种是删除本地文件,并且通过修改.svn文件,让被删除的文件在版本库的控制之下,但是并不实际删除版本库中的文件,需要通过commit命令,提交版本库后,执行对版本库的修改。另一种是直接删除版本库中的文件,无需执行commit命令。
方法一:
例如:删除E:/jdk5/src/jdk/unboxing/Unboxing.java文件。
命令:
D:/>svn delete E:/jdk5/src/jdk/unboxing/Unboxing.java
D E:/jdk5/src/jdk/unboxing/Unboxing.java
通过svn list命令查看,版本库中文件实际还存在,只是删除了本地文件,下面通过commit提交删除。
D:/>svn commit E:/jdk5/src/jdk/unboxing/Unboxing.java -m "delete 20090317"
Deleting E:/jdk5/src/jdk/unboxing/Unboxing.java
Committed revision 7.
通过svn list命令查看,版本库文件已经被删除。
方法二:
14 查看版本库log
命令:svn log 版本库PATH
通过 svn log命令,可以查看对版本库操作的所有的log信息,前提是必须在每次对版本库进行操作(导入,删除,修改,移动等)操作是,追加了相应的log。
例如:通过svn log命令,查看第5步中,导入时的log信息
命令:C:/>svn log file:///d:/repository
运行结果:
------------------------------------------------------------------------
r3 | wd | 2009-03-17 14:04:27 +0800 (火, 17 3 2009) | 1 line
first import jdk5 on 20090317
导入的过程中,遇到了一些问题,如下:
问题1:
E:/eclipse_workspace>svn import jdk5 svn://localhost/repository
svn: Could not use external editor to fetch log message; consider setting the $SVN_EDITOR environment variable or using the --message (-m) or --file (-F) option
s
svn: None of the environment variables SVN_EDITOR, VISUAL or EDITOR are set, and
no 'editor-cmd' run-time configuration option was found
原因:
提示要在windows环境变量中,设置SVN_EDITOR。
问题2:
E:/>svn import E:/eclipse_workspace/jdk5 file:///repository/jdk5
'C:/Program' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。
svn: system('C:/Program Files/EmEditor/emeditor.exe svn-commit.tmp') returned
原因:
当没有指定-m参数的时候,svn会启动环境变量SVN_EDITOR中指定的编辑器。上面的命令,没有指定-m参数,但是svn却无法启动SVN_EDITOR设定的编辑器。
解决方法:
在导入命令中,追加-m参数,如下
svn import E:/eclipse_workspace/jdk5 file:///repository/jdk5 -m "import"
-m参数是,导入的时候,需要指定的log信息。
问题3
C:/>svn import E:/eclipse_workspace/jdk5 file:///repository/jdk5 -m "first import jdk5 on 20090317"
svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///repository/jdk5'
原因:
版本库的路径不合法。我们是在C分区根目录下执行import命令的,svn默认认为版本库就在C分区根目录下,然而实际得到版本库是在D分区的根目录下。
解决方法:
修改版本库的绝对路径file:///d:/repository/jdk
问题4
在windows中,手动关闭Subversion Server,为什么导入,还可以正常进行。