2016-06-13 22:57:19 -04:00
|
|
|
# swarm update
|
|
|
|
|
2023-01-06 13:04:05 -05:00
|
|
|
<!---MARKER_GEN_START-->
|
2016-07-20 14:15:08 -04:00
|
|
|
Update the swarm
|
2016-07-07 14:43:18 -04:00
|
|
|
|
2023-01-06 13:04:05 -05:00
|
|
|
### Options
|
|
|
|
|
|
|
|
| Name | Type | Default | Description |
|
|
|
|
|:-------------------------|:--------------|:------------|:------------------------------------------------------------|
|
2024-07-03 02:29:57 -04:00
|
|
|
| `--autolock` | `bool` | | Change manager autolocking setting (true\|false) |
|
2023-01-06 13:04:05 -05:00
|
|
|
| `--cert-expiry` | `duration` | `2160h0m0s` | Validity period for node certificates (ns\|us\|ms\|s\|m\|h) |
|
|
|
|
| `--dispatcher-heartbeat` | `duration` | `5s` | Dispatcher heartbeat period (ns\|us\|ms\|s\|m\|h) |
|
|
|
|
| `--external-ca` | `external-ca` | | Specifications of one or more certificate signing endpoints |
|
|
|
|
| `--max-snapshots` | `uint64` | `0` | Number of additional Raft snapshots to retain |
|
|
|
|
| `--snapshot-interval` | `uint64` | `10000` | Number of log entries between Raft snapshots |
|
|
|
|
| `--task-history-limit` | `int64` | `5` | Task history retention limit |
|
|
|
|
|
|
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
2016-06-13 22:57:19 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Description
|
|
|
|
|
2018-12-23 06:27:52 -05:00
|
|
|
Updates a swarm with new parameter values.
|
|
|
|
|
2024-08-16 05:02:10 -04:00
|
|
|
> [!NOTE]
|
2020-04-19 11:08:37 -04:00
|
|
|
> This is a cluster management command, and must be executed on a swarm
|
|
|
|
> manager node. To learn about managers and workers, refer to the
|
|
|
|
> [Swarm mode section](https://docs.docker.com/engine/swarm/) in the
|
|
|
|
> documentation.
|
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
|
|
|
|
2021-08-21 08:54:14 -04:00
|
|
|
```console
|
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)
|
2020-04-19 09:43:08 -04: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)
|
2020-04-19 09:43:08 -04:00
|
|
|
* [swarm unlock-key](swarm_unlock-key.md)
|