diff --git a/website/source/docs/upgrade/upgrade-specific.html.md b/website/source/docs/upgrade/upgrade-specific.html.md index 2f2ff2632..0274915c0 100644 --- a/website/source/docs/upgrade/upgrade-specific.html.md +++ b/website/source/docs/upgrade/upgrade-specific.html.md @@ -25,8 +25,24 @@ images to load, in 0.5.5 it has been changed to a single string. No functionality was changed. Even if more than one item was specificed prior to 0.5.5 only the first item was used. -If you have jobs that use the `load` option first upgrade all nodes to 0.5.5, -then resubmit those jobs with `load` as a single string. +To do a zero-downtime deploy with jobs that use the `load` option: + +* Upgrade servers to version 0.5.5 or later. + +* Deploy new client nodes on the same version as the servers. + +* Resubmit jobs with the `load` option fixed and a constraint to only run on + version 0.5.5 or later: + +```hcl + constraint { + attribute = "nomad.version" + operator = "version" + value = ">= 0.5.5" + } +``` + +* Drain and shutdown old client nodes. ### Validation changes