2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
title: "swarm update"
|
|
|
|
description: "The swarm update command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "swarm, update"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
2016-06-13 22:57:19 -04:00
|
|
|
|
2016-10-19 13:25:45 -04:00
|
|
|
<!-- This file is maintained within the docker/docker Github
|
|
|
|
repository at https://github.com/docker/docker/. Make all
|
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
will be rejected.
|
|
|
|
-->
|
|
|
|
|
2016-06-13 22:57:19 -04:00
|
|
|
# swarm update
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
```markdown
|
|
|
|
Usage: docker swarm update [OPTIONS]
|
|
|
|
|
2016-07-20 14:15:08 -04:00
|
|
|
Update the swarm
|
2016-07-07 14:43:18 -04:00
|
|
|
|
|
|
|
Options:
|
2016-11-10 15:05:19 -05:00
|
|
|
--autolock Change manager autolocking setting (true|false)
|
2016-10-25 08:22:07 -04:00
|
|
|
--cert-expiry duration Validity period for node certificates (ns|us|ms|s|m|h) (default 2160h0m0s)
|
|
|
|
--dispatcher-heartbeat duration Dispatcher heartbeat period (ns|us|ms|s|m|h) (default 5s)
|
2016-12-11 07:25:40 -05:00
|
|
|
--external-ca external-ca Specifications of one or more certificate signing endpoints
|
2016-07-07 14:43:18 -04:00
|
|
|
--help Print usage
|
2016-12-11 07:25:40 -05:00
|
|
|
--max-snapshots uint Number of additional Raft snapshots to retain
|
|
|
|
--snapshot-interval uint Number of log entries between Raft snapshots (default 10000)
|
2016-07-24 05:13:06 -04:00
|
|
|
--task-history-limit int Task history retention limit (default 5)
|
2016-07-07 14:43:18 -04:00
|
|
|
```
|
2016-06-13 22:57:19 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Description
|
|
|
|
|
2016-07-25 19:24:32 -04:00
|
|
|
Updates a swarm with new parameter values. This command must target a manager node.
|
2016-06-13 22:57:19 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Examples
|
2016-06-13 22:57:19 -04:00
|
|
|
|
|
|
|
```bash
|
2016-08-05 19:51:07 -04:00
|
|
|
$ docker swarm update --cert-expiry 720h
|
2016-06-13 22:57:19 -04:00
|
|
|
```
|
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Related commands
|
2016-06-13 22:57:19 -04:00
|
|
|
|
2017-05-10 18:34:56 -04:00
|
|
|
* [swarm ca](swarm_ca.md)
|
2016-06-13 22:57:19 -04:00
|
|
|
* [swarm init](swarm_init.md)
|
|
|
|
* [swarm join](swarm_join.md)
|
2016-12-19 12:55:51 -05:00
|
|
|
* [swarm join-token](swarm_join_token.md)
|
2016-06-13 22:57:19 -04:00
|
|
|
* [swarm leave](swarm_leave.md)
|
2016-12-19 12:55:51 -05:00
|
|
|
* [swarm unlock](swarm_unlock.md)
|
|
|
|
* [swarm unlock-key](swarm_unlock_key.md)
|