github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'b022a64f2a'
${ noResults }
consul/website/source/docs/commands/join.html.markdown

1.8 KiB
Raw Blame History

layout page_title sidebar_current description
docs Commands: Join docs-commands-join The `join` command tells a Consul agent to join an existing cluster. A new Consul agent must join with at least one existing member of a cluster in order to join an existing cluster. After joining that one member, the gossip layer takes over, propagating the updated membership state across the cluster.

Consul Join

Command: consul join

The join command tells a Consul agent to join an existing cluster. A new Consul agent must join with at least one existing member of a cluster in order to join an existing cluster. After joining that one member, the gossip layer takes over, propagating the updated membership state across the cluster.

If you don't join an existing cluster, then that agent is part of its own isolated cluster. Other nodes can join it.

Agents can join other agents multiple times without issue. If a node that is already part of a cluster joins another node, then the clusters of the two nodes join to become a single cluster.

Usage

Usage: consul join [options] address ...

You may call join with multiple addresses if you want to try to join multiple clusters. Consul will attempt to join all addresses, and the join command will fail only if Consul was unable to join with any.

The command-line flags are all optional. The list of available flags are:

  • -wan - For agents running in server mode, the agent will attempt to join other servers gossiping in a WAN cluster. This is used to form a bridge between multiple datacenters.

  • -rpc-addr - Address to the RPC server of the agent you want to contact to send this command. If this isn't specified, the command will contact "127.0.0.1:8400" which is the default RPC address of a Consul agent.