Subversion Administration

Administrator’s Toolkit

安装Subversion后,查看下svn提供的实用工具:

[[email protected] ~]# svn [Tab][Tab]
svn   svnadmin  svndumpfilter  svnlook   svnserve    svnsync   svnversion    

简介:

  • svn:命令行客户端程序
  • svnversion:查看当前项目的修订版本的工具
  • svnadmin:Subversion版本库管理程序,可以建立、调整和修复版本库等
  • svndumpfilter:过滤Subversion版本库转储数据流的工具
  • svnlook:直接查看版本库的工具
  • svnserve:一个单独运行的服务器程序,可以作为守护进程或者由SSH调用
  • svnsync:一个通过网络增量镜像版本库的程序

这里参考《Version Control with SUbversion》的“Chapter 5. Repository Administration”进行整理,并进行简单的测试,主要面向fsfs类型的版本库的备份和恢复;有Subversion的概念、组织、授权等请参考本书其他章节。

1. svn

svn is the official command-line client of Subversion. Its functionality is offered via a collection of task-specific subcommands, most of which accept a number of options for fine-grained control of the program’s behavior.

2. svnversion

svnversion is a program for summarizing the revision mixture of a working copy. The resultant revision number, or revision range, is written to standard output.

3. svnadmin

The svnadmin program is the repository administrator’s best friend. Besides providing the ability to create Subversion repositories, this program allows you to perform several maintenance operations on those repositories.

4. svnserve

svnserve allows access to Subversion repositories using Subversion’s custom network protocol.

You can run svnserve as a standalone server process (for clients that are using the svn:// access method); you can have a daemon such as inetd or xinetd launch it for you on demand (also for svn://), or you can have sshd launch it on demand for the svn+ssh:// access method.

5. svnlook

svnlook is a tool provided by Subversion for examining the various revisions and transactions (which are revisions in the making) in a repository. No part of this program attempts to change the repository. svnlook is typically used by the repository hooks for re- porting the changes that are about to be committed (in the case of the pre-commit hook) or that were just committed (in the case of the post-commit hook) to the repository.

6. svndumpfilter

While it won’t be the most commonly used tool at the administrator’s disposal, svndumpfilter provides a very particular brand of useful functionality—the ability to quickly and easily modify streams of Subversion repository history data by acting as a path- based filter.

7. svnsync

The svnsync program provides all the functionality required for maintaining a read-only mirror of a Subversion repository. The program really has one job—to transfer one repository’s versioned history into another repository. And while there are few ways to do that, its primary strength is that it can operate remotely—the “source” and “sink”6 repositories may be on different computers from each other and from svnsync itself.

svnsync is the Subversion remote repository mirroring tool. Put simply, it allows you to replay the revisions of one repository intoanother one.

In any mirroring scenario, there are two repositories: the source repository, and the mirror (or “sink”) repository. The source repository is the repository from which svnsync pulls revisions. The mirror repository is the destination for the revisions pulled from the source repository. Each of the repositories may be local or remote—they are only ever addressed by their URLs.

The svnsync process requires only read access to the source repository; it never attempts to modify it. But obviously, svnsync requires both read and write access to the mirror repository.

Migration Repositories

1. svnadmin dump

[[email protected] repository]# svnadmin help dump
dump: usage: svnadmin dump REPOS_PATH [-r LOWER[:UPPER] [--incremental]]

Dump the contents of filesystem to stdout in a 'dumpfile'
portable format, sending feedback to stderr.  Dump revisions
LOWER rev through UPPER rev.  If no revisions are given, dump all
revision trees.  If only LOWER is given, dump that one revision tree.
If --incremental is passed, the first revision dumped will describe
only the paths changed in that revision; otherwise it will describe
every path present in the repository as of that revision.  (In either
case, the second and subsequent revisions, if any, describe only paths
changed in those revisions.)

Valid options:
  -r [--revision] ARG      : specify revision number ARG (or X:Y range)
  --incremental            : dump incrementally
  --deltas                 : use deltas in dump output
  -q [--quiet]             : no progress (only errors) to stderr

Examples

转储存整个版本库:

[[email protected] ~]# svnadmin dump /data/repository/Test > /data/backup/Test_full.dump
* Dumped revision 0.
* Dumped revision 1.
* Dumped revision 2.
* Dumped revision 3.
* Dumped revision 4.

基于修订版本进行增量转储:

[[email protected] ~]# svnadmin dump /data/repository/Test --incremental > /data/backup/Test_base.dump
* Dumped revision 0.
* Dumped revision 1.
* Dumped revision 2.
* Dumped revision 3.
* Dumped revision 4.
* Dumped revision 5.
* Dumped revision 6.
* Dumped revision 7.
* Dumped revision 8.

检出版本库:

[[email protected] Workspace]# pwd
/root/Workspace
[[email protected] Workspace]# svn checkout --username '[email protected]' --password 'Us*+2&:9L/C,8^.?' http://172.29.88.162/Test .

[[email protected] Workspace]# ls
DBA  Notes  svn  Test

提交更新:

[[email protected] Workspace]# mkdir Incremental
[[email protected] Workspace]# cd Incremental/
[[email protected] Incremental]# ls
[[email protected] Incremental]# touch 1
[[email protected] Incremental]# touch 2
[[email protected] Incremental]# cd ..
[[email protected] Workspace]# svn add Incremental/
A         Incremental
A         Incremental/1
A         Incremental/2
[[email protected] Workspace]# svn commit -m "add incremental"
Adding         Incremental
Adding         Incremental/1
Adding         Incremental/2

增量转存:

[[email protected] Workspace]# svnlook history /data/repository/Test / --show-ids
REVISION   PATH <ID>
--------   ---------
       9   / <0.0.r9/713>
       8   / <0.0.r8/4674>
       7   / <0.0.r7/710>
       6   / <0.0.r6/112>
       5   / <0.0.r5/201>
       4   / <0.0.r4/174>
       3   / <0.0.r3/144851702>
       2   / <0.0.r2/138>
       1   / <0.0.r1/106>
       0   / <0.0.r0/17>

[[email protected] ~]# svnadmin dump /data/repository/Test -r 9 --incremental > /data/backup/Test_r9.dump
* Dumped revision 9.

导入初始增量:

[[email protected] ~]# svnadmin create /data/repository/Inc
[[email protected] ~]# svnadmin load /data/repository/Inc/ < /data/backup/Test_base.dump 

查看目录结构:

[[email protected] ~]# svnlook tree /data/repository/Inc/ --full-paths
/
Test/
DBA/
DBA/LaTeX and WinEdit Tutorial.pdf
... ...
svn/
svn/svn.png
svn/svn.dot
Notes/

导入版本为9的增量:

[[email protected] ~]# svnadmin load /data/repository/Inc/ < /data/backup/Test_r9.dump 
<<< Started new transaction, based on original revision 9
     * adding path : Incremental ... done.
     * adding path : Incremental/1 ... done.
     * adding path : Incremental/2 ... done.

------- Committed revision 9 >>>

查看目录结构:

[[email protected] ~]# svnlook tree /data/repository/Inc/ --full-paths
/
Test/
Incremental/
Incremental/1
Incremental/2
DBA/
DBA/LaTeX and WinEdit Tutorial.pdf
... ...
svn/
svn/svn.png
svn/svn.dot
Notes/

注:

查看版本库的目录结构,:

[[email protected] ~]# svnlook tree /data/repository/Test --full-paths --show-ids
/ <0.0.r4/174>
Test/ <0-4.0.r4/0>
DBA/ <0-1.0.r3/144851472>
DBA/LaTeX and WinEdit Tutorial.pdf <1-3.0.r3/144826285>
... ...

以相应目录的修订版本历史:

[[email protected] ~]# svnlook history /data/repository/Test / --show-ids
REVISION   PATH <ID>
--------   ---------
       4   / <0.0.r4/174>
       3   / <0.0.r3/144851702>
       2   / <0.0.r2/138>
       1   / <0.0.r1/106>
       0   / <0.0.r0/17>
[[email protected] ~]# 

2. svnadmin load

[[email protected] ~]# svnadmin help load
load: usage: svnadmin load REPOS_PATH

Read a 'dumpfile'-formatted stream from stdin, committing
new revisions into the repository's filesystem.  If the repository
was previously empty, its UUID will, by default, be changed to the
one specified in the stream.  Progress feedback is sent to stdout.

Valid options:
  -q [--quiet]             : no progress (only errors) to stderr
  --ignore-uuid            : ignore any repos UUID found in the stream
  --force-uuid             : set repos UUID to that found in stream, if any
  --use-pre-commit-hook    : call pre-commit hook before committing revisions
  --use-post-commit-hook   : call post-commit hook after committing revisions
  --parent-dir ARG         : load at specified directory in repository

Examples

导入转储的版本库:

[[email protected] ~]# svnadmin load /data/repository/Test_load < /data/backup/Test_full.dump 
svnadmin: Can't open file '/data/repository/Test_load/format': No such file or directory

需先创建目标版本库:

[[email protected] ~]# svnadmin create /data/repository/Test_load
[[email protected] ~]# svnadmin load /data/repository/Test_load < /data/backup/Test_full.dump 
<<< Started new transaction, based on original revision 1
     * adding path : DBA ... done.

------- Committed revision 1 >>>

<<< Started new transaction, based on original revision 2
     * adding path : Notes ... done.

------- Committed revision 2 >>>

<<< Started new transaction, based on original revision 3
     * adding path : DBA/CTeX FAQ.pdf ... done.
     ... ...
     * adding path : DBA/template ... done.
     * adding path : DBA/template/CASthesis-v0.1j.zip ... done.
     * adding path : DBA/template/CASthesis-v0.2.zip ... done.

------- Committed revision 3 >>>

<<< Started new transaction, based on original revision 4
     * adding path : Test ... done.

------- Committed revision 4 >>>

3. svndumpfilter

[[email protected] ~]# svndumpfilter help
general usage: svndumpfilter SUBCOMMAND [ARGS & OPTIONS ...]

Type 'svndumpfilter help <subcommand>' for help on a specific subcommand.
Type 'svndumpfilter --version' to see the program version.

Available subcommands:
   exclude
   include
   help (?, h)

Examples

使用svndumpfilter对转储文件进行过滤,include模式,其他的都排除:

[[email protected] repository]# svndumpfilter include "DBA/template" "DBA/pdf" < /data/backup/Test_full.dump > Test_filter.dump
Including prefixes:
   '/DBA/template'
   '/DBA/pdf'

Revision 0 committed as 0.
Revision 1 committed as 1.
Revision 2 committed as 2.
Revision 3 committed as 3.
Revision 4 committed as 4.

Dropped 72 nodes:
   '/DBA'
   '/DBA/CTeX FAQ.pdf'
   '/DBA/LaTeX and WinEdit Tutorial.pdf'
   '/DBA/LaTeX2ε 插图指南.pdf'
   ... ...

--pattern模式,使用正则表达式:

[[email protected] ~]# svndumpfilter exclude --pattern "*template" < /data/backup/Test_full.dump > Test_filter.dump
svndumpfilter: invalid option: --pattern
Type 'svndumpfilter help' for usage.

Note:

Beginning in Subversion 1.7, svndumpfilter can optionally treat the PATH_PREFIXs not merely as explicit substrings, but as file patterns instead。

也就是说,在1.7以上版本的subversion中,才能使用基于正则表达式的路径语法;在低版本中,使用正则表达式语法,只会被当做普通的字符串处理。

查看当前subversion版本信息:

[[email protected] ~]# svnadmin --version
svnadmin, version 1.6.11 (r934486)
   compiled Sep 27 2011, 15:29:25
Copyright (C) 2000-2009 CollabNet.

Subversion is open source software, see http://subversion.tigris.org/
This product includes software developed by CollabNet (http://www.Collab.Net/).

The following repository back-end (FS) modules are available:
* fs_base : Module for working with a Berkeley DB repository.
* fs_fs : Module for working with a plain file (FSFS) repository.

4. svnadmin hotcopy

[[email protected] repository]# svnadmin help hotcopy
hotcopy: usage: svnadmin hotcopy REPOS_PATH NEW_REPOS_PATH
Makes a hot copy of a repository.
Valid options:
  --clean-logs             : remove redundant Berkeley DB log files
                             from source repository [Berkeley DB]

Examples

热拷贝一个版本库:

[[email protected] ~]# svnadmin hotcopy /data/repository/Test /data/repository/Test_hotcopy

使用svnlook tree输出源版本库、新版本库的目录结构,并用diff比较

[[email protected] ~]# svnlook tree /data/repository/Test_hotcopy/ > Test_hotcopy.tree
[[email protected] ~]# svnlook tree /data/repository/Test/ > Test.tree
[[email protected] ~]# diff Test_hotcopy.tree Test.tree 

新版本库路径加到Apache的subversion.conf中,调整authz配置即可正常访问。

5. svnsync

[[email protected] ~]# svnsync help
general usage: svnsync SUBCOMMAND DEST_URL  [ARGS & OPTIONS ...]
Type 'svnsync help <subcommand>' for help on a specific subcommand.
Type 'svnsync --version' to see the program version and RA modules.

Available subcommands:
   initialize (init)
   synchronize (sync)
   copy-revprops
   info
   help (?, h)

Examples

[[email protected] ~]# svnsync init file:///data/repository/Test_mirror file:///data/repository/Test
svnsync: Unable to open an ra_local session to URL
svnsync: Unable to open repository 'file:///data/repository/Test_mirror'

[[email protected] ~]# svnadmin create /data/repository/Test_mirror

[[email protected] ~]# svnsync init file:///data/repository/Test_mirror file:///data/repository/Test
svnsync: Repository has not been enabled to accept revision propchanges;
ask the administrator to create a pre-revprop-change hook

[[email protected] ~]# cd /data/repository/Test_mirror/hooks
[[email protected] hooks]# cp pre-revprop-change.tmpl pre-revprop-change

[[email protected] ~]# svnsync init file:///data/repository/Test_mirror file:///data/repository/Test
svnsync: Revprop change blocked by pre-revprop-change hook (exit code 255) with no output.

[[email protected] ~]# chmod +x /data/repository/Test_mirror/hooks/pre-revprop-change
[[email protected] ~]# svnsync init file:///data/repository/Test_mirror file:///data/repository/Test
svnsync: Revprop change blocked by pre-revprop-change hook (exit code 1) with output:
Changing revision properties other than svn:log is prohibited

有待继续测试… …

6.svnadmin upgrade

[[email protected] repository]# svnadmin help upgrade
upgrade: usage: svnadmin upgrade REPOS_PATH

Upgrade the repository located at REPOS_PATH to the latest supported
schema version.

This functionality is provided as a convenience for repository
administrators who wish to make use of new Subversion functionality
without having to undertake a potentially costly full repository dump
and load operation.  As such, the upgrade performs only the minimum
amount of work needed to accomplish this while still maintaining the
integrity of the repository.  It does not guarantee the most optimized
repository state as a dump and subsequent load would.

7. svnadmin verify

[[email protected] ~]# svnadmin help verify
verify: usage: svnadmin verify REPOS_PATH

Verifies the data stored in the repository.

Valid options:
  -r [--revision] ARG      : specify revision number ARG (or X:Y range)
  -q [--quiet]             : no progress (only errors) to stderr

Sumary

Backup or migrate a Whole Repository:

  • hotcopy

    svnadmin hotcopy src_repo_path dist_repo_path

  • dump with increment

    svnadmin dump -> dump file --> svndumpfilter --> filtered dump file --> svnadmin load

  • sync

    svnsync

svn_backup_and_recovery

Reference

  • Version Control with Subversion


blog comments powered by Disqus

Published

18 January 2013

Categories

Tags

Github