summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAchilleas Pipinellis <axil@gitlab.com>2017-12-21 11:43:29 +0000
committerAchilleas Pipinellis <axil@gitlab.com>2017-12-21 11:43:29 +0000
commit5d487606540b03b54e728f48e5525749dd79fbe9 (patch)
tree2797ad062a170f0df39f031299e06f0fbb27d537 /doc
parente615565756e2a73de85fcf1e1c352d217c23d9fc (diff)
parentb6e37978bcc595d5336d09c8e0bbb854fbb7cf14 (diff)
downloadgitlab-ce-5d487606540b03b54e728f48e5525749dd79fbe9.tar.gz
Merge branch '41227-document-volume-mounts-with-docker-dind' into 'master'
Resolve "Docker volumes not mounted when using docker:dind" See merge request gitlab-org/gitlab-ce!16070
Diffstat (limited to 'doc')
-rw-r--r--doc/ci/docker/using_docker_build.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/ci/docker/using_docker_build.md b/doc/ci/docker/using_docker_build.md
index 0a2419b7ed2..22afcb9199d 100644
--- a/doc/ci/docker/using_docker_build.md
+++ b/doc/ci/docker/using_docker_build.md
@@ -164,6 +164,21 @@ not without its own challenges:
- By default, `docker:dind` uses `--storage-driver vfs` which is the slowest
form offered. To use a different driver, see
[Using the overlayfs driver](#using-the-overlayfs-driver).
+- Since the `docker:dind` container and the runner container don't share their
+ root filesystem, the job's working directory can be used as a mount point for
+ children containers. For example, if you have files you want to share with a
+ child container, you may create a subdirectory under `/builds/$CI_PROJECT_PATH`
+ and use it as your mount point (for a more thorough explanation, check [issue
+ #41227](https://gitlab.com/gitlab-org/gitlab-ce/issues/41227)):
+
+ ```yaml
+ variables:
+ MOUNT_POINT: /builds/$CI_PROJECT_PATH/mnt
+
+ script:
+ - mkdir -p "$MOUNT_POINT"
+ - docker run -v "$MOUNT_POINT:/mnt" my-docker-image
+ ```
An example project using this approach can be found here: https://gitlab.com/gitlab-examples/docker.