サブモジュールの使い方 (submodule) [Git]

サブモジュール (submodule)

参考：

サブモジュール | Pro Git Book [公式]

git submodule コマンド

参考：

git-submodule | Git Documentation [Official]

導入

参考：

Git submodule の基礎 – Qiita

Git のサブモジュール機能を使ってプロジェクトを管理してみよう | vdeep

git submodule を追加してみる – Qiita

Git のサブモジュールを使ってみる | CUBE SUGAR CONTAINER

git submodule は癖がすごいとの噂だったが素直につきあっていけそうという話 | deadwood

使い方

参考：

git submodule 使い方 | transitive.info

まとめ

参考：

Git submodule の押さえておきたい理解ポイントのまとめ – Qiita

サブモジュールをチェックアウトする

サブモジュールのディレクトリ内でチェックアウトした後、プロジェクトで git add してコミットする。

$ cd my_project
$ cd my_module
$ git checkout v1.2.3
$ cd ..
$ git add my_module
$ commit -m 'Bump up my_module to v1.2.3'
$ git push

参考：

git submodule でブランチ/タグをチェックアウトする – Qiita

git のサブモジュールにて特定のブランチやコミットを使用する | ハックノート

git submodule を別のブランチに切り替える | ごずろぐ

How can I specify a branch/tag when adding a Git submodule? – Stack Overflow

git submodule update

リモートの変更を反映させる。

$ git pull
$ git submodule update

参考：

git submodule の更新方法を勘違いしていた | rochefort’s blog

連動してコミットとプッシュを行う

参考：

Git submodule を親のリポジトリと同時にコミット、プッシュしたい – スタック・オーバーフロー

リポジトリを変更する

.gitmodules ファイルを編集して、git submodule sync コマンドを実行する。

参考：

How to change the remote repository for a git submodule? – Stack Overflow

--ignore-submodules オプション

参考：

Git のサブモジュールで発生した変更を親リポジトリで無視する2つの方法 | DevelopersIO

再作成する

参考：

git submodule を再作成する時の注意 – Qiita

ローカルのみでサブモジュールを作成する

参考：

Nested git repositories without remotes (a.k.a. git submodule without remotes) – Stack Overflow