8ae3332165
- moved and renamed files/folders based on new structure - updated docs navigation based on new structure - moved CLI to top nav (created commands.jsx and commands-navigation.js) - updated and added redirects - updating to be consistent with standalone categories - changing "overview" link in top nav to lead to where intro was moved (docs/intro) - adding redirects for intro content - deleting old intro folders - format all data/navigation files - deleting old commands folder - reverting changes to glossary page - adjust intro navigation for removal of 'vs' paths - add helm page redirect - fix more redirects - add a missing redirect - fix broken anchor links and formatting mistakes - deleted duplicate section, added redirect, changed link - removed duplicate glossary page
41 lines
1.3 KiB
Plaintext
41 lines
1.3 KiB
Plaintext
---
|
|
layout: commands
|
|
page_title: 'Commands: Join'
|
|
sidebar_title: join
|
|
description: >-
|
|
The `join` command tells a Consul agent to join an existing cluster. A new
|
|
Consul agent may join any node in the existing cluster. After joining with one
|
|
member, the gossip communication will propagate 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 may join any node in the existing cluster. After joining
|
|
with one member, the gossip communication will propagate the updated membership
|
|
state across the cluster.
|
|
|
|
An agent which is already part of a cluster may join an agent in a different
|
|
cluster, causing the two clusters to be merged into 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.
|
|
|
|
#### API Options
|
|
|
|
@include 'http_api_options_client.mdx'
|
|
|
|
#### Command Options
|
|
|
|
- `-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.
|