Using Git submodules with GitLab CI/CD
Use Git submodules to keep a Git repository as a subdirectory of another Git repository. You can clone another repository into your project and keep your commits separate.
When you use Git submodules, your project should have a file named
You might need to modify it to work in a GitLab CI/CD job.
For example, your
.gitmodules configuration might look like the following if:
- Your project is located at
- Your project depends on
https://gitlab.com/group/project, which you want to include as a submodule.
- You check out your sources with an SSH address like
[submodule "project"] path = project url = ../../group/project.git
When your submodule is on the same GitLab server, you should use relative URLs in
.gitmodules file. Then you can clone with HTTPS in all your CI/CD jobs. You
can also use SSH for all your local checkouts.
The above configuration instructs Git to automatically deduce the URL to use when cloning sources. Git uses the same configuration for both HTTPS and SSH. GitLab CI/CD uses HTTPS for cloning your sources, and you can continue to use SSH to clone locally.
For submodules not located on the same GitLab server, use the full URL:
[submodule "project-x"] path = project-x url = https://gitserver.com/group/project-x.git
Use Git submodules in CI/CD jobs
To make submodules work correctly in CI/CD jobs: