Merge pull request #706 from thandayuthapani/master

Docs for task-order within Job
kubernetes-retired · Apr 14, 2019 · f2e5f1e · f2e5f1e
2 parents e76aad6 + 5e5e851
commit f2e5f1e
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 0 deletions.
diff --git a/doc/design/task-order.md b/doc/design/task-order.md
@@ -0,0 +1,23 @@
+# Task Priority within Job
+
+## Introduction
+
+When a workload is presented to kube-batch in the form of jobs or tasks,
+kube-batch prioritizes those job/tasks, so job/task with high priority is
+handled first.  In this doc, we will look into how Tasks within job are prioritized.
+
+## Implementation
+
+Task priority in kube-batch is done by using either of following data
+
+1. Task's Priority given in TaskSpec(i.e. PodSpec as defined in the YAML)
+2. Task's Creation time
+3. Task's UID
+
+![taskordering](../../doc/images/task_order.png)
+
+If priority plugin in kube-batch is loaded, then priority is decided using
+task's priority that will be provided in TaskSpec.
+Else it checks for creationTime of tasks.  Depending on which task has been created first,
+that task will be given high priority.  If creationTime is also same,
+then UID is compared and then priority is decided.
diff --git a/doc/images/task_order.png b/doc/images/task_order.png