open-nomad/website/source/docs/job-specification/update.html.md

layout	page_title	sidebar_current	description
docs	update Stanza - Job Specification	docs-job-specification-update	The "update" stanza specifies the job update strategy. The update strategy is used to control things like rolling upgrades. If omitted, rolling updates are disabled.

update Stanza

Placement	job -> **update**

The update stanza specifies the job update strategy. The update strategy is used to control things like rolling upgrades. If omitted, rolling updates are disabled.

job "docs" {
  update {
    max_parallel = 3
    stagger      = "30s"
  }
}

update Parameters

• max_parallel (int: 0) - Specifies the number of task groups that can be updated at the same time.

• stagger (string: "0ms") - Specifies the delay between sets of updates. This is specified using a label suffix like "30s" or "1h".

update Examples

The following examples only show the update stanzas. Remember that the update stanza is only valid in the placements listed above.

Serial Upgrades

This example uses a serial upgrade strategy, meaning exactly one task group will be updated at a time, waiting 60 seconds until the next task group is upgraded.

update {
  max_parallel = 1
  stagger      = "60s"
}

Parallel Upgrades

This example performs 10 upgrades at a time, waiting 30 seconds before moving on to the next batch:

update {
  max_parallel = 10
  stagger      = "30s"
}