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

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
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
Consul 1.1.0 and later this can be set to a
eventually be available. This option can be specified multiple times to
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)
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
@ -326,6 +327,11 @@ The options below are all specified on the command-line.
$ 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
As of Consul 0.9.1, `retry-join` accepts a unified interface using the