<!-- * Use this issue template for suggesting new docs or updates to existing docs. Note: Doc work as part of feature development is covered in the Feature Request template. * For issues related to features of the docs.gitlab.com site, see https://gitlab.com/gitlab-org/gitlab-docs/issues/ * For information about documentation content and process, see https://docs.gitlab.com/ee/development/documentation/ --> <!-- Type of issue --> <!-- Un-comment the line for the applicable doc issue type to add its label. Note that all text on that line is deleted upon issue creation. --> <!-- /label gitlab-ce~9444928 - Correction or clarification needed. --> <!-- /label gitlab-ce~9444930 - Improving an existing doc; e.g. adding a diagram, adding or rewording text, resolving redundancies, cross-linking, etc. --> <!-- /label gitlab-ce~9444931 - Review a page or group of pages in order to plan and implement major improvements/rewrites. --> <!-- /label gitlab-ce~9444932 - Anything else. --> ### Problem to solve The page https://docs.gitlab.com/runner/commands/#limitations-of-gitlab-runner-exec does not contain information with regards to setting up `gitlab-runner exec` when you use **Relative URLs** (see: https://docs.gitlab.com/ee/ci/git_submodules.html#configuring-the-gitmodules-file). ### Further details It would be useful if there was a section explaining how to clone submodules locally with an example so that `gitlab-runner exec` does not fail with an error that a certain repository cannot be found. ### Proposal Example `.gitmodules` file: ``` [submodule "subdir/repo"] path = subdir/repo url = ../subdir/repo.git [submodule "library"] path = library url = ../library.git ``` Assume the repository I'm running `gitlab-runner exec` in is `group/application.git` you run the following clone commands to get it to work: ``` git clone --bare https://gitlab.local/group/subdir/repo.git subdir/repo.git git clone --bare https://gitlab.local/group/library.git library.git git clone https://gitlab.local/group/application.git cd application gitlab-runner exec shell build ```