迁移到 Subversion

CVS 有许多 Subversion 已消除的限制。对于 Python 的开发，最显著的改进包括：

• 能够重命名文件和目录，以及删除目录，同时保留这些文件的历史记录。
• 通过全局版本号支持变更集（对多个文件进行的相关更改集）。变更集是事务性的。
• 原子、快速标记：cvs 标记可能需要几分钟；Subversion 标记 (svn cp) 将快速且原子地完成。同样，分支也非常高效。
• 支持离线差异，这在创建补丁时很有用。

迁移到 python.org

SourceForge 在过去几年中为我们提供了重要的基础设施。不幸的是，SF 获得的关注也导致过去多次出现过载情况，SF 运营人员并非总能及时响应。特别是对于 CVS，他们不得不通过引入第二个仅供匿名访问的只读 CVS 服务器来减少主 CVS 服务器上的负载。此服务器定期同步，但在同步之间滞后于读写 CVS 仓库。因此，没有提交权限的用户只能在延迟一段时间后才能看到仓库的最新更改。

在 python.org 上，可以使仓库对匿名访问可用。

收集 SSH 密钥

经过一些讨论，svn+ssh 被选定为对仓库进行写入访问的最佳方法。开发人员可以继续使用他们的 SSH 密钥，但必须将其安装在 python.org 上。

为了避免为每个开发人员创建新的 Unix 用户，应使用单个帐户，并在 authorized_keys 文件中使用 command= 属性。

authorized_keys 文件中的行应如下所示（为了提高可读性而进行了换行）：

command="/usr/bin/svnserve --root=/svnroot -t
--tunnel-user='<username>'",no-port-forwarding,
no-X11-forwarding,no-agent-forwarding,no-pty
ssh-dss <key> <comment>

作为用户名，应使用真实姓名而不是 SF 帐户名，以便能够在日志消息中更好地识别人员。

管理员访问

应向 Python SF 项目的所有当前管理员授予对 pythondev 帐户的管理员访问权限。为了区分 shell 登录和 svnserve 登录，管理员需要维护两个密钥。使用 OpenSSH，可以使用以下过程创建第二个密钥：

cd .ssh
ssh-keygen -t DSA -f pythondev -C <user>@pythondev
vi config

在配置文件中，需要添加以下行：

Host pythondev
  Hostname dinsdale.python.org
  User pythondev
  IdentityFile ~/.ssh/pythondev

然后，可以通过“ssh pythondev”进行 shell 登录。

下载 CVS 仓库

可以从以下地址下载 CVS 仓库：

http://cvs.sourceforge.net/cvstarballs/python-cvsroot.tar.bz2

由于此 tarball 每天仅生成一次，因此在仓库冻结后必须经过一段时间才能获取该 tarball。应验证 python-commits 邮件列表中记录的最后一次提交是否确实包含在 tarball 中。

转换后，转换后的 CVS tarball 应永远保存在 www.python.org/archive/python-cvsroot-<date>.tar.bz2 上。

转换 CVS 仓库

Python CVS 仓库包含两个模块：distutils 和 python。python 模块进一步划分为 dist 和 nondist，其中 dist 仅包含 src（Python 代码本身）。nondist 包含各种子目录。

这些应在 Subversion 仓库中重新组织，以获得更短的 URL，遵循 <project>/{trunk,tags,branches} 结构。将为每个 nondist 目录创建一个项目，以及为 src（称为 python）和 distutils 创建一个项目。最好在 CVS 树中重新组织仓库，如下所示。

应使用 fsfs 后端作为仓库格式（这需要 Subversion 1.1）。fsfs 后端具有更易于备份的优点，因为它允许增量仓库备份，而无需运行任何转储命令。

应使用 cvs2svn 实用程序进行转换，例如，该实用程序可在 cvs2svn Debian 软件包中找到。由于 cvs2svn 目前不支持 project/trunk 结构，因此需要分别转换每个项目。为了将每个转换结果放入目标仓库中的单独目录中，必须使用 svnadmin load。

Subversion 对二进制文件与文本文件的看法与 CVS 不同。为了正确地将 CVS 语义向前传递，应在 CVS 中未标记为二进制的所有文件上将 svn:eol-style 设置为 native。

总而言之，转换脚本如下：

#!/bin/sh
rm cvs2svn-*
rm -rf python py.new
tar xjf python-cvsroot.tar.bz2
rm -rf python/CVSROOT
svnadmin create --fs-type fsfs py.new
mv python/python python/orig
mv python/orig/dist/src python/python
mv python/orig/nondist/* python
# nondist/nondist is empty
rmdir python/nondist
rm -rf python/orig
for a in python/*
do
  b=`basename $a`
  cvs2svn -q --dump-only --encoding=latin1 --force-branch=cnri-16-start \
  --force-branch=descr-branch --force-branch=release152p1-patches \
  --force-tag=r16b1 $a
  svn mkdir -m"Conversion to SVN" file:///`pwd`/py.new/$b
  svnadmin load -q --parent-dir $b py.new < cvs2svn-dump
  rm cvs2svn-dump
done

此转换的示例结果可在以下地址找到：

http://www.dcl.hpi.uni-potsdam.de/pysvn/

发布仓库

仓库应发布在 http://svn.python.org/projects。应通过 svn+ssh://pythondev@svn.python.org/ 为所有当前 SF 提交者授予读写权限；还应通过 WebDAV 授予只读匿名访问权限。

可以选择提供 websvn（例如，可从 Debian websvn 软件包中获得）。不幸的是，在测试安装中，websvn 由于内存不足而崩溃。

当前 SF 项目管理员应获得对 pythondev 帐户的 authorized_keys2 文件的写入权限。

禁用 CVS

看来无法完全禁用 CVS。只能从项目页面中删除用户界面；仓库本身仍然可用。如果需要，可以通过 CVS commitinfo 条目禁用对 python 和 distutils 模块的写入权限。