From a8fea65f9f1d54c72ba8cda6b4d3fd0a88dcd4bf Mon Sep 17 00:00:00 2001 From: boruszak Date: Mon, 8 Aug 2022 15:34:28 -0500 Subject: [PATCH] Add peering connection UI iinitial commit. --- .../cluster-peering/create-manage-peering.mdx | 20 +++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/website/content/docs/connect/cluster-peering/create-manage-peering.mdx b/website/content/docs/connect/cluster-peering/create-manage-peering.mdx index 77e483e68..1240603b9 100644 --- a/website/content/docs/connect/cluster-peering/create-manage-peering.mdx +++ b/website/content/docs/connect/cluster-peering/create-manage-peering.mdx @@ -22,16 +22,14 @@ Then, complete the following steps in order: 1. Export services between clusters 1. Authorize services for peers -### Enable peering on all Consul servers - -Cluster peering is not enabled by default. To enable cluster peering, - ### Create a peering token -You can generate peering tokens and initiate connections on any available agent using either the Consul UI or the API. If you use the API, we recommend performing these operations through a client agent in the partition you want to connect. - To begin the cluster peering process, generate a peering token in one of your clusters. The other cluster uses this token to establish the peering connection. +Everytime you generate a peering token, a single-use establishment secret is embedded in the token. Because regenerating a peering token invalidates the previously generated secret, you must use the most recently created token to establish peering connections. + +You can generate peering tokens and initiate connections on any available agent using either the Consul UI or the API. If you use the API, we recommend performing these operations through a client agent in the partition you want to connect. + In `cluster-01`, issue a request for a peering token. @@ -58,6 +56,16 @@ Create a JSON file that contains the first cluster's name and the peering token. +1. In the Consul UI associated with `cluster-01`, click **Peers**. +1. Click **Add peer connection**. +1. In the **Name of peer** field, enter `cluster-02`. Then, click **Generate token**. +1. Copy the token. Be careful not to lose the token, as you cannot view the token again after leaving this screen. +1. Switch to the UI associated with `cluster 02`. Then, click **Peers** and then **Add peer connection**. +1. Click **Establish peering**. +1. In the **Name of peer** field, enter `cluster-01`. Then paste the token in the **Token** field. +1. Click **Add peer**. + +The