Add docs for nodeSelector and tolerations (#398)

Emyrk · web-flow · commit ac6205e8a270 · 2021-06-17T10:32:09.000-05:00
diff --git a/workspaces/workspaces-as-code/templates.md b/workspaces/workspaces-as-code/templates.md
@@ -152,6 +152,8 @@ labels:
     com.coder.custom.world: world
 ```
 
+`labels` is disabled by default and must be enabled by a site admin.
+
 #### workspace.specs.kubernetes.gpu-count.value
 
 The number of GPUs to allocate to the workspace.
@@ -173,6 +175,52 @@ Determines whether the workspace should be created as a
 
 **Required**. The amount of disk space (in GB) to allocate to the workspace.
 
+#### workspace.specs.kubernetes.tolerations.value
+
+Adds [Kubernetes
+tolerations](https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/)
+to the workspace pod.
+
+```yaml
+      tolerations:
+        value:
+          - key: example1
+            operator: Exists
+            value: value-1
+            effect: NoSchedule
+            tolerationSeconds: 200
+          - key: example-3
+            operator: Equal
+            value: value-2
+            effect: PreferNoSchedule
+            tolerationSeconds: 400
+          - key: example-3
+            value: value-3
+            effect: NoExecute
+ ```
+
+`tolerations` is disabled by default and must be enabled by a site admin.
+
+#### workspace.specs.kubernetes.node-selector.value
+
+Adds [Kubernetes
+NodeSelectors](https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#nodeselector)
+to the workspace pod. The value is a sequence of key/value pairs.
+
+For example, the following snippet would add two `nodeSelectors` for Kubernetes:
+`accelerator:nvidia` and `disktype:ssd`.
+
+```yaml
+      node-selector:
+        value:
+          - key: accelerator
+            value: nvidia
+          - key: disktype
+            value: ssd
+ ```
+
+`node-selector` is disabled by default and must be enabled by a site admin.
+
 #### workspace.configure
 
 This section lists the commands that run within the workspace after Coder builds
