From 3af57431a04d7f08350d59f324bcd573591aa7f2 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Wed, 21 Sep 2022 09:53:18 -0700 Subject: [PATCH 1/2] Remove misleading diagrams that suggest a cluster can or should have nodes in different regions --- .../rancher-deployment-strategy.md | 23 ++++++++----------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md b/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md index e3b03c4b21c..75800774b12 100644 --- a/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md +++ b/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md @@ -3,7 +3,7 @@ title: Rancher Deployment Strategy weight: 100 --- -There are two recommended deployment strategies for a Rancher server that manages downstream Kubernetes clusters. Each one has its own pros and cons. Read more about which one would fit best for your use case: +There are two recommended deployment strategies for a Rancher Manager server that manages downstream Kubernetes clusters. Each one has its own pros and cons. Read more about which one would fit best for your use case: * [Hub and Spoke](#hub-and-spoke-strategy) * [Regional](#regional-strategy) @@ -11,35 +11,30 @@ There are two recommended deployment strategies for a Rancher server that manage ## Hub & Spoke Strategy --- -In this deployment scenario, there is a single Rancher control plane managing Kubernetes clusters across the globe. The control plane would be run on a high-availability Kubernetes cluster, and there would be impact due to latencies. - -![](/img/bpg/hub-and-spoke.png) +In this deployment scenario, there is a single Rancher Manager instance managing Kubernetes clusters across the globe. The Rancher Manager would be run on a high-availability Kubernetes cluster, and there would be impact due to latencies. ### Pros -* Environments could have nodes and network connectivity across regions. * Single control plane interface to view/see all regions and environments. -* Kubernetes does not require Rancher to operate and can tolerate losing connectivity to the Rancher control plane. +* Kubernetes does not require Rancher to operate and can tolerate losing connectivity to the Rancher Manager instance. ### Cons * Subject to network latencies. -* If the control plane goes out, global provisioning of new services is unavailable until it is restored. However, each Kubernetes cluster can continue to be managed individually. +* If the Rancher Manager instance goes down, global provisioning of new services is unavailable until it is restored. However, each Kubernetes cluster can continue to be managed individually. ## Regional Strategy --- -In the regional deployment model a control plane is deployed in close proximity to the compute nodes. - -![](/img/bpg/regional.png) +In the regional deployment model a Rancher Manager instance is deployed in close proximity to the downstream Kubernetes clusters. ### Pros -* Rancher functionality in regions stay operational if a control plane in another region goes down. -* Network latency is greatly reduced, improving the performance of functionality in Rancher. -* Upgrades of the Rancher control plane can be done independently per region. +* Rancher functionality in regions stay operational if a Rancher Manager in another region goes down. +* Network latency between Rancher Manager and downstream clusters is greatly reduced, improving the performance of functionality in Rancher. +* Upgrades of Rancher Manager can be done independently per region. ### Cons * Overhead of managing multiple Rancher installations. -* Visibility across global Kubernetes clusters requires multiple interfaces/panes of glass. +* Visibility into Kubernetes clusters in different regions requires multiple interfaces/panes of glass. * Deploying multi-cluster apps in Rancher requires repeating the process for each Rancher server. From a0268ab8b47680fceb1f27a938253608de10e850 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Wed, 21 Sep 2022 21:59:35 -0700 Subject: [PATCH 2/2] Replace 'Rancher Manager' with 'Rancher instance' --- .../rancher-deployment-strategy.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md b/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md index 75800774b12..dea9e2ba34b 100644 --- a/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md +++ b/docs/reference-guides/best-practices/rancher-server/rancher-deployment-strategy.md @@ -3,7 +3,7 @@ title: Rancher Deployment Strategy weight: 100 --- -There are two recommended deployment strategies for a Rancher Manager server that manages downstream Kubernetes clusters. Each one has its own pros and cons. Read more about which one would fit best for your use case: +There are two recommended deployment strategies for a Rancher instance that manages downstream Kubernetes clusters. Each one has its own pros and cons. Read more about which one would fit best for your use case: * [Hub and Spoke](#hub-and-spoke-strategy) * [Regional](#regional-strategy) @@ -11,27 +11,27 @@ There are two recommended deployment strategies for a Rancher Manager server tha ## Hub & Spoke Strategy --- -In this deployment scenario, there is a single Rancher Manager instance managing Kubernetes clusters across the globe. The Rancher Manager would be run on a high-availability Kubernetes cluster, and there would be impact due to latencies. +In this deployment scenario, there is a single Rancher instance managing Kubernetes clusters across the globe. The Rancher instance would be run on a high-availability Kubernetes cluster, and there would be impact due to latencies. ### Pros * Single control plane interface to view/see all regions and environments. -* Kubernetes does not require Rancher to operate and can tolerate losing connectivity to the Rancher Manager instance. +* Kubernetes does not require Rancher to operate and can tolerate losing connectivity to the Rancher instance. ### Cons * Subject to network latencies. -* If the Rancher Manager instance goes down, global provisioning of new services is unavailable until it is restored. However, each Kubernetes cluster can continue to be managed individually. +* If Rancher goes down, global provisioning of new services is unavailable until it is restored. However, each Kubernetes cluster can continue to be managed individually. ## Regional Strategy --- -In the regional deployment model a Rancher Manager instance is deployed in close proximity to the downstream Kubernetes clusters. +In the regional deployment model a Rancher instance is deployed in close proximity to the downstream Kubernetes clusters. ### Pros -* Rancher functionality in regions stay operational if a Rancher Manager in another region goes down. -* Network latency between Rancher Manager and downstream clusters is greatly reduced, improving the performance of functionality in Rancher. -* Upgrades of Rancher Manager can be done independently per region. +* Rancher functionality in regions stay operational if a Rancher instance in another region goes down. +* Network latency between Rancher and downstream clusters is greatly reduced, improving the performance of functionality in Rancher. +* Upgrades of Rancher can be done independently per region. ### Cons