サブツリーのマージについて
通常、サブツリーのマージはリポジトリ内にリポジトリを� �納するために使われます。 「サブリポジトリ」はメインのリポジトリのフォルダー内に� �納されます。
サブツリーマージは、例で説明するのが最も分かりやすいでしょう。 以下のように進めます:
- プロジェクトを表す
test
という空のリポジトリを作成します - 別のリポジトリを
Spoon-Knife
というサブツリーとして、そこにマージします。 test
プロジェクトでは、そのサブプロジェクトを同じリポジトリの一部であるかのように使います。Spoon-Knife
からtest
プロジェクトに更新プログラ� を取り込みます。
サブツリーマージのための空のリポジトリのセットアップ
- [ターミナル][ターミナル][Git Bash] を開きます。
- 新しいディレクトリを作成し、そこに移動します。
$ mkdir test $ cd test
- 新しい Git リポジトリを初期化します。
$ git init > Initialized empty Git repository in /Users/octocat/tmp/test/.git/
- 新しいファイルを作成してコミットします。
$ touch .gitignore $ git add .gitignore $ git commit -m "initial commit" > [main (root-commit) 3146c2a] initial commit > 0 files changed, 0 insertions(+), 0 deletions(-) > create mode 100644 .gitignore
新しいリポジトリをサブツリーとして追�
-
関心のある別個のプロジェクトを指す新しいリモート URL を追� します。
$ git remote add -f spoon-knife https://github.com/octocat/Spoon-Knife.git > Updating spoon-knife > warning: no common commits > remote: Counting objects: 1732, done. > remote: Compressing objects: 100% (750/750), done. > remote: Total 1732 (delta 1086), reused 1558 (delta 967) > Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done. > Resolving deltas: 100% (1086/1086), done. > From https://github.com/octocat/Spoon-Knife > * [new branch] main -> Spoon-Knife/main
-
Spoon-Knife
プロジェクトをローカルの Git プロジェクトにマージします。 こうしてもローカルではファイルはまったく変更されませんが、Git は次のステップに備えることになります。Git 2.9 以降を使用している� �合:
$ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main > Automatic merge went well; stopped before committing as requested
Git 2.8 以前を使用している� �合:
$ git merge -s ours --no-commit spoon-knife/main > Automatic merge went well; stopped before committing as requested
-
spoon-knife というディレクトリを新たに作成し、
Spoon-Knife
プロジェクトの Git 履歴をそこへコピーします。$ git read-tree --prefix=spoon-knife/ -u spoon-knife/main
-
変更をコミットして安全にします。
$ git commit -m "Subtree merged in spoon-knife" > [main fe0ca25] Subtree merged in spoon-knife
ここでは 1 つのサブプロジェクトを追� した� けですが、Git リポジトリには任意の数のサブプロジェクトを取り込むことができます。
参考: 将来このリポジトリのクローンを新しく作成した� �合、追� したリモートは作成されません。 git remote add
コマンドを使用して、もう一度追� する必要があります。
更新および変更の同期
サブプロジェクトが追� された� �合、そのサブプロジェクトは上流の変更と自動的には同期されません。 以下のコマンドで、サブプロジェクトを更新する必要があります。
$ git pull -s subtree remotename branchname
上の例では、以下のようになるでしょう:
$ git pull -s subtree spoon-knife main