From a099c85db5c457d05cf0e02b459bc45244f0c023 Mon Sep 17 00:00:00 2001 From: Xuan Luo Date: Mon, 10 Jan 2022 15:30:01 -0800 Subject: [PATCH 1/3] docs: added gateway overview illustration --- .../svgs/consul_gateway_overview.svg | 321 ++++++++++++++++++ 1 file changed, 321 insertions(+) create mode 100644 website/public/img/consul-connect/svgs/consul_gateway_overview.svg diff --git a/website/public/img/consul-connect/svgs/consul_gateway_overview.svg b/website/public/img/consul-connect/svgs/consul_gateway_overview.svg new file mode 100644 index 0000000000..f0d4f868ce --- /dev/null +++ b/website/public/img/consul-connect/svgs/consul_gateway_overview.svg @@ -0,0 +1,321 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From b5a046f5b0288b8db246e46dbe2b78e577ffb528 Mon Sep 17 00:00:00 2001 From: Xuan Luo Date: Mon, 10 Jan 2022 15:47:57 -0800 Subject: [PATCH 2/3] docs: add gateway overview illustration --- website/content/docs/connect/gateways/index.mdx | 12 +++++++----- .../consul-connect/svgs/consul_gateway_overview.svg | 12 ++++++------ 2 files changed, 13 insertions(+), 11 deletions(-) diff --git a/website/content/docs/connect/gateways/index.mdx b/website/content/docs/connect/gateways/index.mdx index dafdcb092e..b08bd4dcae 100644 --- a/website/content/docs/connect/gateways/index.mdx +++ b/website/content/docs/connect/gateways/index.mdx @@ -13,21 +13,23 @@ This topic provides an overview of the gateway features shipped with Consul. Gat - [Ingress gateways](#ingress-gateways) enable services to accept traffic from outside the Consul service mesh. - [Terminating gateways](#terminating-gateways) enable you to route traffic from services in the Consul service mesh to external services. +![Gateway Architecture](/img/consul-connect/svgs/consul_gateway_overview.svg) + ## Mesh Gateways -> **1.6.0+:** This feature is available in Consul versions 1.6.0 and newer. Mesh gateways enable service mesh traffic to be routed between different Consul datacenters and admin partitions. The datacenters or partitions can reside in different clouds or runtime environments where general interconnectivity between all services in all datacenters -isn't feasible. +isn't feasible. They operate by sniffing and extracting the server name indication (SNI) header from the service mesh session and routing the connection to the appropriate destination based on the server name requested. The gateway does not decrypt the data within the mTLS session. -Mesh gateways enable the following scenarios: +Mesh gateways enable the following scenarios: -* **Federate multiple datacenters across a WAN**. Since Consul 1.8.0, mesh gateways can forward gossip and RPC traffic between Consul servers. See [WAN federation via mesh gateways](/docs/connect/gateways/wan-federation-via-mesh-gateways) for additional information. -* **Service-to-service communication across datacenters**. Refer to [Enabling Service-to-service Traffic Accross Datacenters](/docs/connect/gateways/mesh-gateway/service-to-service-traffic-datacenters) for additional information. -* **Service-to-service communication across admin partitions**. Since Consul 1.11.0, you can create administrative boundaries for single Consul deployements called "admin partitions". You can use mesh gateways to facilitate cross-partition communication. Refer to [Enabling Service-to-service Traffic Accross Admin Partitions](/docs/connect/gateways/mesh-gateway/service-to-service-traffic-partitions) for additional information. +- **Federate multiple datacenters across a WAN**. Since Consul 1.8.0, mesh gateways can forward gossip and RPC traffic between Consul servers. See [WAN federation via mesh gateways](/docs/connect/gateways/wan-federation-via-mesh-gateways) for additional information. +- **Service-to-service communication across datacenters**. Refer to [Enabling Service-to-service Traffic Accross Datacenters](/docs/connect/gateways/mesh-gateway/service-to-service-traffic-datacenters) for additional information. +- **Service-to-service communication across admin partitions**. Since Consul 1.11.0, you can create administrative boundaries for single Consul deployements called "admin partitions". You can use mesh gateways to facilitate cross-partition communication. Refer to [Enabling Service-to-service Traffic Accross Admin Partitions](/docs/connect/gateways/mesh-gateway/service-to-service-traffic-partitions) for additional information. -> **Mesh gateway tutorial**: Follow the [mesh gateway tutorial](https://learn.hashicorp.com/tutorials/consul/service-mesh-gateways) to learn concepts associated with mesh gateways. diff --git a/website/public/img/consul-connect/svgs/consul_gateway_overview.svg b/website/public/img/consul-connect/svgs/consul_gateway_overview.svg index f0d4f868ce..f6db90f66f 100644 --- a/website/public/img/consul-connect/svgs/consul_gateway_overview.svg +++ b/website/public/img/consul-connect/svgs/consul_gateway_overview.svg @@ -106,16 +106,16 @@ - - - + + + - - - + + + From cf8c005194e6b1ad620a5e0394ef4864df58a982 Mon Sep 17 00:00:00 2001 From: Xuan Luo Date: Mon, 10 Jan 2022 16:29:32 -0800 Subject: [PATCH 3/3] updated image --- .../content/docs/connect/gateways/index.mdx | 2 +- .../svgs/consul_gateway_overview_wide.svg | 321 ++++++++++++++++++ 2 files changed, 322 insertions(+), 1 deletion(-) create mode 100644 website/public/img/consul-connect/svgs/consul_gateway_overview_wide.svg diff --git a/website/content/docs/connect/gateways/index.mdx b/website/content/docs/connect/gateways/index.mdx index b08bd4dcae..b12c100b9a 100644 --- a/website/content/docs/connect/gateways/index.mdx +++ b/website/content/docs/connect/gateways/index.mdx @@ -13,7 +13,7 @@ This topic provides an overview of the gateway features shipped with Consul. Gat - [Ingress gateways](#ingress-gateways) enable services to accept traffic from outside the Consul service mesh. - [Terminating gateways](#terminating-gateways) enable you to route traffic from services in the Consul service mesh to external services. -![Gateway Architecture](/img/consul-connect/svgs/consul_gateway_overview.svg) +[![Gateway Architecture](/img/consul-connect/svgs/consul_gateway_overview_wide.svg)](/img/consul-connect/svgs/consul_gateway_overview_wide.svg) ## Mesh Gateways diff --git a/website/public/img/consul-connect/svgs/consul_gateway_overview_wide.svg b/website/public/img/consul-connect/svgs/consul_gateway_overview_wide.svg new file mode 100644 index 0000000000..308caa3658 --- /dev/null +++ b/website/public/img/consul-connect/svgs/consul_gateway_overview_wide.svg @@ -0,0 +1,321 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +