How to manage Git submodules: initialize, update or remove them, checkout specific commit or tag, track selected branch and persist changes in a parent repository.
The working directory must contain already initiated Git repository, so use
git init or just clone some existing repository.
The following command adds an existing Git submodule to a folder inside a selected destination or repository root (if destination is not specified).
URL pointing to a submodule is mandatory, destination – optional.
This will also create
.gitmodules file in the repository root.
That file contains detailed information about all the installed submodules.
When you check
git status you will notice there are new files:
.gitmodules and a file representing the submodule repository you added.
Perform a commit so that
gitlink in the parent repository is updated and (optionally) push the changes.
Change submodule version
By default, submodules track
HEAD of the master branch, but will NOT be updated as you update your primary repository.
In order to update a submodule to the latest available version run:
In order to make the submodule track a particular commit, specific tag or different branch change directory to the submodule folder and switch branches just like you would in a normal repo.
Finally, remember to persist changes in a parent (root) repository.
Unfortunately, right now Git does not have a built-in way to remove submodules, it needs to be done manually. Hopefully this will be resolved in the future.
Again, remember to persist changes.
- Chris Jean – Git Submodules: Adding, Using, Removing, Updating
- Git Book – 7.11 Git Tools - Submodules
- Stack Overflow – How do I remove a submodule?
- Two Guys Arguing – Tie Git Submodules to a Particular Commit or Branch
This entry is a part of my Today I Learned (TIL) series, in which I take and share short notes on what I have recently learned.