Commit 4144a0fd authored by Kamil Trzciński's avatar Kamil Trzciński

Merge branch 'docs/edit-notes-about-remote-includes' into 'master'

Edit note about remote includes

Closes #58836

See merge request gitlab-org/gitlab-ce!25999
parents 6461cbdf 26171a9f
...@@ -1703,6 +1703,11 @@ of using YAML anchors, you can use the [`extends` keyword](#extends). ...@@ -1703,6 +1703,11 @@ of using YAML anchors, you can use the [`extends` keyword](#extends).
See [usage examples](#include-examples). See [usage examples](#include-examples).
NOTE: **Note:**
`.gitlab-ci.yml` configuration included by all methods is evaluated at pipeline creation.
The configuration is a snapshot in time and persisted in the database. Any changes to
referenced `.gitlab-ci.yml` configuration will not be reflected in GitLab until the next pipeline is created.
#### `include:local` #### `include:local`
`include:local` includes a file from the same repository as `.gitlab-ci.yml`. `include:local` includes a file from the same repository as `.gitlab-ci.yml`.
...@@ -1793,14 +1798,6 @@ include: ...@@ -1793,14 +1798,6 @@ include:
All nested includes will be executed without context as public user, so only another remote, All nested includes will be executed without context as public user, so only another remote,
or public project, or template is allowed. or public project, or template is allowed.
NOTE: **Note:**
Changes to remote includes will not have effect on already created pipelines,
because the include is being evaluated at the time of pipeline creation.
This is when full definition of CI yaml is being expanded in order to create
pipeline with stages with jobs. You always retry job that is already created,
thus created after pipeline creation. To re-include all (thus re-evaluate the
configuration), you have to re-create pipeline.
#### Nested includes #### Nested includes
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/56836) in GitLab 11.9. > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/56836) in GitLab 11.9.
......
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