chore: add usage notes re: single- and multi-zone EKS clusters (coder#645)

Katie Horne · web-flow · commit ada4e9b27836 · 2021-10-05T10:04:10.000-05:00
diff --git a/setup/kubernetes/aws.md b/setup/kubernetes/aws.md
@@ -36,6 +36,16 @@ EC2 instance from AWS'
 > [container-based virtual machines (CVMs)](../../workspaces/cvms.md) unless
 > you're running Coder in a bare-metal Kubernetes environment.
 
+### Single vs. multi-zone clusters
+
+In our experience, single-region, single-zone clusters work best for Coder.
+
+However, if you opt for a multi-zone cluster, your workspace pods can only be
+scheduled where you initially provisioned them. As such, make sure that there
+are nodes available in each zone. Please note, however, that if a zone becomes
+unavailable, the workspace pods will be unavailable because the persistent
+volumes are tied to the zone.
+
 ## Preliminary steps
 
 Before you can create a cluster, you'll need to perform the following to set up
