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 '6ff6f3b213'
${ noResults }
consul/website/source/docs/commands/leave.html.markdown

893 B
Raw Blame History

layout page_title sidebar_current
docs Commands: Leave docs-commands-leave

Consul Leave

Command: consul leave

The leave command triggers a graceful leave and shutdown of the agent.

This is used to ensure other nodes see the agent as "left" instead of "failed". Nodes that leave will not attempt to re-join the cluster on restarting with a snapshot.

For nodes in server mode, the node is removed from the Raft peer set in a graceful manner. This is critical, as in certain situations a non-graceful leave can affect cluster availability.

Usage

Usage: consul leave

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

  • -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.