Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
be1fc7c5
Commit
be1fc7c5
authored
Dec 10, 2019
by
Marcel Amirault
Committed by
Evan Read
Dec 10, 2019
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Clarify custom ci config path details
parent
b3b453c7
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
19 additions
and
16 deletions
+19
-16
doc/user/project/pipelines/settings.md
doc/user/project/pipelines/settings.md
+19
-16
No files found.
doc/user/project/pipelines/settings.md
View file @
be1fc7c5
...
...
@@ -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
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
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.
To customize the path:
If the CI configuration will stay within the repository, but in a
location different than the default,
the path must be relative to the root directory. Examples of valid paths and file names:
1.
Go to the project's
**Settings > CI / CD**
.
1.
Expand the
**General pipelines**
section.
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)
-
`.my-custom-file.yml`
-
`my/path/.gitlab-ci.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
to the root directory in the other project, with the group and project name added to the end:
-
`.gitlab-ci.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,
the URL link must end with
`.yml`
:
-
`http://example.com/generate/ci/config.yml`
Hosting the configuration file in a separate project allows stricter control of the
configuration file. For example:
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**
.
1.
Expand the
**General pipelines**
section.
1.
Provide a value in the
**Custom CI configuration path**
field.
1.
Click
**Save changes**
.
Other users and projects will be able to access the configuration file without being
able to edit it.
## Test coverage parsing
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment