github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Clarify -retry-join can be provided multiple times 

Update -retry-join documentation to explicitly state the option can be
specified multiple times. Add corresponding config example showing
multiple join addresses.
pull/6962/head
Blake Covarrubias 2019-12-16 12:20:04 -08:00 committed by Blake Covarrubias
parent 37dfe6d112
commit 87679a7a4f
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
website/source/docs/agent/options.html.md
View File

@ -303,8 +303,9 @@ The options below are all specified on the command-line.
* `-retry-join` - Similar to [`-join`](#_join) but allows retrying a join if the * `-retry-join` - Similar to [`-join`](#_join) but allows retrying a join if the
first attempt fails. This is useful for cases where you know the address will first attempt fails. This is useful for cases where you know the address will
eventually be available. The list can contain IPv4, IPv6, or DNS addresses. In eventually be available. This option can be specified multiple times to
Consul 1.1.0 and later this can be set to a specify multiple agents to join. The value can contain IPv4, IPv6, or DNS
addresses. In Consul 1.1.0 and later this can be set to a
[go-sockaddr](https://godoc.org/github.com/hashicorp/go-sockaddr/template) [go-sockaddr](https://godoc.org/github.com/hashicorp/go-sockaddr/template)
template. If Consul is running on the non-default Serf LAN port, this must be template. If Consul is running on the non-default Serf LAN port, this must be
specified as well. IPv6 must use the "bracketed" syntax. If multiple values specified as well. IPv6 must use the "bracketed" syntax. If multiple values
@ -326,6 +327,11 @@ The options below are all specified on the command-line.
$ consul agent -retry-join "[::1]:8301" $ consul agent -retry-join "[::1]:8301"
``` ```
```sh
# Using multiple addresses
$ consul agent -retry-join "consul.domain.internal" -retry-join "10.0.4.67"
```
### Cloud Auto-Joining ### Cloud Auto-Joining
As of Consul 0.9.1, `retry-join` accepts a unified interface using the As of Consul 0.9.1, `retry-join` accepts a unified interface using the