diff options
| author | Robert Speicher <robert@gitlab.com> | 2017-02-20 18:10:02 +0000 |
|---|---|---|
| committer | Robert Speicher <robert@gitlab.com> | 2017-02-20 18:10:02 +0000 |
| commit | 672c3db31198b561b0c14b64e4be26140b9f75f3 (patch) | |
| tree | 1dd316f3ba3c4ef7c5fd767e6ccd989361ee7b62 | |
| parent | 9fe863f43db93b5b8a4617cb1722d92d31c6ea5e (diff) | |
| parent | 9f14acfb767180afe79c2a7dc37543d2aa5a3063 (diff) | |
| download | gitlab-ce-672c3db31198b561b0c14b64e4be26140b9f75f3.tar.gz | |
Merge branch 'artifactsdoc' into 'master'
Added documentation for permalinks to most recent build artifacts
Closes #27361
See merge request !8934
| -rw-r--r-- | changelogs/unreleased/artifactsdoc.yml | 4 | ||||
| -rw-r--r-- | doc/user/project/pipelines/job_artifacts.md | 31 |
2 files changed, 32 insertions, 3 deletions
diff --git a/changelogs/unreleased/artifactsdoc.yml b/changelogs/unreleased/artifactsdoc.yml new file mode 100644 index 00000000000..4ef32d5256f --- /dev/null +++ b/changelogs/unreleased/artifactsdoc.yml @@ -0,0 +1,4 @@ +--- +title: Added documentation for permalinks to most recent build artifacts. +merge_request: 8934 +author: Christian Godenschwager diff --git a/doc/user/project/pipelines/job_artifacts.md b/doc/user/project/pipelines/job_artifacts.md index f85f4bf8e1e..5ce99843301 100644 --- a/doc/user/project/pipelines/job_artifacts.md +++ b/doc/user/project/pipelines/job_artifacts.md @@ -90,18 +90,43 @@ inside GitLab that make that possible. It is possible to download the latest artifacts of a job via a well known URL so you can use it for scripting purposes. -The structure of the URL is the following: +The structure of the URL to download the whole artifacts archive is the following: ``` https://example.com/<namespace>/<project>/builds/artifacts/<ref>/download?job=<job_name> ``` -For example, to download the latest artifacts of the job named `rspec 6 20` of +To download a single file from the artifacts use the following URL: + +``` +https://example.com/<namespace>/<project>/builds/artifacts/<ref>/file/<path_to_file>?job=<job_name> +``` + +For example, to download the latest artifacts of the job named `coverage` of the `master` branch of the `gitlab-ce` project that belongs to the `gitlab-org` namespace, the URL would be: ``` -https://gitlab.com/gitlab-org/gitlab-ce/builds/artifacts/master/download?job=rspec+6+20 +https://gitlab.com/gitlab-org/gitlab-ce/builds/artifacts/master/download?job=coverage +``` + +To download the file `coverage/index.html` from the same +artifacts use the following URL: + +``` +https://gitlab.com/gitlab-org/gitlab-ce/builds/artifacts/master/file/coverage/index.html?job=coverage +``` + +There is also a URL to browse the latest job artifacts: + +``` +https://example.com/<namespace>/<project>/builds/artifacts/<ref>/browse?job=<job_name> +``` + +For example: + +``` +https://gitlab.com/gitlab-org/gitlab-ce/builds/artifacts/master/browse?job=coverage ``` The latest builds are also exposed in the UI in various places. Specifically, |