From 6bf76cf735ea3d5d96cf6e8c8ff900df7cec8518 Mon Sep 17 00:00:00 2001 From: David Nuzik Date: Fri, 8 Nov 2019 10:28:24 -0700 Subject: [PATCH 1/3] Improve ha install guide This adds an image representing a recommended configuration for HA k3s This includes some context around the image Later, we will tweak the HA page again before release to make some tweaks in a separate PR. --- .../k3s/latest/en/installation/ha/_index.md | 6 + static/img/k3s/k3s-production-setup-v3.svg | 1790 +++++++++++++++++ 2 files changed, 1796 insertions(+) create mode 100644 static/img/k3s/k3s-production-setup-v3.svg diff --git a/content/k3s/latest/en/installation/ha/_index.md b/content/k3s/latest/en/installation/ha/_index.md index 0e700cdd6ac..f7d119f3ee2 100644 --- a/content/k3s/latest/en/installation/ha/_index.md +++ b/content/k3s/latest/en/installation/ha/_index.md @@ -8,6 +8,12 @@ weight: 30 For production environments, we recommend installing k3s in a high-availability configuration so that you can always access your cluster. This procedure walks you through setting up a 2-node cluster with k3s with an external PostgreSQL database. As of v0.10.0 release (Experimental HA) we are supporting PostgreSQL 10.7-R1 thru 11.5-R1 +# Recommended Architecture +![k3s HA]({{< baseurl >}}/img/k3s/k3s-production-setup-v3.svg) +This image depicts a k3s HA install with load balancer to expose workloads and a load balancer for worker (agent) node registration and Kubernetes API access (e.g. kubectl). + +The HA database shown should be a single endpoint k3s can access such as a load balancer. The worker registration / kubernetes API load balancer is needed if the master nodepool will be auto scaling and thus master nodes are ephemeral. Port 6443 is used for worker (agent) node registration and the Kubernetes API. + Installation Outline -------------------- 1. Create backend database (PostgreSQL) diff --git a/static/img/k3s/k3s-production-setup-v3.svg b/static/img/k3s/k3s-production-setup-v3.svg new file mode 100644 index 00000000000..cbaa695858c --- /dev/null +++ b/static/img/k3s/k3s-production-setup-v3.svg @@ -0,0 +1,1790 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From 5409ebd8d0e7bd76d93033ab46258380cb56c59f Mon Sep 17 00:00:00 2001 From: David Nuzik Date: Fri, 8 Nov 2019 14:25:47 -0700 Subject: [PATCH 2/3] Update image subtext wording to resolve requested changes --- content/k3s/latest/en/installation/ha/_index.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/content/k3s/latest/en/installation/ha/_index.md b/content/k3s/latest/en/installation/ha/_index.md index f7d119f3ee2..8058fb77a7d 100644 --- a/content/k3s/latest/en/installation/ha/_index.md +++ b/content/k3s/latest/en/installation/ha/_index.md @@ -10,7 +10,10 @@ For production environments, we recommend installing k3s in a high-availability # Recommended Architecture ![k3s HA]({{< baseurl >}}/img/k3s/k3s-production-setup-v3.svg) -This image depicts a k3s HA install with load balancer to expose workloads and a load balancer for worker (agent) node registration and Kubernetes API access (e.g. kubectl). +This image depicts a k3s HA install with two load balancers: + +* A load balancer to expose workloads to external traffic +* A load balancer to expose the Kubernetes API for worker node registration and admin access via `kubectl` The HA database shown should be a single endpoint k3s can access such as a load balancer. The worker registration / kubernetes API load balancer is needed if the master nodepool will be auto scaling and thus master nodes are ephemeral. Port 6443 is used for worker (agent) node registration and the Kubernetes API. From b75e96b0330ba12ced713acffb0d1490ca10b0e2 Mon Sep 17 00:00:00 2001 From: David Nuzik Date: Fri, 8 Nov 2019 15:05:48 -0700 Subject: [PATCH 3/3] Update HA image --- .../k3s/latest/en/installation/ha/_index.md | 2 +- static/img/k3s/k3s-production-setup-v3.svg | 1790 ----------------- static/img/k3s/k3s-production-setup-v4.svg | 1 + 3 files changed, 2 insertions(+), 1791 deletions(-) delete mode 100644 static/img/k3s/k3s-production-setup-v3.svg create mode 100644 static/img/k3s/k3s-production-setup-v4.svg diff --git a/content/k3s/latest/en/installation/ha/_index.md b/content/k3s/latest/en/installation/ha/_index.md index 8058fb77a7d..73f4a3676cc 100644 --- a/content/k3s/latest/en/installation/ha/_index.md +++ b/content/k3s/latest/en/installation/ha/_index.md @@ -9,7 +9,7 @@ weight: 30 For production environments, we recommend installing k3s in a high-availability configuration so that you can always access your cluster. This procedure walks you through setting up a 2-node cluster with k3s with an external PostgreSQL database. As of v0.10.0 release (Experimental HA) we are supporting PostgreSQL 10.7-R1 thru 11.5-R1 # Recommended Architecture -![k3s HA]({{< baseurl >}}/img/k3s/k3s-production-setup-v3.svg) +![k3s HA]({{< baseurl >}}/img/k3s/k3s-production-setup-v4.svg) This image depicts a k3s HA install with two load balancers: * A load balancer to expose workloads to external traffic diff --git a/static/img/k3s/k3s-production-setup-v3.svg b/static/img/k3s/k3s-production-setup-v3.svg deleted file mode 100644 index cbaa695858c..00000000000 --- a/static/img/k3s/k3s-production-setup-v3.svg +++ /dev/null @@ -1,1790 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/static/img/k3s/k3s-production-setup-v4.svg b/static/img/k3s/k3s-production-setup-v4.svg new file mode 100644 index 00000000000..c2fa54c57d7 --- /dev/null +++ b/static/img/k3s/k3s-production-setup-v4.svg @@ -0,0 +1 @@ +k3s-production-setup-v2 \ No newline at end of file