如何将一个存储库的公共子文件夹与另一个存储库同步？

2024-02-06

我有一个软件项目foo在我公司托管的内部 GitLab 存储库上，并希望将其部分发布为开源项目baa在 GitHub 上。

假设我将公共部分放在“public”文件夹中：

foo/public

以及文件夹“private”中的私有部分：

foo/private

我怎样才能同步public包含公共 GitHub 存储库的文件夹https://github.com/user/new_repository.git ?

在我最疯狂的梦想中我会：

a)自动化管道 (gitlab-ci.yml)foo，转发/同步的每个更改public文件夹到 baa

b)允许外部用户做出贡献baa并能够以某种方式将他们的更改合并回foo.

c)作为 a) 的替代方案，可以在满足某些要求（例如新功能的导出控制）后仅不时进行同步。

我看到了 git 命令

git 子模块
git 子树

and the

GitLab 的存储库镜像功能：

https://docs.gitlab.com/ee/user/project/repository/mirror/ https://docs.gitlab.com/ee/user/project/repository/mirror/

但我不确定它们是否适用于我的用例。

假设我想使用以下部分foo作为子模块baa...如何确保只有文件夹public是考虑而不是整个项目？

也许我的方法是错误的，我应该首先尝试将公共和私人部分分离到各个项目中。

0. 用公用文件夹的内容填充单独的存储库

将文件夹“public”的内容推送到新存储库：

cd public    
git init --initial-branch=main    
git remote add origin https://github.com/user/new_repository.git    
git add .    
git commit -m "Initial commit"     
git push -u origin main

A. 使用单独的存储库作为子模块“public”

集成子模块

删除主文件夹内的公用文件夹
提交主文件夹（=>应用公用文件夹的删除）
添加新存储库作为子模块“public”：

git 子模块添加 -b mainhttps://github.com/user/new_repository.git https://github.com/user/new_repository.git public

git 子模块更新 --remote

git submodule add 命令创建一个文件 .gitmodules ，其中包含

[submodule "public"]
    path = public
    url = https://github.com/user/new_repository.git
    branch = main

提交并推送主文件夹

新鲜克隆

如果其他人做了新鲜克隆主体工程中，递归的需要使用选项。否则子模块文件夹“public”的内容将为空。

提交子模块的更改

如果有人更改了子模块的内容，则需要分别提交/推送子模块和主项目。这似乎是子模块方法的一个缺点。

如果我更改子模块的文件，主项目不会将其识别为更改（提交对话框列表将为空）。一旦我使用子模块文件夹提交了更改，主项目就会识别出更改（子模块的新版本）。然后主要项目也需要提交。

TortoiseGit 的推送对话框的“Recurse submodule”选项的值为“Ondemand”：

因此，至少主模块项目和子模块项目都可以执行推送操作。（如果有一个命令可以提交并推送两者，请告诉我。）

子模块使用的相关问题

如何“git克隆”一个存储库，包括它的子模块？ https://stackoverflow.com/questions/3796927/how-do-i-git-clone-a-repo-including-its-submodules

如何在 git 子模块中“提交”更改？ https://stackoverflow.com/questions/5542910/how-do-i-commit-changes-in-a-git-submodule

如何直接在当前目录中添加 git 子模块的内容，而不需要额外的项目文件夹？ https://stackoverflow.com/questions/76462811/how-to-add-the-content-of-a-git-submodule-directly-in-the-curent-directory-with

git 子模块跟踪最新 https://stackoverflow.com/questions/9189575/git-submodule-tracking-latest?answertab=active#tab-top

B. 使用单独的存储库作为子树“public”

包括子树

删除主文件夹内的公用文件夹
提交主文件夹（=>应用公用文件夹的删除）
使用 subtree 命令在本地包含存储库的文件

git subtree add --prefix public https://github.com/user/new_repository.git main --squash

推送主文件夹（提交已由subtree add命令）

新鲜克隆

新克隆包括子树的所有文件。与子模块相比，不需要额外的命令或选项。

提交子树的更改

子树中的更改被父/主项目识别为正常文件更改，并默认与主项目一起提交。
提交到主项目时，子树的存储库不会自动更新。
为了将本地更改应用到子树存储库，请使用以下显式命令：

git subtree push --prefix public https://github.com/user/new_repository.git main --squash

可以引入一个alias对于 url，使命令的整体长度变短，使用git add remote, see https://www.atlassian.com/git/tutorials/git-subtree https://www.atlassian.com/git/tutorials/git-subtree

拉取子树的变化

git subtree pull --prefix public https://github.com/user/new_repository.git main

子树相关文章

https://gist.github.com/SKempin/b7857a6ff6bddb05717cc17a44091202 https://gist.github.com/SKempin/b7857a6ff6bddb05717cc17a44091202
https://www.atlassian.com/git/tutorials/git-subtree https://www.atlassian.com/git/tutorials/git-subtree

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)