简体中文 ▾ 主题 ▾ 最新版本 ▾ gitcvs-migration 最后更新于 2.12.5

名称

gitcvs-migration - 适用于 CVS 用户的 Git

概要

git cvsimport *

描述

Git 与 CVS 的不同之处在于，每个工作树都包含一个带有项目历史完整副本的存储库，并且没有哪个存储库本质上比其他存储库更重要。但是，您可以通过指定一个人们可以同步的共享存储库来模拟 CVS 模型；本文档解释了如何做到这一点。

需要对 Git 有一些基本的熟悉。阅读 gittutorial[7] 和 gitglossary[7] 应该就足够了。

使用共享存储库进行开发

假设在主机 foo.com 上的 /pub/repo.git 中设置了一个共享存储库。那么作为个人提交者，您可以通过 ssh 克隆共享存储库

$ git clone foo.com:/pub/repo.git/ my-project
$ cd my-project

然后进行修改。等同于 cvs update 的是

$ git pull origin

它合并了自克隆操作以来其他人可能已完成的任何工作。如果您的工作树中有未提交的更改，请在运行 git pull 之前先提交它们。

注意

pull 命令知道从何处获取更新，因为第一个 git clone 命令设置了一些配置变量；有关详细信息，请参阅 git config -l 和 git-config[1] 手册页。

您可以通过先提交更改，然后使用 git push 命令来更新共享存储库。

$ git push origin master

将这些提交“推送”到共享存储库。如果其他人最近更新了存储库，git push，就像 cvs commit 一样，会抱怨，在这种情况下，您必须在再次尝试推送之前拉取所有更改。

在上面的 git push 命令中，我们指定了要更新的远程分支的名称 (master)。如果我们省略它，git push 会尝试更新远程存储库中与本地存储库中的分支同名的任何分支。因此，最后的 push 可以通过以下任一方式完成：

$ git push origin
$ git push foo.com:/pub/project.git/

只要共享存储库除了 master 之外没有任何分支。

设置共享存储库

我们假设您已经为您的项目创建了一个 Git 存储库，可能是从头开始创建的，或者从 tarball 创建的（参见 gittutorial[7]），或者从已有的 CVS 存储库导入的（参见下一节）。

假设您现有的存储库在 /home/alice/myproject。创建一个新的“裸”存储库（没有工作树的存储库）并将其项目获取到其中

$ mkdir /pub/my-repo.git
$ cd /pub/my-repo.git
$ git --bare init --shared
$ git --bare fetch /home/alice/myproject master:master

接下来，给每个团队成员对这个存储库的读/写访问权限。一种简单的方法是让所有团队成员都可以通过 ssh 访问托管存储库的机器。如果您不想让他们在该机器上拥有完整的 shell，有一个受限 shell 只允许用户进行 Git 推送和拉取；参见 git-shell[1]。

将所有提交者放在同一组中，并使该组可写入存储库

$ chgrp -R $group /pub/my-repo.git

确保提交者的 umask 最多为 027，以便他们创建的目录可被其他组成员写入和搜索。

导入 CVS 归档

注意
 这些说明使用 Git 附带的 git-cvsimport 脚本，但其他导入器可能会提供更好的结果。有关其他选项，请参阅 git-cvsimport[1] 中的注意事项。

首先，从 https://github.com/andreyvit/cvsps 安装 2.1 或更高版本的 cvsps，并确保它在您的路径中。然后 cd 到您感兴趣的项目已检出的 CVS 工作目录并运行 git-cvsimport[1]

$ git cvsimport -C <destination> <module>

这将把指定 CVS 模块的 Git 存档放在目录 中，如果需要，该目录将被创建。

导入会从 CVS 中检出每个文件的每个修订版本。据报道，cvsimport 平均每秒可以处理大约二十个修订版本，因此对于中型项目，这应该不会超过几分钟。大型项目或远程存储库可能需要更长时间。

主干存储在名为 origin 的 Git 分支中，其他 CVS 分支存储在同名的 Git 分支中。主干的最新版本也保留在 master 分支上，因此您可以立即开始添加自己的更改。

导入是增量的，因此如果您下个月再次调用它，它将获取在此期间进行的任何 CVS 更新。为此，您不得修改导入的分支；相反，为自己的更改创建新分支，并根据需要合并导入的分支。

如果您想要一个共享存储库，您需要如上所述对导入的目录进行裸克隆。然后将导入的目录视为用于合并增量导入的另一个开发克隆。

高级共享存储库管理

Git 允许您指定称为“钩子”的脚本在某些点运行。例如，您可以使用它们将所有提交发送到共享存储库的邮件列表。请参阅 githooks[5]。

您可以使用更新钩子强制执行更细粒度的权限。请参阅 使用更新钩子控制分支访问。

为 Git 存储库提供 CVS 访问

还可以为 Git 存储库提供真正的 CVS 访问，以便开发人员仍然可以使用 CVS；有关详细信息，请参阅 git-cvsserver[1]。

替代开发模型

CVS 用户习惯于向一组开发人员提供对公共存储库的提交访问权限。正如我们所看到的，这在 Git 中也是可能的。然而，Git 的分布式特性允许其他开发模型，您可能需要首先考虑其中之一是否更适合您的项目。

例如，您可以选择一个人来维护项目的主要公共存储库。其他开发人员然后克隆此存储库并在他们自己的克隆中工作。当他们有一系列满意的更改时，他们会要求维护者从包含这些更改的分支中拉取。维护者审查他们的更改并将其拉入主存储库，其他开发人员根据需要从该存储库中拉取以保持协调。Linux 内核和其他项目使用这种模型的变体。

对于小型团队，开发人员可能只需从彼此的存储库中拉取更改，而无需中央维护者。

另请参阅

gittutorial[7]、gittutorial-2[7]、gitcore-tutorial[7]、gitglossary[7]、giteveryday[7]、Git 用户手册

GIT

Git[1] 套件的一部分