2022-08-31 16:58:41 +00:00
|
|
|
---
|
|
|
|
layout: commands
|
|
|
|
page_title: 'Commands: Peering'
|
2023-01-26 18:42:13 +00:00
|
|
|
description: |
|
|
|
|
The `consul peering` command interacts cluster peering connections. It exposes top-level commands to generate peering tokens. establish connections, and manage connections.
|
2022-08-31 16:58:41 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# Consul Peering
|
|
|
|
|
|
|
|
Command: `consul peering`
|
|
|
|
|
|
|
|
Use the `peering` command to create and manage peering connections between Consul clusters, including token generation and consumption. Refer to
|
2023-01-25 16:52:43 +00:00
|
|
|
[Create and Manage Peerings Connections](/consul/docs/connect/cluster-peering/create-manage-peering) for an
|
2022-08-31 16:58:41 +00:00
|
|
|
overview of the CLI workflow for cluster peering.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
```text
|
|
|
|
Usage: consul peering <subcommand> [options]
|
|
|
|
|
|
|
|
# ...
|
|
|
|
|
|
|
|
Subcommands:
|
|
|
|
|
2023-12-07 07:25:15 +00:00
|
|
|
delete Close and delete a peering connection
|
|
|
|
establish Consume a peering token and establish a connection with the accepting cluster
|
|
|
|
exported-services Lists the services exported to the peer
|
|
|
|
generate-token Generate a peering token for use by a dialing cluster
|
|
|
|
list List the local cluster's peering connections
|
|
|
|
read Read detailed information on a peering connection
|
2022-08-31 16:58:41 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
For more information, examples, and usage about a subcommand, click on the name
|
|
|
|
of the subcommand in the sidebar or one of the links below:
|
|
|
|
|
2023-01-25 16:52:43 +00:00
|
|
|
- [delete](/consul/commands/peering/delete)
|
|
|
|
- [establish](/consul/commands/peering/establish)
|
|
|
|
- [generate-token](/consul/commands/peering/generate-token)
|
|
|
|
- [list](/consul/commands/peering/list)
|
2023-12-07 07:25:15 +00:00
|
|
|
- [read](/consul/commands/peering/read)
|
|
|
|
- [exported-services](/consul/commands/peering/exported-services)
|