Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id AF191200B76 for ; Tue, 30 Aug 2016 21:34:49 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id ADAD6160ABA; Tue, 30 Aug 2016 19:34:49 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 00B39160AAF for ; Tue, 30 Aug 2016 21:34:48 +0200 (CEST) Received: (qmail 92911 invoked by uid 500); 30 Aug 2016 19:34:48 -0000 Mailing-List: contact commits-help@aurora.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@aurora.apache.org Delivered-To: mailing list commits@aurora.apache.org Received: (qmail 92902 invoked by uid 99); 30 Aug 2016 19:34:48 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 30 Aug 2016 19:34:48 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 1468BE0200; Tue, 30 Aug 2016 19:34:48 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: serb@apache.org To: commits@aurora.apache.org Message-Id: <0f7533a22c894b519ad7fff235f82a70@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: aurora git commit: Minor improvements to the custom executor docs Date: Tue, 30 Aug 2016 19:34:48 +0000 (UTC) archived-at: Tue, 30 Aug 2016 19:34:49 -0000 Repository: aurora Updated Branches: refs/heads/master c34f78a6d -> c99f2fb68 Minor improvements to the custom executor docs * Add link from README.md to features/custom-executors.md * Add short introduction paragraph to features/custom-executors.md Reviewed at https://reviews.apache.org/r/51531/ Project: http://git-wip-us.apache.org/repos/asf/aurora/repo Commit: http://git-wip-us.apache.org/repos/asf/aurora/commit/c99f2fb6 Tree: http://git-wip-us.apache.org/repos/asf/aurora/tree/c99f2fb6 Diff: http://git-wip-us.apache.org/repos/asf/aurora/diff/c99f2fb6 Branch: refs/heads/master Commit: c99f2fb681c974dd6d4226088f803287b39ee528 Parents: c34f78a Author: Stephan Erb Authored: Tue Aug 30 21:34:22 2016 +0200 Committer: Stephan Erb Committed: Tue Aug 30 21:34:22 2016 +0200 ---------------------------------------------------------------------- RELEASE-NOTES.md | 7 ++++--- docs/README.md | 1 + docs/features/custom-executors.md | 7 +++++-- docs/operations/configuration.md | 3 +-- 4 files changed, 11 insertions(+), 7 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/aurora/blob/c99f2fb6/RELEASE-NOTES.md ---------------------------------------------------------------------- diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md index 1819eaa..f6b609f 100644 --- a/RELEASE-NOTES.md +++ b/RELEASE-NOTES.md @@ -25,10 +25,8 @@ then the response will be binary thrift. Any other value for `Accept` will result in thrift JSON. - Scheduler is now able to launch jobs using more than one executor at a time. To use this feature the `-custom_executor_config` flag must point to a JSON file which contains at least one valid - executor configuration as detailed in the [configuration](http://aurora.apache.org/documentation/latest/operations/configuration/) + executor configuration as detailed in the [configuration](docs/features/custom-executors.md) documentation. -- The `ExecutorInfo.source` field is deprecated and has been replaced with a label named `source`. - It will be removed from Mesos in a future release. - Add rollback API to the scheduler and new client command to support rolling back active update jobs to their initial state. @@ -38,6 +36,9 @@ that `production=true` used to provide, users should elect a `tier` for the job with attributes `preemptible=false` and `revocable=false`. For example, the `preferred` tier in the default tier configuration file (`tiers.json`) matches the above criteria. +- The `ExecutorInfo.source` field is deprecated and has been replaced with a label named `source`. + It will be removed from Mesos in a future release. + 0.15.0 ====== http://git-wip-us.apache.org/repos/asf/aurora/blob/c99f2fb6/docs/README.md ---------------------------------------------------------------------- diff --git a/docs/README.md b/docs/README.md index 7cea18f..1d679e2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -20,6 +20,7 @@ Description of important Aurora features. * [Containers](features/containers.md) * [Cron Jobs](features/cron-jobs.md) + * [Custom Executors](features/custom-executors.md) * [Job Updates](features/job-updates.md) * [Multitenancy](features/multitenancy.md) * [Resource Isolation](features/resource-isolation.md) http://git-wip-us.apache.org/repos/asf/aurora/blob/c99f2fb6/docs/features/custom-executors.md ---------------------------------------------------------------------- diff --git a/docs/features/custom-executors.md b/docs/features/custom-executors.md index 7438938..40fc118 100644 --- a/docs/features/custom-executors.md +++ b/docs/features/custom-executors.md @@ -1,6 +1,10 @@ Custom Executors ================ +If the need arises to use a Mesos executor other than the Thermos executor, the scheduler can be +configured to utilize a custom executor by specifying the `-custom_executor_config` flag. +The flag must be set to the path of a valid executor configuration file. + The configuration file must be a valid **JSON array** and contain, at minimum, one executor configuration including the name, command and resources fields and must be pointed to by the `-custom_executor_config` flag when the scheduler is @@ -134,7 +138,7 @@ A sample configuration is as follows: ``` -It should be noted that if you do not use thermos or a thermos based executor, links in the scheduler's +It should be noted that if you do not use Thermos or a Thermos based executor, links in the scheduler's Web UI for tasks will not work (at least for the time being). Some information about launched tasks can still be accessed via the Mesos Web UI or via the Aurora Client. @@ -146,4 +150,3 @@ field must be set to match the name used in the custom executor configuration bl `JobConfiguration.TaskConfig.ExecutorConfig.name` must be set to `myExecutor`). While support for modifying this field in Pystachio created, the easiest way to launch jobs with custom executors is to use an existing custom Client such as [gorealis](https://github.com/rdelval/gorealis). - http://git-wip-us.apache.org/repos/asf/aurora/blob/c99f2fb6/docs/operations/configuration.md ---------------------------------------------------------------------- diff --git a/docs/operations/configuration.md b/docs/operations/configuration.md index 15ec042..350ea77 100644 --- a/docs/operations/configuration.md +++ b/docs/operations/configuration.md @@ -144,8 +144,7 @@ For example, to wrap the executor inside a simple wrapper, the scheduler will be ## Custom Executors -If the need arises to use a Mesos executor other than the Thermos executor, the scheduler can be -configured to utilize a custom executor by specifying the `-custom_executor_config` flag. +The scheduler can be configured to utilize a custom executor by specifying the `-custom_executor_config` flag. The flag must be set to the path of a valid executor configuration file. For more information on this feature please see the custom executors [documentation](../features/custom-executors.md).