From 87679a7a4fdeae9da8ed18924dc5366e117f15fb Mon Sep 17 00:00:00 2001 From: Blake Covarrubias Date: Mon, 16 Dec 2019 12:20:04 -0800 Subject: [PATCH] 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. --- website/source/docs/agent/options.html.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/website/source/docs/agent/options.html.md b/website/source/docs/agent/options.html.md index ca13ad4f3f..0c3228a073 100644 --- a/website/source/docs/agent/options.html.md +++ b/website/source/docs/agent/options.html.md @@ -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