我想使用一个流行的开源问题跟踪器 (Redmine),它提供 git 集成。不幸的是,跟踪器中的每个项目只能与一个 git 存储库关联。在跟踪器中创建多个项目不是我的理想设置。
考虑到这一点,我尝试使用 git 子树合并(解释此处和此处 )。我创建了一个“伞”存储库,它已合并到我正在使用的众多其他存储库中。
不幸的是,给出的示例仅拉入每个子树的主分支。由于我在每个子树的多个分支中进行开发,因此我需要学习如何让这个伞式存储库反映每个子树的每个分支。
这可能吗?
额外加分:如果 2 个子树各有一个同名的分支怎么办?
I'd like to use a popular, open source issue tracker (Redmine) that offers git integration. Unfortunately, each project in the tracker can only be associated with one git repo. Creating multiple projects in the tracker is not my ideal setup.
With that in mind, I've attempted to use git subtree merging (explained here, and here). I've created an "umbrella" repo which has merged in each of the numerous other repos that I'm working with.
Unfortunately, the examples given only pull in the master branch of each subtree. Since I have development going on in multiple branches of each subtree, I need to learn how to have this umbrella repo reflect each branch of each subtree.
Is this possible?
Extra Credit: What if 2 subtrees each have a branch with the same name?
发布评论
评论(1)
对于我们这些不熟悉 Redmine 的人,请扩展您的描述以包括以下问题的答案: 跟踪器需要对存储库进行何种类型的访问?它需要自己做出承诺吗?或者,它是否只需要某些类型的读取访问(可能是为了验证提交哈希值并扫描提交日志中的关键字)?
如果您的跟踪器只需要读取访问权限,您可能根本不需要任何子树合并。在单个存储库中进行多个初始提交(允许多个独立的历史记录)是完全可以接受的。 Git 项目本身对一些“额外”(man、html、todo)执行此操作,这些“额外内容”不共享(提交)历史记录,但与源代码的主要分支集(maint、master、next、pu)一起发布。出于您的目的,为每个子存储库设置一个远程并将其分支提示提取到您的聚合存储库中可能就足够了。也许自动“远程跟踪分支”就足够了,或者您可能需要采取额外的步骤来基于远程跟踪分支创建(和更新)本地分支。
您描述的子树合并方案在源存储库中的分支不相关或仅半相关的一般情况下可能没有意义。但是,如果所有源存储库共享一组分支,其中每个分支都有一个在所有存储库中相同的给定用途,那么您可能可以有意义地将它们合并到一种超级存储库中。
但有趣的问题不是“如果两个存储库具有相同名称的分支怎么办?”,而是“如何处理存储库缺少共享“全局”集中的分支的情况?”。
如果所有子存储库都有相同的分支集,您只需执行与 master 相同的操作,但每个分支执行一次。当存储库中缺少特定分支时就会出现问题。您可以替换它的master,但这可能并不总是正确的答案。这取决于您首先将存储库聚合在一起的原因以及您期望在超级存储库中该分支的子树中“看到”什么。
如果子存储库不密切相关,那么我真的怀疑这种子树方法的合理性。这种针对不相关存储库的方法感觉像是“违背常理”。这可能仍然是可能的,但我怀疑是否有任何工具可以提供帮助,并且您需要花一些时间规划极端情况。
如果您最终坚持使用子树合并,您可以查看第三方
git 子树
命令。它可能有助于保持无数存储库的同步。收集分支,而不合并
如果Redmine指定
--mirror
克隆,则意味着它需要本地分支,并且可能无法直接读取“远程跟踪分支”,因此您可能需要创建并更新一些本地分支。Local Branches Updated From ‘Remote Tracking Branches’
初始设置
定期更新
Local Branches That Directly Receive Fetched Branch Tips
初始设置
定期更新
这两种方法最终都会收集/ 下还有一组重复的引用。第一个使用普通的 fetch refspec 并使用 gitbranch 将“远程跟踪分支”(refs/remotes/…)复制到普通的本地分支(refs) /heads/all/...)。第二个使用自定义 refspec 将获取的引用直接存储到目标引用层次结构中。
refs/heads/all//
下的分支,但是首先在 refs/remotes/由于更新被盲目地提取到这个组合存储库中,任何人都不应该尝试直接使用它:没有直接在其分支上进行提交,没有从外部推送。如果有人要在本地进行提交或推送到其中一个分支,那么这些提交将在下一次更新完成时被清除。
如果 Redmine 可以处理裸存储库,我建议使用一个。使用 git init --bare 和以 .git 结尾的存储库名称。另外 git config core.logAllRefUpdates true 可能是一个好主意(因为在裸存储库中默认为 false)。
除了命名空间中的
all/
前缀之外,此方法与完整--mirror
克隆之间的另一个区别是,refs/heads
之外的引用和refs/tags
将不会被收集。大多数其他常见引用被认为是存储库的“本地”(这就是为什么它们不会被普通克隆复制)。其他一些引用是“远程跟踪分支”(refs/remotes
)、一些“bisect”记录保存(refs/bisect
)、git filter-branch
“原始”引用备份(refs/original
)等。也许这些其他事情对于Redmine来说都不重要。如果是的话,它们也可以包含在额外的参考规范中。创建额外的初始提交
要安排具有新初始提交的分支,请参阅 GitTips 页面 在如何创建没有祖先的新分支下。其中两个配方涉及另一个存储库,在完成通常的初始化/添加/提交步骤后,您可以从该存储库推送或获取分支(正是上述配方以自动化方式执行的操作)。
For those of us not familiar with Redmine, please extend your description to include answers to the following questions: What kind of access into the repository does the tracker need? Will it need to make its own commits? Or, does it just need certain kinds of read access (perhaps to validate commit hashes and scan commit logs for keywords)?
If your tracker only needs read access, you may not need any subtree merging at all. It is perfectly acceptable to have multiple initial commits (allowing multiple, independent histories) in a single repository. The Git project itself does this for some ‘extras’ (man, html, todo) that share no (commit) history with, but are published alongside the main set of branches for the source code (maint, master, next, pu). For your purpose, it may be enough to setup a remote for each sub-repository and fetch their branch tips into your aggregating repository. Maybe the automatic ‘remote tracking branches’ would be enough, or maybe you need to take the extra step to create (and update) local branches based on the remote tracking branches.
The subtree merging scheme you describe is probably not meaningful in the general situation where the branches in the source repositories are unrelated or only semi-related. But, if all the source repositories share a set of branches where each branch has a given purpose that is the same across all the repositories, you could probably meaningfully merge them into a kind of super-repository.
But the interesting question is not “what if two repositories have branches with the same name?”, but “how do you handle the case where a repository is missing a branch from the shared, ‘global’ set?”.
If all the sub-repositories have the same set of branches, you just do what you did with master, but once for each branch. The problem comes when a particular branch is missing from a repository. You could substitute its master, but that may not always be the right answer. It depends on why you are aggregating the repositories together in the first place and what you expect to ‘see’ in that subtree of that branch in the super-repository.
If the sub-repositories are not closely related, then I really have my doubts about the reasonableness of this subtree approach. Such an approach for unrelated repositories feels like it would be ‘going against the grain’. It is probably still possible, but I doubt there is any tool to help, and you will need to spend some time planning out the corner cases.
If you end up sticking with subtree merges, you might look at the third-party
git subtree
command. It might help in keeping your myriad repositories synchronized.Collecting Branches, Without Merging
If Redmine specifies
--mirror
clone, the implication is that it expects local branches and may not be able to directly read the ‘remote tracking braches’, so you will probably need to create and update some local branches.Local Branches Updated From ‘Remote Tracking Branches’
Initial Setup
Periodic Update
Local Branches That Directly Receive Fetched Branch Tips
Initial Setup
Periodic Update
Both methods end up collecting branches under
refs/heads/all/<remote-name>/<branch-name-on-remote>
, but the first also has a duplicate set of refs underrefs/remotes/<remote-name>/<branch-name-on-remote>
. The first uses a normal fetch refspec and usesgit branch
to duplicate the ‘remote tracking branches’ (refs/remotes/…
) into normal, local branches (refs/heads/all/…
). The second one uses a custom refspec to store the fetched refs directly into the destination ref hierarchy.Because of the way updates are blindly fetched into this combined repository, no one should ever try to directly use it: no commits made directly on its branches, no pushes from outside. If someone were to make commits locally or to push onto one of the branches those commits would be wiped out when the next update is done.
If Redmine can handle a bare repository, I would recommend using one. Use
git init --bare
and a repo name that ends with .git. Alsogit config core.logAllRefUpdates true
might be a good idea (since this defaults to false in a bare repository).Besides the
all/
prefix in the namespaces, another difference between this approach and a full--mirror
clone is that refs outsiderefs/heads
andrefs/tags
will not be collected. Most of the other common refs are considered ‘local’ to a repository (which is why they are not copied by a normal clone). Some of the other refs are ‘remote tracking branches’ (refs/remotes
), some ‘bisect’ record keeping (refs/bisect
),git filter-branch
‘original’ ref backups (refs/original
), et cetera. Probably none of these other things are important for Redmine. If they are, they can also be included with additional refspecs.Creating Extra Initial Commits
To arrange for a branch with an new initial commit, see GitTips page under How to create a new branch that has no ancestor. Two of the recipes involve another repository from which you push or fetch a branch after going through the usual init/add/commit step (exactly what the above recipes do in an automated way).