Configuring Delayed Job Priorities
Page last updated:
This topic describes how operators can change the priority of delayed jobs in the Cloud Controller.
Cloud Foundry creates delayed jobs as it performs certain asynchronous actions, such as
DELETE v3/buildbacks/[GUID]. These jobs are
processed asynchronously by multiple worker processes.
By default, all jobs have the same priority of
0. Job priorities of higher numerical values are lower than job priorities of lower numerical values.
Conversely, job priorities of negative numerical values are higher than job priorities of positive numerical values. For example, the Cloud Controller
schedules a job with a priority of
-1 before a job with a priority of
0, and schedules a job with a priority of
1 before a job with a priority of
When a job fails, the Cloud Controller might reschedule the job and give it a lower priority, depending on how the job is configured. When the Cloud
Controller reschedules a failed job and gives it a lower priority, it doubles the priority each time the job fails: first from
1, then to
8, and so on. Each time a job receives a lower priority, the time until the Cloud Controller schedules its next run increases accordingly. In the
logs for some Cloud Controller components, this scheduled time appears in the
run_at column of the
When a job with a priority of negative numerical value fails multiple times, the Cloud Controller lowers its priority to
0, then doubles its priority
In the logs for some Cloud Controller components, you can view a jobs that have been delayed in the
The following list contains the
display_name of each job in the
delayed_jobs table that you can configure with a different default priority:
Overriding the Default Priority of a Job
You can override the default priority for the jobs listed in Delayed Jobs above by creating an operations file in YAML format that contains a list of job names and their new priorities.
The following example shows an operations file that gives the
space.apply_manifest job the highest priority and configures the
cloud_controller_ng job to
run it before any other job:
- type: replace path: /instance_groups/name=api/jobs/name=cloud_controller_ng/properties/cc/jobs?/priorities? value: space.apply_manifest: -10
For more information about operations files, see the BOSH documentation.Create a pull request or raise an issue on the source for this page in GitHub