add plumbing for gke doc

bpmct · bpmct · commit 1cf65aa28432 · 2022-11-30T23:05:13.000Z
diff --git a/docs/admin/scale/docker.md b/docs/admin/scale/docker.md
diff --git a/docs/admin/scale/gke.md b/docs/admin/scale/gke.md
@@ -0,0 +1,50 @@
+# Scaling Coder on Google Kubernetes Engine (GKE)
+
+This is a reference architecture for Coder on [Google Kubernetes Engine](#). We regurily load test these environments with a standard [kubernetes example](https://github.com/coder/coder/tree/main/examples/templates/kubernetes) template.
+
+> Performance and ideal node sizing depends on many factors, including workspace image and the [workspace sizes](https://github.com/coder/coder/issues/3519) you wish to give developers. Use Coder's [scale testing utility](./index.md#scale-testing-utility) to test your own deployment.
+
+## 50 users
+
+### Cluster configuration
+
+- **Autoscaling profile**: `optimize-utilization`
+
+- **Node pools**
+  - Default
+    - **Operating system**: `Ubuntu with containerd`
+    - **Instance type**: `e2-highcpu-8`
+    - **Min nodes**: `1`
+    - **Max nodes**: `4`
+
+### Coder settings
+
+- **Replica count**: `1`
+- **Provisioner daemons**: `30`
+- **Template**: [kubernetes example](https://github.com/coder/coder/tree/main/examples/templates/kubernetes)
+
+## 100 users
+
+For deployments with 100+ users, we recommend running the Coder server in a separate node pool via taints, tolerations, and nodeselectors.
+
+### Cluster configuration
+
+- **Node pools**
+  - Coder server
+    - **Instance type**: `e2-highcpu-4`
+    - **Operating system**: `Ubuntu with containerd`
+    - **Autoscaling profile**: `optimize-utilization`
+    - **Min nodes**: `2`
+    - **Max nodes**: `4`
+  - Workspaces
+    - **Instance type**: `e2-highcpu-16`
+    - **Node**: `Ubuntu with containerd`
+    - **Autoscaling profile**: `optimize-utilization`
+    - **Min nodes**: `3`
+    - **Max nodes**: `10`
+
+### Coder settings
+
+- **Replica count**: `4`
+- **Provisioner daemons**: `25`
+- **Template**: [kubernetes example](https://github.com/coder/coder/tree/main/examples/templates/kubernetes)
diff --git a/docs/admin/scale/index.md b/docs/admin/scale/index.md
@@ -2,12 +2,12 @@ We regularly scale-test Coder against various reference architectures. Additiona
 
 ## Reference Architectures
 
-| Environment                               | Users | Workspaces | Last tested  | Status   |
-| ----------------------------------------- | ----- | ---------- | ------------ | -------- |
-| [Google Kubernetes Engine (GKE)](#)       | 100   | 200        | Nov 29, 2022 | Complete |
-| [AWS Elastic Kubernetes Service (EKS)](#) | 100   | 200        | Nov 29, 2022 | Complete |
-| [Google Compute Engine + Docker](#)       | 1000  | 200        | Nov 29, 2022 | Complete |
-| [Google Compute Engine + VMs](#)          | 1000  | 200        | Nov 29, 2022 | Complete |
+| Environment                                       | Users         | Last tested  | Status   |
+| ------------------------------------------------- | ------------- | ------------ | -------- |
+| [Google Kubernetes Engine (GKE)](./gke.md)        | 50, 100, 1000 | Nov 29, 2022 | Complete |
+| [AWS Elastic Kubernetes Service (EKS)](./eks.md)  | 50, 100, 1000 | Nov 29, 2022 | Complete |
+| [Google Compute Engine + Docker](./gce-docker.md) | 15, 50        | Nov 29, 2022 | Complete |
+| [Google Compute Engine + VMs](./gce-vms.md)       | 1000          | Nov 29, 2022 | Complete |
 
 ## Scale testing utility
 
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -257,7 +257,14 @@
           "title": "Scaling Coder",
           "description": "Reference architecture and load testing tools",
           "icon_path": "./images/icons/scale.svg",
-          "path": "./admin/scale/index.md"
+          "path": "./admin/scale/index.md",
+          "children": [
+            {
+              "title": "GKE",
+              "description": "Learn how to scale Coder on GKE",
+              "path": "./admin/scale/gke.md"
+            }
+          ]
         },
         {
           "title": "Audit Logs",
