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
8d0be1f3
Commit
8d0be1f3
authored
Feb 10, 2022
by
Marcel Amirault
Committed by
Kati Paizee
Feb 10, 2022
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update details about pipeline schedule frequency
parent
32a93d55
Changes
2
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
16 additions
and
10 deletions
+16
-10
doc/ci/pipelines/schedules.md
doc/ci/pipelines/schedules.md
+15
-9
doc/topics/cron/index.md
doc/topics/cron/index.md
+1
-1
No files found.
doc/ci/pipelines/schedules.md
View file @
8d0be1f3
...
@@ -17,7 +17,9 @@ Pipeline schedules can be used to also run [pipelines](index.md) at specific int
...
@@ -17,7 +17,9 @@ Pipeline schedules can be used to also run [pipelines](index.md) at specific int
-
Every other Sunday at 0900 hours (cron example:
`0 9 * * sun%2`
).
-
Every other Sunday at 0900 hours (cron example:
`0 9 * * sun%2`
).
-
Once every day (cron example:
`0 0 * * *`
).
-
Once every day (cron example:
`0 0 * * *`
).
Schedule timing is configured with cron notation, parsed by
[
Fugit
](
https://github.com/floraison/fugit
)
.
Schedule timing is configured with
[
cron notation
](
../../topics/cron/index.md
)
.
You can use any cron value, but scheduled pipelines cannot run more frequently
than the instance's
[
maximum frequency for scheduled pipelines
](
#advanced-configuration
)
.
In addition to using the GitLab UI, pipeline schedules can be maintained using the
In addition to using the GitLab UI, pipeline schedules can be maintained using the
[
Pipeline schedules API
](
../../api/pipeline_schedules.md
)
.
[
Pipeline schedules API
](
../../api/pipeline_schedules.md
)
.
...
@@ -82,20 +84,24 @@ job:
...
@@ -82,20 +84,24 @@ job:
### Advanced configuration **(FREE SELF)**
### Advanced configuration **(FREE SELF)**
The pipelines are not executed exactly on schedule because schedules are handled by
Scheduled pipelines can be configured with any
[
cron value
](
../../topics/cron/index.md
)
,
Sidekiq, which runs according to its interval.
but they do not always run exactly when scheduled. An internal process, called the
_pipeline schedule worker_
, queues all the scheduled pipelines, but does not
run continuously. The worker runs on its own schedule, and scheduled pipelines that
are ready to start are only queued the next time the worker runs. Scheduled pipelines
can't run more frequently than the worker.
For example, only two pipelines are created per day if:
The default frequency of the pipeline schedule worker is
`3-59/10 * * * *`
(every ten minutes,
starting with
`0:03`
,
`0:13`
,
`0:23`
, and so on). The default frequency for GitLab.com
is listed in the
[
GitLab.com settings
](
../../user/gitlab_com/index.md#gitlab-cicd
)
.
-
You set a schedule to create a pipeline every minute (
`* * * * *`
).
To change the frequency of the pipeline schedule worker:
-
The Sidekiq worker runs on 00:00 and 12:00 every day (
`0 */12 * * *`
).
To change the Sidekiq worker's frequency:
1.
Edit the
`gitlab_rails['pipeline_schedule_worker_cron']`
value in your instance's
`gitlab.rb`
file.
1.
Edit the
`gitlab_rails['pipeline_schedule_worker_cron']`
value in your instance's
`gitlab.rb`
file.
1.
[
Reconfigure GitLab
](
../../administration/restart_gitlab.md#omnibus-gitlab-reconfigure
)
for the changes to take effect.
1.
[
Reconfigure GitLab
](
../../administration/restart_gitlab.md#omnibus-gitlab-reconfigure
)
for the changes to take effect.
For GitLab.com, refer to the
[
dedicated settings page
](
../../user/gitlab_com/index.md#gitlab-cicd
)
.
For example, to set the maximum frequency of pipelines to twice a day, set
`pipeline_schedule_worker_cron`
to a cron value of
`0 */12 * * *`
(
`00:00`
and
`12:00`
every day).
## Working with scheduled pipelines
## Working with scheduled pipelines
...
...
doc/topics/cron/index.md
View file @
8d0be1f3
...
@@ -9,7 +9,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
...
@@ -9,7 +9,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
Cron syntax is used to schedule when jobs should run.
Cron syntax is used to schedule when jobs should run.
You may need to use a cron syntax string to
You may need to use a cron syntax string to
create a
[
pipeline schedule
](
../../
api/pipeline_schedules.md#create-a-new-pipeline-schedule
)
,
create a
[
pipeline schedule
](
../../
ci/pipelines/schedules.md
)
,
or to prevent unintentional releases by setting a
or to prevent unintentional releases by setting a
[
deploy freeze
](
../../user/project/releases/index.md#prevent-unintentional-releases-by-setting-a-deploy-freeze
)
.
[
deploy freeze
](
../../user/project/releases/index.md#prevent-unintentional-releases-by-setting-a-deploy-freeze
)
.
...
...
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