Commit 713ffe48 authored by Evan Read's avatar Evan Read

Merge branch 'docs-external-ci-update' into 'master'

Clarify custom ci config path details

See merge request gitlab-org/gitlab!21457
parents b3b453c7 be1fc7c5
...@@ -73,37 +73,40 @@ For information about setting a maximum artifact size for a project, see ...@@ -73,37 +73,40 @@ For information about setting a maximum artifact size for a project, see
By default we look for the `.gitlab-ci.yml` file in the project's root By default we look for the `.gitlab-ci.yml` file in the project's root
directory. If needed, you can specify an alternate path and file name, including locations outside the project. directory. If needed, you can specify an alternate path and file name, including locations outside the project.
Hosting the configuration file in a separate project will allow stricter control of the To customize the path:
configuration file. You can limit access to the project hosting the configuration to only people
with proper authorization, and users can use the configuration for their pipelines,
without being able to modify it.
If the CI configuration will stay within the repository, but in a 1. Go to the project's **Settings > CI / CD**.
location different than the default, 1. Expand the **General pipelines** section.
the path must be relative to the root directory. Examples of valid paths and file names: 1. Provide a value in the **Custom CI configuration path** field.
1. Click **Save changes**.
If the CI configuration is stored within the repository in a non-default
location, the path must be relative to the root directory. Examples of valid
paths and file names include:
- `.gitlab-ci.yml` (default) - `.gitlab-ci.yml` (default)
- `.my-custom-file.yml` - `.my-custom-file.yml`
- `my/path/.gitlab-ci.yml` - `my/path/.gitlab-ci.yml`
- `my/path/.my-custom-file.yml` - `my/path/.my-custom-file.yml`
If the CI configuration will be hosted on an external site, the URL link must end with `.yml`:
- `http://example.com/generate/ci/config.yml`
If the CI configuration will be hosted in a different project within GitLab, the path must be relative If the CI configuration will be hosted in a different project within GitLab, the path must be relative
to the root directory in the other project, with the group and project name added to the end: to the root directory in the other project, with the group and project name added to the end:
- `.gitlab-ci.yml@mygroup/another-project` - `.gitlab-ci.yml@mygroup/another-project`
- `my/path/.my-custom-file.yml@mygroup/another-project` - `my/path/.my-custom-file.yml@mygroup/another-project`
If the CI configuration will be hosted on an external site, different than the GitLab instance, Hosting the configuration file in a separate project allows stricter control of the
the URL link must end with `.yml`: configuration file. For example:
- `http://example.com/generate/ci/config.yml`
The path can be customized at a project level. To customize the path: - Create a public project to host the configuration file.
- Give write permissions on the project only to users who are allowed to edit the file.
1. Go to the project's **Settings > CI / CD**. Other users and projects will be able to access the configuration file without being
1. Expand the **General pipelines** section. able to edit it.
1. Provide a value in the **Custom CI configuration path** field.
1. Click **Save changes**.
## Test coverage parsing ## Test coverage parsing
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment