aurora-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject aurora git commit: Adding oversubscription summary.
Date Mon, 21 Sep 2015 22:37:02 GMT
Repository: aurora
Updated Branches:
  refs/heads/master 9d780262d -> 88a6f249e

Adding oversubscription summary.

Bugs closed: AURORA-1441

Reviewed at


Branch: refs/heads/master
Commit: 88a6f249e31c31392cabf19c8691be1fd1c40cbb
Parents: 9d78026
Author: Maxim Khutornenko <>
Authored: Mon Sep 21 15:36:46 2015 -0700
Committer: Maxim Khutornenko <>
Committed: Mon Sep 21 15:36:46 2015 -0700

 docs/    | 17 +++++++++++++++++
 docs/ | 16 ++++++++++++++++
 2 files changed, 33 insertions(+)
diff --git a/docs/ b/docs/
index ad2701c..8d50c45 100644
--- a/docs/
+++ b/docs/
@@ -26,6 +26,7 @@ Aurora + Thermos Configuration Reference
 - [Job Schema](#job-schema)
     - [Job Objects](#job-objects)
     - [Services](#services)
+    - [Revocable Jobs](#revocable-jobs)
     - [UpdateConfig Objects](#updateconfig-objects)
     - [HealthCheckConfig Objects](#healthcheckconfig-objects)
     - [Announcer Objects](#announcer-objects)
@@ -328,6 +329,7 @@ Job Schema
   ```health_check_config``` | ```heath_check_config``` object | Parameters for controlling
a task's health checks via HTTP. Only used if a  health port was assigned with a command line
   ```container``` | ```Container``` object | An optional container to run all processes inside
   ```lifecycle``` | ```LifecycleConfig``` object | An optional task lifecycle configuration
that dictates commands to be executed on startup/teardown.  HTTP lifecycle is enabled by default
if the "health" port is requested.  See [LifecycleConfig Objects](#lifecycleconfig-objects)
for more information.
+  ```tier``` | String | Task tier type. When set to `revocable` requires the task to run
with Mesos revocable resources. This is work [in progress](
and is currently only supported for the revocable tasks. The ultimate goal is to simplify
task configuration by hiding various configuration knobs behind a task tier definition. See
AURORA-1343 and AURORA-1443 for more details.
 ### Services
@@ -339,6 +341,21 @@ Jobs without the service bit set only restart up to
 `max_task_failures` times and only if they terminated unsuccessfully
 either due to human error or machine failure.
+### Revocable Jobs
+**WARNING**: This feature is currently in alpha status. Do not use it in production clusters!
+Mesos [supports a concept of revocable tasks](
+by oversubscribing machine resources by the amount deemed safe to not affect the existing
+non-revocable tasks. Aurora now supports revocable jobs via a `tier` setting set to `revocable`
+More implementation details in this [ticket](
+Scheduler must be [configured](
+to receive revocable offers from Mesos and accept revocable jobs. If not configured properly
+revocable tasks will never get assigned to hosts and will stay in PENDING.
 ### UpdateConfig Objects
 Parameters for controlling the rate and policy of rolling updates.
diff --git a/docs/ b/docs/
index 8db0e61..2a46d2f 100644
--- a/docs/
+++ b/docs/
@@ -14,6 +14,7 @@ machines.  This guide helps you get the scheduler set up and troubleshoot
some c
   - [Network considerations](#network-considerations)
   - [Considerations for running jobs in docker](#considerations-for-running-jobs-in-docker)
   - [Security Considerations](#security-considerations)
+  - [Configuring Resource Oversubscription](#configuring-resource-oversubscription)
 - [Running Aurora](#running-aurora)
   - [Maintaining an Aurora Installation](#maintaining-an-aurora-installation)
   - [Monitoring](#monitoring)
@@ -190,6 +191,21 @@ assuming you set `-http_port=8081`.
 See [](
+## Configuring Resource Oversubscription
+**WARNING**: This feature is currently in alpha status. Do not use it in production clusters!
+See [this document]( for more feature details.
+Set these scheduler flag to allow receiving revocable Mesos offers:
+    -receive_revocable_resources=true
+Specify a tier configuration file path:
+    -tier_config=path/to/tiers/config.json
+Example [tier configuration file](../src/test/resources/org/apache/aurora/scheduler/tiers-example.json).
 ### Maintaining an Aurora Installation
 ### Monitoring

View raw message