add cpu provisioning docs (coder#430)

ericpaulsen · Katie Horne · web-flow · commit 11e17aa009fa · 2021-06-24T10:21:34.000-05:00
* add cpu provisioning docs

* lint

* Edit text and add screenshot

* Update example

Co-authored-by: Katie Horne &lt;katie@coder.com&gt;
diff --git a/admin/workspace-management/cpu-provisioning.md b/admin/workspace-management/cpu-provisioning.md
@@ -0,0 +1,24 @@
+---
+title: CPU provisioning
+description: Learn how to set the CPU provisioning
+ratio.
+---
+
+Coder allows you to set the CPU provisioning ratio for each of your
+organizations. The CPU provisioning ratio configures workspaces with a
+guaranteed minimum capacity, while enabling them to use available capacity for
+improved performance. The guaranteed minimum capacity is equivalent to the total
+CPUs provisioned for a workspace divided by the provisioning ratio.
+
+For example, let's say that you set a CPU provisioning ratio of 8:1. If a user
+creates a workspace with 4 CPUs, then Coder will reserve 0.5 CPUs on the
+underlying node, with a maximum limit of 4 CPUs.
+
+## Changing the CPU provisioning ratio
+
+1. Go to **Manage** > **Organizations** and select your organization.
+1. At the top of your organization page, click **Actions** > **Edit**. Scroll
+   down to **CPU Provisioning Rate** and set the maximum ratio.
+1. Click **Update**.
+
+![Set CPU provisioning ratios](../../assets/admin/cpu-provisioning-ratios.png)
diff --git a/admin/workspace-management/memory-overprovisioning.md b/admin/workspace-management/memory-overprovisioning.md
@@ -1,13 +1,13 @@
 ---
-title: "Memory overprovisioning"
-description: Learn how to overprovision memory requests from workspaces.
+title: "Memory provisioning"
+description: Learn how to provision memory requests from workspaces.
 ---
 
-Coder allows you to set memory overprovisioning ratios for each of your
+Coder allows you to set memory provisioning ratios for each of your
 organizations. By changing this ratio, you can change the number of workspaces
 that fit onto a single Kubernetes node.
 
-## Step 1: Enabling memory overprovisioning
+## Step 1: Enabling memory provisioning
 
 A site admin/manager must complete these steps:
 
diff --git a/assets/admin/cpu-provisioning-ratios.png b/assets/admin/cpu-provisioning-ratios.png
diff --git a/manifest.json b/manifest.json
@@ -196,6 +196,9 @@
             {
               "path": "./admin/workspace-management/memory-overprovisioning.md"
             },
+            {
+              "path": "./admin/workspace-management/cpu-provisioning.md"
+            },
             {
               "path": "./admin/workspace-management/shutdown.md"
             },

Original file line number	Diff line number	Diff line change
`@@ -196,6 +196,9 @@`
`196`	`196`	`{`
`197`	`197`	`"path": "./admin/workspace-management/memory-overprovisioning.md"`
`198`	`198`	`},`
	`199`	`+ {`
	`200`	`+ "path": "./admin/workspace-management/cpu-provisioning.md"`
	`201`	`+ },`
`199`	`202`	`{`
`200`	`203`	`"path": "./admin/workspace-management/shutdown.md"`
`201`	`204`	`},`