From 8788fb925706cad594adf6917a6c5f6587dd1521 Mon Sep 17 00:00:00 2001 From: Karl-Philipp Richter Date: Wed, 8 Aug 2018 12:07:50 +0200 Subject: Add information that artifacts can only exist relative to the build directory MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit As explained in https://gitlab.com/gitlab-org/gitlab-ce/issues/15530. A note that the declaration of an absolute directory triggers a misleading error message and that following job(s) can't find the file is important to avoid large scale time waisting until the issue is fixed. Originally submitted at https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6838. Signed-off-by: Rémy Coutable --- doc/ci/caching/index.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/ci/caching/index.md b/doc/ci/caching/index.md index c159198d16b..3598c255e08 100644 --- a/doc/ci/caching/index.md +++ b/doc/ci/caching/index.md @@ -489,7 +489,15 @@ needed to compile the project: Artifacts were designed to upload some compiled/generated bits of the build, and they can be fetched by any number of concurrent Runners. They are guaranteed to be available and are there to pass data between jobs. They are - also exposed to be downloaded from the UI. + also exposed to be downloaded from the UI. **Artifacts can only exist in + directories relative to the build directory** and specifying paths which don't + comply to this rule trigger an unintuitive and unlogical error message (an + enhancement is discussed at + https://gitlab.com/gitlab-org/gitlab-ce/issues/15530). Artifacts need to be + uploaded to the GitLab instance (not only the GitLab runner) before the next + stage job(s) can start, so you need to evaluate carefully whether your + bandwidth allows you to profit from parallelization with stages and shared + artifacts before investing time in changes to the setup. It's sometimes confusing because the name artifact sounds like something that is only useful outside of the job, like for downloading a final image. But -- cgit v1.2.1