Merge pull request #5779 from hashicorp/d-preemption-ent

Add Enterprise docs for Preemption
hashicorp · Jun 4, 2019 · de730a1 · de730a1
2 parents 50fc86a + 3e067bf
commit de730a1
Show file tree

Hide file tree

Showing 3 changed files with 34 additions and 0 deletions.
diff --git a/website/source/docs/enterprise/index.html.md b/website/source/docs/enterprise/index.html.md
@@ -14,13 +14,16 @@ operational, and governance capabilities to Nomad. Namespaces allow multiple
 teams to safely use a shared multi-region deployment. With Resource Quotas, 
 operators can limit resource consumption across teams or projects. Sentinel 
 policies enable enforcement of arbitrary fine-grained policies on job submission. 
+Preemption capabilities enable the scheduler to temporarily evict lower priority 
+allocations for service and batch jobs so that higher priority allocations can be placed.
 Advanced Autopilot capabilities enable automated server upgrades, enhanced scalability 
 for reads and scheduling, and hot server failover on a per availability zone basis. See the 
 links below for a detailed overview of each feature.
 
 - [Namespaces](/docs/enterprise/namespaces/index.html)
 - [Resource Quotas](/docs/enterprise/quotas/index.html)
 - [Sentinel Policies](/docs/enterprise/sentinel/index.html)
+- [Preemption](/docs/enterprise/preemption/index.html)
 - [Advanced Autopilot](/docs/enterprise/autopilot/index.html)
 
 Click [here](https://www.hashicorp.com/go/nomad-enterprise) to set up a demo or request a trial 

diff --git a/website/source/docs/enterprise/preemption/index.html.md b/website/source/docs/enterprise/preemption/index.html.md
@@ -0,0 +1,28 @@
+---
+layout: "docs"
+page_title: "Nomad Enterprise Preemption"
+sidebar_current: "docs-enterprise-preemption"
+description: |-
+  Nomad Enterprise preemption capabilities enable the scheduler to temporarily
+  evict lower priority allocations for service and batch jobs so that
+  higher priority allocations can be placed. 
+---
+
+# Nomad Enterprise Preemption
+
+When a Nomad cluster is at capacity for a given set of placement constraints, any allocations 
+that result from a newly scheduled service or batch job will remain in the pending state until 
+sufficient resources become available - regardless of the defined priority.
+
+[Preemption](/docs/internals/scheduling/preemption.html) capabilities in 
+[Nomad Enterprise](https://www.hashicorp.com/go/nomad-enterprise) enable the scheduler to temporarily 
+evict lower [priority](/docs/job-specification/job.html#priority) allocations from service and 
+batch jobs so that the allocations from higher priority jobs can be placed. This behavior 
+ensures that critical workloads can run when resources are limited or when partial outages require 
+workloads to be rescheduled across a smaller set of client nodes.
+
+See the [Preemption internals documentation](/docs/internals/scheduling/preemption.html) for a 
+more detailed overview. Preemption for service and batch jobs can be enabled using the [scheduler config API endpoint](/api/operator.html#update-scheduler-configuration).
+
+Click [here](https://www.hashicorp.com/go/nomad-enterprise) to set up a demo or 
+request a trial of Nomad Enterprise.
diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb
@@ -530,6 +530,9 @@
           <li<%= sidebar_current("docs-enterprise-sentinel") %>>
             <a href="/docs/enterprise/sentinel/index.html">Sentinel Policies</a>
           </li>
+          <li<%= sidebar_current("docs-enterprise-preemption") %>>
+            <a href="/docs/enterprise/preemption/index.html">Preemption</a>
+          </li>
           <li<%= sidebar_current("docs-enterprise-autopilot") %>>
             <a href="/docs/enterprise/autopilot/index.html">Advanced Autopilot</a>
           </li>