2017-05-11 15:21:14 -04:00
|
|
|
# Pipelines settings
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2017-06-06 06:45:55 -04:00
|
|
|
To reach the pipelines settings navigate to your project's
|
2019-01-20 19:45:33 -05:00
|
|
|
**Settings > CI/CD**.
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
The following settings can be configured per project.
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
## Git strategy
|
|
|
|
|
|
|
|
With Git strategy, you can choose the default way your repository is fetched
|
|
|
|
from GitLab in a job.
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
There are two options. Using:
|
2016-10-17 11:00:30 -04:00
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
- `git clone`, which is slower since it clones the repository from scratch
|
2016-10-17 11:00:30 -04:00
|
|
|
for every job, ensuring that the project workspace is always pristine.
|
2019-01-20 19:45:33 -05:00
|
|
|
- `git fetch`, which is faster as it re-uses the project workspace (falling
|
2016-10-17 11:00:30 -04:00
|
|
|
back to clone if it doesn't exist).
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
The default Git strategy can be overridden by the [GIT_STRATEGY variable](../../../ci/yaml/README.md#git-strategy)
|
2016-10-17 11:00:30 -04:00
|
|
|
in `.gitlab-ci.yml`.
|
2016-08-05 05:29:09 -04:00
|
|
|
|
|
|
|
## Timeout
|
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
Timeout defines the maximum amount of time in minutes that a job is able run.
|
2019-02-23 07:49:55 -05:00
|
|
|
This is configurable under your project's **Settings > CI/CD > General pipelines settings**.
|
2016-10-17 11:00:30 -04:00
|
|
|
The default value is 60 minutes. Decrease the time limit if you want to impose
|
|
|
|
a hard limit on your jobs' running time or increase it otherwise. In any case,
|
|
|
|
if the job surpasses the threshold, it is marked as failed.
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2018-02-20 23:28:08 -05:00
|
|
|
### Timeout overriding on Runner level
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/17221) in GitLab 10.7.
|
2018-02-20 23:28:08 -05:00
|
|
|
|
|
|
|
Project defined timeout (either specific timeout set by user or the default
|
2019-01-20 19:45:33 -05:00
|
|
|
60 minutes timeout) may be [overridden on Runner level](../../../ci/runners/README.html#setting-maximum-job-timeout-for-a-runner).
|
2018-02-20 23:28:08 -05:00
|
|
|
|
2017-07-05 08:11:01 -04:00
|
|
|
## Custom CI config path
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12509) in GitLab 9.4.
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2017-06-28 06:17:53 -04:00
|
|
|
By default we look for the `.gitlab-ci.yml` file in the project's root
|
|
|
|
directory. If you require a different location **within** the repository,
|
2017-06-28 03:53:12 -04:00
|
|
|
you can set a custom filepath that will be used to lookup the config file,
|
2016-08-05 05:29:09 -04:00
|
|
|
this filepath should be **relative** to the root.
|
|
|
|
|
|
|
|
Here are some valid examples:
|
|
|
|
|
2018-11-13 01:07:16 -05:00
|
|
|
- `.gitlab-ci.yml`
|
|
|
|
- `.my-custom-file.yml`
|
|
|
|
- `my/path/.gitlab-ci.yml`
|
|
|
|
- `my/path/.my-custom-file.yml`
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
## Test coverage parsing
|
|
|
|
|
|
|
|
If you use test coverage in your code, GitLab can capture its output in the
|
2017-02-13 11:59:57 -05:00
|
|
|
job log using a regular expression. In the pipelines settings, search for the
|
2016-10-17 14:41:24 -04:00
|
|
|
"Test coverage parsing" section.
|
2016-10-17 11:00:30 -04:00
|
|
|
|
2016-10-17 14:41:24 -04:00
|
|
|
![Pipelines settings test coverage](img/pipelines_settings_test_coverage.png)
|
|
|
|
|
|
|
|
Leave blank if you want to disable it or enter a ruby regular expression. You
|
2019-01-20 19:45:33 -05:00
|
|
|
can use <http://rubular.com> to test your regex.
|
2016-10-17 14:41:24 -04:00
|
|
|
|
|
|
|
If the pipeline succeeds, the coverage is shown in the merge request widget and
|
2017-02-13 11:59:57 -05:00
|
|
|
in the jobs table.
|
2016-10-17 14:41:24 -04:00
|
|
|
|
|
|
|
![MR widget coverage](img/pipelines_test_coverage_mr_widget.png)
|
|
|
|
|
|
|
|
![Build status coverage](img/pipelines_test_coverage_build.png)
|
|
|
|
|
|
|
|
A few examples of known coverage tools for a variety of languages can be found
|
|
|
|
in the pipelines settings page.
|
2016-10-17 11:00:30 -04:00
|
|
|
|
|
|
|
## Visibility of pipelines
|
|
|
|
|
2017-09-06 05:20:44 -04:00
|
|
|
Access to pipelines and job details (including output of logs and artifacts)
|
|
|
|
is checked against your current user access level and the **Public pipelines**
|
2017-12-07 09:29:40 -05:00
|
|
|
project setting under your project's **Settings > CI/CD > General pipelines settings**.
|
2017-09-06 05:20:44 -04:00
|
|
|
|
|
|
|
If **Public pipelines** is enabled (default):
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
- For **public** projects, anyone can view the pipelines and access the job details
|
|
|
|
(output logs and artifacts).
|
|
|
|
- For **internal** projects, any logged in user can view the pipelines
|
2017-09-06 05:20:44 -04:00
|
|
|
and access the job details
|
2019-01-20 19:45:33 -05:00
|
|
|
(output logs and artifacts).
|
|
|
|
- For **private** projects, any member (guest or higher) can view the pipelines
|
2017-09-06 05:20:44 -04:00
|
|
|
and access the job details
|
2019-01-20 19:45:33 -05:00
|
|
|
(output logs and artifacts).
|
2017-09-06 05:20:44 -04:00
|
|
|
|
|
|
|
If **Public pipelines** is disabled:
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
- For **public** projects, anyone can view the pipelines, but only members
|
|
|
|
(reporter or higher) can access the job details (output logs and artifacts).
|
|
|
|
- For **internal** projects, any logged in user can view the pipelines.
|
|
|
|
However, only members (reporter or higher) can access the job details (output logs
|
|
|
|
and artifacts).
|
|
|
|
- For **private** projects, only members (reporter or higher)
|
|
|
|
can view the pipelines and access the job details (output logs and artifacts).
|
2016-10-17 11:00:30 -04:00
|
|
|
|
2017-02-19 17:17:24 -05:00
|
|
|
## Auto-cancel pending pipelines
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9362) in GitLab 9.1.
|
2017-02-19 17:17:24 -05:00
|
|
|
|
2017-06-28 03:53:12 -04:00
|
|
|
If you want to auto-cancel all pending non-HEAD pipelines on branch, when
|
|
|
|
new pipeline will be created (after your git push or manually from UI),
|
2017-02-19 17:17:24 -05:00
|
|
|
check **Auto-cancel pending pipelines** checkbox and save the changes.
|
|
|
|
|
2018-04-08 07:39:35 -04:00
|
|
|
## Pipeline Badges
|
2016-10-17 11:00:30 -04:00
|
|
|
|
2017-02-16 16:23:56 -05:00
|
|
|
In the pipelines settings page you can find pipeline status and test coverage
|
2016-10-17 11:00:30 -04:00
|
|
|
badges for your project. The latest successful pipeline will be used to read
|
2017-02-16 16:23:56 -05:00
|
|
|
the pipeline status and test coverage values.
|
2016-10-17 11:00:30 -04:00
|
|
|
|
2016-10-17 14:41:24 -04:00
|
|
|
Visit the pipelines settings page in your project to see the exact link to
|
2016-10-17 11:00:30 -04:00
|
|
|
your badges, as well as ways to embed the badge image in your HTML or Markdown
|
|
|
|
pages.
|
|
|
|
|
|
|
|
![Pipelines badges](img/pipelines_settings_badges.png)
|
|
|
|
|
2017-02-16 16:23:56 -05:00
|
|
|
### Pipeline status badge
|
2016-10-17 11:00:30 -04:00
|
|
|
|
2017-02-13 11:59:57 -05:00
|
|
|
Depending on the status of your job, a badge can have the following values:
|
2016-10-17 11:00:30 -04:00
|
|
|
|
2017-11-20 06:29:11 -05:00
|
|
|
- pending
|
2016-10-17 11:00:30 -04:00
|
|
|
- running
|
2017-11-20 06:29:11 -05:00
|
|
|
- passed
|
2016-10-17 11:00:30 -04:00
|
|
|
- failed
|
|
|
|
- skipped
|
2017-11-20 06:29:11 -05:00
|
|
|
- canceled
|
2016-10-17 11:00:30 -04:00
|
|
|
- unknown
|
|
|
|
|
2017-02-16 16:23:56 -05:00
|
|
|
You can access a pipeline status badge image using the following link:
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
```text
|
2019-02-24 18:43:19 -05:00
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/pipeline.svg
|
2016-10-17 11:00:30 -04:00
|
|
|
```
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
### Test coverage report badge
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
GitLab makes it possible to define the regular expression for [coverage report](#test-coverage-parsing),
|
2017-02-13 11:59:57 -05:00
|
|
|
that each job log will be matched against. This means that each job in the
|
2016-10-17 11:00:30 -04:00
|
|
|
pipeline can have the test coverage percentage value defined.
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
The test coverage badge can be accessed using following link:
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
```text
|
2016-10-17 11:00:30 -04:00
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg
|
|
|
|
```
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
If you would like to get the coverage report from a specific job, you can add
|
|
|
|
the `job=coverage_job_name` parameter to the URL. For example, the following
|
|
|
|
Markdown code will embed the test coverage report badge of the `coverage` job
|
|
|
|
into your `README.md`:
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2016-10-17 11:00:30 -04:00
|
|
|
```markdown
|
|
|
|
![coverage](https://gitlab.com/gitlab-org/gitlab-ce/badges/master/coverage.svg?job=coverage)
|
|
|
|
```
|
2016-08-05 05:29:09 -04:00
|
|
|
|
2019-01-18 08:39:35 -05:00
|
|
|
### Badge styles
|
|
|
|
|
|
|
|
Pipeline badges can be rendered in different styles by adding the `style=style_name` parameter to the URL. Currently two styles are available:
|
|
|
|
|
|
|
|
#### Flat (default)
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
```text
|
2019-01-18 08:39:35 -05:00
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat
|
|
|
|
```
|
|
|
|
|
|
|
|
![Badge flat style](https://gitlab.com/gitlab-org/gitlab-ce/badges/master/coverage.svg?job=coverage&style=flat)
|
|
|
|
|
|
|
|
#### Flat square
|
|
|
|
|
2019-01-20 19:45:33 -05:00
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/30120) in GitLab 11.8.
|
|
|
|
|
|
|
|
```text
|
2019-01-18 08:39:35 -05:00
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat-square
|
|
|
|
```
|
|
|
|
|
|
|
|
![Badge flat square style](https://gitlab.com/gitlab-org/gitlab-ce/badges/master/coverage.svg?job=coverage&style=flat-square)
|
|
|
|
|
|
|
|
## Environment Variables
|
2018-09-07 16:40:44 -04:00
|
|
|
|
2019-04-08 08:32:38 -04:00
|
|
|
[Environment variables](../../../ci/variables/README.html#gitlab-cicd-environment-variables) can be set in an environment to be available to a runner.
|