Author: santhk
Date: Wed Jun 21 06:36:21 2017
New Revision: 1799392
URL: http://svn.apache.org/viewvc?rev=1799392&view=rev
Log:
Update website for Aurora 0.18.0 - part-2
Added:
aurora/site/publish/blog/aurora-0-18-0-released/
aurora/site/publish/blog/aurora-0-18-0-released/index.html
aurora/site/publish/documentation/0.18.0/
aurora/site/publish/documentation/0.18.0/additional-resources/
aurora/site/publish/documentation/0.18.0/additional-resources/presentations/
aurora/site/publish/documentation/0.18.0/additional-resources/presentations/index.html
aurora/site/publish/documentation/0.18.0/additional-resources/tools/
aurora/site/publish/documentation/0.18.0/additional-resources/tools/index.html
aurora/site/publish/documentation/0.18.0/contributing/
aurora/site/publish/documentation/0.18.0/contributing/index.html
aurora/site/publish/documentation/0.18.0/development/
aurora/site/publish/documentation/0.18.0/development/client/
aurora/site/publish/documentation/0.18.0/development/client/index.html
aurora/site/publish/documentation/0.18.0/development/committers-guide/
aurora/site/publish/documentation/0.18.0/development/committers-guide/index.html
aurora/site/publish/documentation/0.18.0/development/db-migration/
aurora/site/publish/documentation/0.18.0/development/db-migration/index.html
aurora/site/publish/documentation/0.18.0/development/design/
aurora/site/publish/documentation/0.18.0/development/design-documents/
aurora/site/publish/documentation/0.18.0/development/design-documents/index.html
aurora/site/publish/documentation/0.18.0/development/design/command-hooks/
aurora/site/publish/documentation/0.18.0/development/design/command-hooks/index.html
aurora/site/publish/documentation/0.18.0/development/scheduler/
aurora/site/publish/documentation/0.18.0/development/scheduler/index.html
aurora/site/publish/documentation/0.18.0/development/thermos/
aurora/site/publish/documentation/0.18.0/development/thermos/index.html
aurora/site/publish/documentation/0.18.0/development/thrift/
aurora/site/publish/documentation/0.18.0/development/thrift/index.html
aurora/site/publish/documentation/0.18.0/development/ui/
aurora/site/publish/documentation/0.18.0/development/ui/index.html
aurora/site/publish/documentation/0.18.0/features/
aurora/site/publish/documentation/0.18.0/features/constraints/
aurora/site/publish/documentation/0.18.0/features/constraints/index.html
aurora/site/publish/documentation/0.18.0/features/containers/
aurora/site/publish/documentation/0.18.0/features/containers/index.html
aurora/site/publish/documentation/0.18.0/features/cron-jobs/
aurora/site/publish/documentation/0.18.0/features/cron-jobs/index.html
aurora/site/publish/documentation/0.18.0/features/custom-executors/
aurora/site/publish/documentation/0.18.0/features/custom-executors/index.html
aurora/site/publish/documentation/0.18.0/features/job-updates/
aurora/site/publish/documentation/0.18.0/features/job-updates/index.html
aurora/site/publish/documentation/0.18.0/features/mesos-fetcher/
aurora/site/publish/documentation/0.18.0/features/mesos-fetcher/index.html
aurora/site/publish/documentation/0.18.0/features/multitenancy/
aurora/site/publish/documentation/0.18.0/features/multitenancy/index.html
aurora/site/publish/documentation/0.18.0/features/resource-isolation/
aurora/site/publish/documentation/0.18.0/features/resource-isolation/index.html
aurora/site/publish/documentation/0.18.0/features/service-discovery/
aurora/site/publish/documentation/0.18.0/features/service-discovery/index.html
aurora/site/publish/documentation/0.18.0/features/services/
aurora/site/publish/documentation/0.18.0/features/services/index.html
aurora/site/publish/documentation/0.18.0/features/sla-metrics/
aurora/site/publish/documentation/0.18.0/features/sla-metrics/index.html
aurora/site/publish/documentation/0.18.0/features/webhooks/
aurora/site/publish/documentation/0.18.0/features/webhooks/index.html
aurora/site/publish/documentation/0.18.0/getting-started/
aurora/site/publish/documentation/0.18.0/getting-started/overview/
aurora/site/publish/documentation/0.18.0/getting-started/overview/index.html
aurora/site/publish/documentation/0.18.0/getting-started/tutorial/
aurora/site/publish/documentation/0.18.0/getting-started/tutorial/index.html
aurora/site/publish/documentation/0.18.0/getting-started/vagrant/
aurora/site/publish/documentation/0.18.0/getting-started/vagrant/index.html
aurora/site/publish/documentation/0.18.0/images/
aurora/site/publish/documentation/0.18.0/images/CPUavailability.png (with
props)
aurora/site/publish/documentation/0.18.0/images/CompletedTasks.png (with
props)
aurora/site/publish/documentation/0.18.0/images/HelloWorldJob.png (with
props)
aurora/site/publish/documentation/0.18.0/images/RoleJobs.png (with props)
aurora/site/publish/documentation/0.18.0/images/RunningJob.png (with
props)
aurora/site/publish/documentation/0.18.0/images/ScheduledJobs.png (with
props)
aurora/site/publish/documentation/0.18.0/images/TaskBreakdown.png (with
props)
aurora/site/publish/documentation/0.18.0/images/aurora_hierarchy.png
(with props)
aurora/site/publish/documentation/0.18.0/images/aurora_logo.png (with
props)
aurora/site/publish/documentation/0.18.0/images/components.odg (with
props)
aurora/site/publish/documentation/0.18.0/images/components.png (with
props)
aurora/site/publish/documentation/0.18.0/images/debug-client-test.png
(with props)
aurora/site/publish/documentation/0.18.0/images/debugging-client-test.png
(with props)
aurora/site/publish/documentation/0.18.0/images/killedtask.png (with
props)
aurora/site/publish/documentation/0.18.0/images/lifeofatask.png (with
props)
aurora/site/publish/documentation/0.18.0/images/presentations/
aurora/site/publish/documentation/0.18.0/images/presentations/02_19_2015_aurora_adopters_panel_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/02_19_2015_aurora_at_tellapart_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/02_19_2015_aurora_at_twitter_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/02_28_2015_apache_aurora_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/03_07_2015_aurora_mesos_in_practice_at_twitter_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/03_25_2014_introduction_to_aurora_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/04_30_2015_monolith_to_microservices_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/08_21_2014_past_present_future_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/09_20_2015_shipping_code_with_aurora_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/09_20_2015_twitter_production_scale_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/10_08_2015_mesos_aurora_on_a_small_scale_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/presentations/10_08_2015_sla_aware_maintenance_for_operators_thumb.png
(with props)
aurora/site/publish/documentation/0.18.0/images/runningtask.png (with
props)
aurora/site/publish/documentation/0.18.0/images/stderr.png (with props)
aurora/site/publish/documentation/0.18.0/images/stdout.png (with props)
aurora/site/publish/documentation/0.18.0/images/storage_hierarchy.png
(with props)
aurora/site/publish/documentation/0.18.0/index.html
aurora/site/publish/documentation/0.18.0/operations/
aurora/site/publish/documentation/0.18.0/operations/backup-restore/
aurora/site/publish/documentation/0.18.0/operations/backup-restore/index.html
aurora/site/publish/documentation/0.18.0/operations/configuration/
aurora/site/publish/documentation/0.18.0/operations/configuration/index.html
aurora/site/publish/documentation/0.18.0/operations/installation/
aurora/site/publish/documentation/0.18.0/operations/installation/index.html
aurora/site/publish/documentation/0.18.0/operations/monitoring/
aurora/site/publish/documentation/0.18.0/operations/monitoring/index.html
aurora/site/publish/documentation/0.18.0/operations/security/
aurora/site/publish/documentation/0.18.0/operations/security/index.html
aurora/site/publish/documentation/0.18.0/operations/storage/
aurora/site/publish/documentation/0.18.0/operations/storage/index.html
aurora/site/publish/documentation/0.18.0/operations/troubleshooting/
aurora/site/publish/documentation/0.18.0/operations/troubleshooting/index.html
aurora/site/publish/documentation/0.18.0/operations/upgrades/
aurora/site/publish/documentation/0.18.0/operations/upgrades/index.html
aurora/site/publish/documentation/0.18.0/reference/
aurora/site/publish/documentation/0.18.0/reference/client-cluster-configuration/
aurora/site/publish/documentation/0.18.0/reference/client-cluster-configuration/index.html
aurora/site/publish/documentation/0.18.0/reference/client-commands/
aurora/site/publish/documentation/0.18.0/reference/client-commands/index.html
aurora/site/publish/documentation/0.18.0/reference/client-hooks/
aurora/site/publish/documentation/0.18.0/reference/client-hooks/index.html
aurora/site/publish/documentation/0.18.0/reference/configuration/
aurora/site/publish/documentation/0.18.0/reference/configuration-best-practices/
aurora/site/publish/documentation/0.18.0/reference/configuration-best-practices/index.html
aurora/site/publish/documentation/0.18.0/reference/configuration-templating/
aurora/site/publish/documentation/0.18.0/reference/configuration-templating/index.html
aurora/site/publish/documentation/0.18.0/reference/configuration-tutorial/
aurora/site/publish/documentation/0.18.0/reference/configuration-tutorial/index.html
aurora/site/publish/documentation/0.18.0/reference/configuration/index.html
aurora/site/publish/documentation/0.18.0/reference/observer-configuration/
aurora/site/publish/documentation/0.18.0/reference/observer-configuration/index.html
aurora/site/publish/documentation/0.18.0/reference/scheduler-configuration/
aurora/site/publish/documentation/0.18.0/reference/scheduler-configuration/index.html
aurora/site/publish/documentation/0.18.0/reference/scheduler-endpoints/
aurora/site/publish/documentation/0.18.0/reference/scheduler-endpoints/index.html
aurora/site/publish/documentation/0.18.0/reference/task-lifecycle/
aurora/site/publish/documentation/0.18.0/reference/task-lifecycle/index.html
aurora/site/publish/documentation/latest/operations/troubleshooting/
aurora/site/publish/documentation/latest/operations/troubleshooting/index.html
aurora/site/publish/documentation/latest/operations/upgrades/
aurora/site/publish/documentation/latest/operations/upgrades/index.html
aurora/site/publish/documentation/latest/reference/observer-configuration/
aurora/site/publish/documentation/latest/reference/observer-configuration/index.html
aurora/site/source/blog/2017-06-20-aurora-0-18-0-released.md
aurora/site/source/documentation/0.18.0/
aurora/site/source/documentation/0.18.0/additional-resources/
aurora/site/source/documentation/0.18.0/additional-resources/presentations.md
aurora/site/source/documentation/0.18.0/additional-resources/tools.md
aurora/site/source/documentation/0.18.0/contributing.md
aurora/site/source/documentation/0.18.0/development/
aurora/site/source/documentation/0.18.0/development/client.md
aurora/site/source/documentation/0.18.0/development/committers-guide.md
aurora/site/source/documentation/0.18.0/development/db-migration.md
aurora/site/source/documentation/0.18.0/development/design/
aurora/site/source/documentation/0.18.0/development/design-documents.md
aurora/site/source/documentation/0.18.0/development/design/command-hooks.md
aurora/site/source/documentation/0.18.0/development/scheduler.md
aurora/site/source/documentation/0.18.0/development/thermos.md
aurora/site/source/documentation/0.18.0/development/thrift.md
aurora/site/source/documentation/0.18.0/development/ui.md
aurora/site/source/documentation/0.18.0/features/
aurora/site/source/documentation/0.18.0/features/constraints.md
aurora/site/source/documentation/0.18.0/features/containers.md
aurora/site/source/documentation/0.18.0/features/cron-jobs.md
aurora/site/source/documentation/0.18.0/features/custom-executors.md
aurora/site/source/documentation/0.18.0/features/job-updates.md
aurora/site/source/documentation/0.18.0/features/mesos-fetcher.md
aurora/site/source/documentation/0.18.0/features/multitenancy.md
aurora/site/source/documentation/0.18.0/features/resource-isolation.md
aurora/site/source/documentation/0.18.0/features/service-discovery.md
aurora/site/source/documentation/0.18.0/features/services.md
aurora/site/source/documentation/0.18.0/features/sla-metrics.md
aurora/site/source/documentation/0.18.0/features/webhooks.md
aurora/site/source/documentation/0.18.0/getting-started/
aurora/site/source/documentation/0.18.0/getting-started/overview.md
aurora/site/source/documentation/0.18.0/getting-started/tutorial.md
aurora/site/source/documentation/0.18.0/getting-started/vagrant.md
aurora/site/source/documentation/0.18.0/images/
aurora/site/source/documentation/0.18.0/images/CPUavailability.png (with
props)
aurora/site/source/documentation/0.18.0/images/CompletedTasks.png (with
props)
aurora/site/source/documentation/0.18.0/images/HelloWorldJob.png (with
props)
aurora/site/source/documentation/0.18.0/images/RoleJobs.png (with props)
aurora/site/source/documentation/0.18.0/images/RunningJob.png (with props)
aurora/site/source/documentation/0.18.0/images/ScheduledJobs.png (with
props)
aurora/site/source/documentation/0.18.0/images/TaskBreakdown.png (with
props)
aurora/site/source/documentation/0.18.0/images/aurora_hierarchy.png (with
props)
aurora/site/source/documentation/0.18.0/images/aurora_logo.png (with
props)
aurora/site/source/documentation/0.18.0/images/components.odg (with props)
aurora/site/source/documentation/0.18.0/images/components.png (with props)
aurora/site/source/documentation/0.18.0/images/debug-client-test.png
(with props)
aurora/site/source/documentation/0.18.0/images/debugging-client-test.png
(with props)
aurora/site/source/documentation/0.18.0/images/killedtask.png (with props)
aurora/site/source/documentation/0.18.0/images/lifeofatask.png (with
props)
aurora/site/source/documentation/0.18.0/images/presentations/
aurora/site/source/documentation/0.18.0/images/presentations/02_19_2015_aurora_adopters_panel_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/02_19_2015_aurora_at_tellapart_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/02_19_2015_aurora_at_twitter_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/02_28_2015_apache_aurora_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/03_07_2015_aurora_mesos_in_practice_at_twitter_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/03_25_2014_introduction_to_aurora_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/04_30_2015_monolith_to_microservices_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/08_21_2014_past_present_future_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/09_20_2015_shipping_code_with_aurora_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/09_20_2015_twitter_production_scale_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/10_08_2015_mesos_aurora_on_a_small_scale_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/presentations/10_08_2015_sla_aware_maintenance_for_operators_thumb.png
(with props)
aurora/site/source/documentation/0.18.0/images/runningtask.png (with
props)
aurora/site/source/documentation/0.18.0/images/stderr.png (with props)
aurora/site/source/documentation/0.18.0/images/stdout.png (with props)
aurora/site/source/documentation/0.18.0/images/storage_hierarchy.png
(with props)
aurora/site/source/documentation/0.18.0/index.html.md
aurora/site/source/documentation/0.18.0/operations/
aurora/site/source/documentation/0.18.0/operations/backup-restore.md
aurora/site/source/documentation/0.18.0/operations/configuration.md
aurora/site/source/documentation/0.18.0/operations/installation.md
aurora/site/source/documentation/0.18.0/operations/monitoring.md
aurora/site/source/documentation/0.18.0/operations/security.md
aurora/site/source/documentation/0.18.0/operations/storage.md
aurora/site/source/documentation/0.18.0/operations/troubleshooting.md
aurora/site/source/documentation/0.18.0/operations/upgrades.md
aurora/site/source/documentation/0.18.0/reference/
aurora/site/source/documentation/0.18.0/reference/client-cluster-configuration.md
aurora/site/source/documentation/0.18.0/reference/client-commands.md
aurora/site/source/documentation/0.18.0/reference/client-hooks.md
aurora/site/source/documentation/0.18.0/reference/configuration-best-practices.md
aurora/site/source/documentation/0.18.0/reference/configuration-templating.md
aurora/site/source/documentation/0.18.0/reference/configuration-tutorial.md
aurora/site/source/documentation/0.18.0/reference/configuration.md
aurora/site/source/documentation/0.18.0/reference/observer-configuration.md
aurora/site/source/documentation/0.18.0/reference/scheduler-configuration.md
aurora/site/source/documentation/0.18.0/reference/scheduler-endpoints.md
aurora/site/source/documentation/0.18.0/reference/task-lifecycle.md
aurora/site/source/documentation/latest/operations/troubleshooting.md
aurora/site/source/documentation/latest/operations/upgrades.md
aurora/site/source/documentation/latest/reference/observer-configuration.md
Added: aurora/site/publish/blog/aurora-0-18-0-released/index.html
URL:
http://svn.apache.org/viewvc/aurora/site/publish/blog/aurora-0-18-0-released/index.html?rev=1799392&view=auto
==============================================================================
--- aurora/site/publish/blog/aurora-0-18-0-released/index.html (added)
+++ aurora/site/publish/blog/aurora-0-18-0-released/index.html Wed Jun 21
06:36:21 2017
@@ -0,0 +1,178 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Aurora</title>
+ <link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css";>
+ <link href="/assets/css/main.css" rel="stylesheet">
+ <!-- Analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-45879646-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <div class="container-fluid section-header">
+ <div class="container">
+ <div class="nav nav-bar">
+ <a href="/"><img src="/assets/img/aurora_logo_dkbkg.svg" width="300"
alt="Transparent Apache Aurora logo with dark background"/></a>
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/community/">Community</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/blog/">Blog</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div class="container-fluid">
+ <div class="container content">
+ <div class="container-fluid">
+
+<div class="row">
+<div class="col-md-3 buffer">
+ <div class="meta">
+ <span class="author">
+ <span class="author_contact">
+ <p><strong>Santhosh Kumar Shanmugham</strong></p>
+ <p><a href="http://twitter.com/santhk";>@santhk</a></p>
+ </span>
+ </span>
+ <p><em>Posted June 20, 2017</em></p>
+ </div>
+
+ <div class="share">
+ <span class="social-share-button"><a
href="https://twitter.com/share"; class="twitter-share-button"
data-via="ApacheAurora">Tweet</a></span>
+
+ <span><script>!function(d,s,id){var
js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document,
'script', 'twitter-wjs');</script></span>
+
+ <script src="//platform.linkedin.com/in.js"
type="text/javascript">
+ lang: en_US
+ </script>
+ <script type="IN/Share" data-counter="right"></script>
+ </div>
+</div>
+
+<div class="post col-md-9">
+ <h1>0.18.0 Released</h1>
+
+ <p>The latest Apache Aurora release, 0.18.0, is now available for
+<a href="http://aurora.apache.org/downloads/";>download</a>. Here are some
highlights in this release.</p>
+
+<p>Major new features:</p>
+
+<ul>
+<li>Added the <code>-mesos_driver</code> flag to the scheduler with three
possible options:
+<code>SCHEDULER_DRIVER</code>, <code>V0_MESOS</code>, <code>V1_MESOS</code>.
The first uses the original driver
+and the latter two use two new drivers from <code>libmesos</code>.
<code>V0_MESOS</code> uses the
+<code>SCHEDULER_DRIVER</code> under the hood and <code>V1_MESOS</code> uses a
new HTTP API aware
+driver. Users that want to use the HTTP API should use <code>V1_MESOS</code>.
+Performance sensitive users should stick with the
<code>SCHEDULER_DRIVER</code> or
+<code>V0_MESOS</code> drivers.</li>
+<li>Add observer command line options to control the resource collection
interval
+for observed tasks. See <a
href="docs/reference/observer-configuration.md">here</a> for details.</li>
+<li>Added support for reserving agents during job updates, which can
substantially reduce update times
+in clusters with high contention for resources. Disabled by default, but can
be enabled with
+<code>enable_update_affinity</code> option, and the reservation timeout can be
controlled via
+<code>update_affinity_reservation_hold_time</code>.</li>
+<li>Add <code>task scp</code> command to the CLI client for easy transferring
of files to/from/between task
+instances. See <a
href="docs/reference/client-commands.md#scping-with-task-machines">here</a> for
details.
+Currently only fully supported for Mesos containers (you can copy files from
the Docker container
+sandbox but you cannot send files to it).</li>
+<li>Added ability to inject your own scheduling logic, via a lazy Guice module
binding. This is an
+alpha-level feature and not subject to backwards compatibility considerations.
You can specify
+your custom modules using the <code>task_assigner_modules</code> and
<code>preemption_slot_finder_modules</code> options.</li>
+<li>Added support for resource bin-packing via the <code>-offer_order</code>
option. You can choose from <code>CPU</code>,
+<code>MEMORY</code>, <code>DISK</code>, <code>RANDOM</code> or
<code>REVOCABLE_CPU</code>. You can also compose secondary sorts by combining
+orders together: e.g. to bin-pack by CPU and MEMORY you could supply
<code>CPU,MEMORY</code>. The current
+default is <code>RANDOM</code>, which has the strong advantage that users can
(usually) relocate their tasks
+due to noisy neighbors or machine issues with a task restart. When you have
deterministic
+bin-packing, they may always end up on the same agent. So be careful enabling
this without proper
+monitoring and remediation of host failures.</li>
+<li>Modified job update behavior to create new instances, then update existing
instances, and then
+kill unwanted instances. Previously, a job update would modify each instance
in the order of
+their instance ID.</li>
+<li>Added ability to whitelist TaskStateChanges in the webhook configuration
file. You can specify
+a list of desired TaskStateChanges(represented by their task statuses) to be
sent to a configured
+endpoint.</li>
+<li>Add message parameter to <code>killTasks</code> RPC.</li>
+<li>Add <code>prune_tasks</code> endpoint to <code>aurora_admin</code>. See
<code>aurora_admin prune_tasks -h</code> for usage information.</li>
+<li>Add support for per-task volume mounts for Mesos containers to the Aurora
config DSL.</li>
+</ul>
+
+<p>Additional changes:</p>
+
+<ul>
+<li>Update to Mesos 1.2.0. Please upgrade Aurora to 0.18 before upgrading
Mesos to 1.2.0 if you rely
+on Mesos filesystem images.</li>
+</ul>
+
+<p>Full release notes are available in the release
+<a
href="https://git-wip-us.apache.org/repos/asf?p=aurora.git&f=CHANGELOG&hb=rel/0.18.0";>CHANGELOG</a>.</p>
+
+<h2 id="getting-involved">Getting Involved</h2>
+
+<p>We encourage you to try out this release and let us know what you think. If
you run into any issues,
+please let us know on the <a href="https://aurora.apache.org/community/";>user
mailing list and IRC</a>.</p>
+
+<h2 id="thanks">Thanks</h2>
+
+<p>Thanks to the 12 contributors who made Apache Aurora 0.18.0 possible:</p>
+
+<ul>
+<li>Abhishek Jain</li>
+<li>Charles Raimbert</li>
+<li>Cody Gibb</li>
+<li>David McLaughlin</li>
+<li>Kai Huang</li>
+<li>Mehrdad Nurolahzade</li>
+<li>Nicolás Donatucci</li>
+<li>Reza Motamedi</li>
+<li>Santhosh Kumar Shanmugham</li>
+<li>Stephan Erb</li>
+<li>Takuya Kuwahara</li>
+<li>Zameer Manji</li>
+</ul>
+
+</div>
+</div>
+
+ </div>
+ </div>
+ <div class="container-fluid section-footer buffer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-2 col-md-offset-1"><h3>Quick Links</h3>
+ <ul>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Mailing Lists</a></li>
+ <li><a
href="http://issues.apache.org/jira/browse/AURORA";>Issue Tracking</a></li>
+ <li><a href="/documentation/latest/contributing/">How
To Contribute</a></li>
+ </ul>
+ </div>
+ <div class="col-md-2"><h3>The ASF</h3>
+ <ul>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div>
+ <div class="col-md-6">
+ <p class="disclaimer">© 2014-2017 <a
href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under
the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. The <a
href="https://www.flickr.com/photos/trondk/12706051375/";>Aurora Borealis IX
photo</a> displayed on the homepage is available under a <a
href="https://creativecommons.org/licenses/by-nc-nd/2.0/";>Creative Commons
BY-NC-ND 2.0 license</a>. Apache, Apache Aurora, and the Apache feather logo
are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html>
Added:
aurora/site/publish/documentation/0.18.0/additional-resources/presentations/index.html
URL:
http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.18.0/additional-resources/presentations/index.html?rev=1799392&view=auto
==============================================================================
---
aurora/site/publish/documentation/0.18.0/additional-resources/presentations/index.html
(added)
+++
aurora/site/publish/documentation/0.18.0/additional-resources/presentations/index.html
Wed Jun 21 06:36:21 2017
@@ -0,0 +1,215 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Aurora</title>
+ <link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css";>
+ <link href="/assets/css/main.css" rel="stylesheet">
+ <!-- Analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-45879646-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <div class="container-fluid section-header">
+ <div class="container">
+ <div class="nav nav-bar">
+ <a href="/"><img src="/assets/img/aurora_logo_dkbkg.svg" width="300"
alt="Transparent Apache Aurora logo with dark background"/></a>
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/community/">Community</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/blog/">Blog</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div class="container-fluid">
+ <div class="container content">
+ <div class="col-md-12 documentation">
+<h5 class="page-header text-uppercase">Documentation
+<select onChange="window.location.href='/documentation/' + this.value +
'/additional-resources/presentations/'"
+ value="0.18.0">
+ <option value="0.18.0"
+ selected="selected">
+ 0.18.0
+ (latest)
+ </option>
+ <option value="0.17.0"
+ >
+ 0.17.0
+ </option>
+ <option value="0.16.0"
+ >
+ 0.16.0
+ </option>
+ <option value="0.15.0"
+ >
+ 0.15.0
+ </option>
+ <option value="0.14.0"
+ >
+ 0.14.0
+ </option>
+ <option value="0.13.0"
+ >
+ 0.13.0
+ </option>
+ <option value="0.12.0"
+ >
+ 0.12.0
+ </option>
+ <option value="0.11.0"
+ >
+ 0.11.0
+ </option>
+ <option value="0.10.0"
+ >
+ 0.10.0
+ </option>
+ <option value="0.9.0"
+ >
+ 0.9.0
+ </option>
+ <option value="0.8.0"
+ >
+ 0.8.0
+ </option>
+ <option value="0.7.0-incubating"
+ >
+ 0.7.0-incubating
+ </option>
+ <option value="0.6.0-incubating"
+ >
+ 0.6.0-incubating
+ </option>
+ <option value="0.5.0-incubating"
+ >
+ 0.5.0-incubating
+ </option>
+</select>
+</h5>
+<h1 id="apache-aurora-presentations">Apache Aurora Presentations</h1>
+
+<p>Video and slides from presentations and panel discussions about Apache
Aurora.</p>
+
+<p><em>(Listed in date descending order)</em></p>
+
+<table>
+
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/10_08_2015_mesos_aurora_on_a_small_scale_thumb.png"
alt="Mesos and Aurora on a Small Scale Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=q5iIqhaCJ_o";>Mesos & Aurora on a
Small Scale (Video)</a></strong>
+ <p>Presented by Florian Pfeiffer</p>
+ <p>October 8, 2015 at <a
href="http://events.linuxfoundation.org/events/archive/2015/mesoscon-europe";>#MesosCon
Europe 2015</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/10_08_2015_sla_aware_maintenance_for_operators_thumb.png"
alt="SLA Aware Maintenance for Operators Thumbnail" /></td>
+ <td><strong><a href="https://www.youtube.com/watch?v=tZ0-SISvCis";>SLA
Aware Maintenance for Operators (Video)</a></strong>
+ <p>Presented by Joe Smith</p>
+ <p>October 8, 2015 at <a
href="http://events.linuxfoundation.org/events/archive/2015/mesoscon-europe";>#MesosCon
Europe 2015</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/09_20_2015_shipping_code_with_aurora_thumb.png"
alt="Shipping Code with Aurora Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=y1hi7K1lPkk";>Shipping Code with Aurora
(Video)</a></strong>
+ <p>Presented by Bill Farner</p>
+ <p>August 20, 2015 at <a
href="http://events.linuxfoundation.org/events/archive/2015/mesoscon";>#MesosCon
2015</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/09_20_2015_twitter_production_scale_thumb.png"
alt="Twitter Production Scale Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=nNrh-gdu9m4";>Twitterâs Production
Scale: Mesos and Aurora Operations (Video)</a></strong>
+ <p>Presented by Joe Smith</p>
+ <p>August 20, 2015 at <a
href="http://events.linuxfoundation.org/events/archive/2015/mesoscon";>#MesosCon
2015</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/04_30_2015_monolith_to_microservices_thumb.png"
alt="From Monolith to Microservices with Aurora Video Thumbnail" /></td>
+ <td><strong><a href="https://www.youtube.com/watch?v=yXkOgnyK4Hw";>From
Monolith to Microservices w/ Aurora (Video)</a></strong>
+ <p>Presented by Thanos Baskous, Tony Dong, Dobromir Montauk</p>
+ <p>April 30, 2015 at <a
href="http://www.meetup.com/Bay-Area-Apache-Aurora-Users-Group/events/221219480/";>Bay
Area Apache Aurora Users Group</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/03_07_2015_aurora_mesos_in_practice_at_twitter_thumb.png"
alt="Aurora + Mesos in Practice at Twitter Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=1XYJGX_qZVU";>Aurora + Mesos in Practice
at Twitter (Video)</a></strong>
+ <p>Presented by Bill Farner</p>
+ <p>March 07, 2015 at <a
href="http://www.bigeng.io/aurora-mesos-in-practice-at-twitter";>Bigcommerce
TechTalk</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/02_28_2015_apache_aurora_thumb.png"
alt="Apache Auroraã®å§ããã Slideshow Thumbnail" /></td>
+ <td><strong><a
href="http://www.slideshare.net/zembutsu/apache-aurora-introduction-and-tutorial-osc15tk";>Apache
Auroraã®å§ããã (Slides)</a></strong>
+ <p>Presented by Masahito Zembutsu</p>
+ <p>February 28, 2015 at <a
href="http://www.ospn.jp/osc2015-spring/";>Open Source Conference 2015 Tokyo
Spring</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/02_19_2015_aurora_adopters_panel_thumb.png"
alt="Apache Aurora Adopters Panel Video Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=2Jsj0zFdRlg";>Apache Aurora Adopters Panel
(Video)</a></strong>
+ <p>Panelists Ben Staffin, Josh Adams, Bill Farner, Berk Demir</p>
+ <p>February 19, 2015 at <a
href="http://www.meetup.com/Bay-Area-Mesos-User-Group/events/220279080/";>Bay
Area Mesos Users Group</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/02_19_2015_aurora_at_twitter_thumb.png"
alt="Operating Apache Aurora and Mesos at Twitter Video Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=E4lxX6epM_U";>Operating Apache Aurora and
Mesos at Twitter (Video)</a></strong>
+ <p>Presented by Joe Smith</p>
+ <p>February 19, 2015 at <a
href="http://www.meetup.com/Bay-Area-Mesos-User-Group/events/220279080/";>Bay
Area Mesos Users Group</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/02_19_2015_aurora_at_tellapart_thumb.png"
alt="Apache Aurora and Mesos at TellApart" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=ZZXtXLvTXAE";>Apache Aurora and Mesos at
TellApart (Video)</a></strong>
+ <p>Presented by Steve Niemitz</p>
+ <p>February 19, 2015 at <a
href="http://www.meetup.com/Bay-Area-Mesos-User-Group/events/220279080/";>Bay
Area Mesos Users Group</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/08_21_2014_past_present_future_thumb.png"
alt="Past, Present, and Future of the Aurora Scheduler Video Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=Dsc5CPhKs4o";>Past, Present, and Future of
the Aurora Scheduler (Video)</a></strong>
+ <p>Presented by Bill Farner</p>
+ <p>August 21, 2014 at <a
href="http://events.linuxfoundation.org/events/archive/2014/mesoscon";>#MesosCon
2014</a></p></td>
+ </tr>
+ <tr>
+ <td><img
src="/documentation/0.18.0/images/presentations/03_25_2014_introduction_to_aurora_thumb.png"
alt="Introduction to Apache Aurora Video Thumbnail" /></td>
+ <td><strong><a
href="https://www.youtube.com/watch?v=asd_h6VzaJc";>Introduction to Apache
Aurora (Video)</a></strong>
+ <p>Presented by Bill Farner</p>
+ <p>March 25, 2014 at <a
href="https://www.eventbrite.com/e/aurora-and-mesosframeworksmeetup-tickets-10850994617";>Aurora
and Mesos Frameworks Meetup</a></p></td>
+ </tr>
+</table>
+
+</div>
+
+ </div>
+ </div>
+ <div class="container-fluid section-footer buffer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-2 col-md-offset-1"><h3>Quick Links</h3>
+ <ul>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Mailing Lists</a></li>
+ <li><a
href="http://issues.apache.org/jira/browse/AURORA";>Issue Tracking</a></li>
+ <li><a href="/documentation/latest/contributing/">How
To Contribute</a></li>
+ </ul>
+ </div>
+ <div class="col-md-2"><h3>The ASF</h3>
+ <ul>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div>
+ <div class="col-md-6">
+ <p class="disclaimer">© 2014-2017 <a
href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under
the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. The <a
href="https://www.flickr.com/photos/trondk/12706051375/";>Aurora Borealis IX
photo</a> displayed on the homepage is available under a <a
href="https://creativecommons.org/licenses/by-nc-nd/2.0/";>Creative Commons
BY-NC-ND 2.0 license</a>. Apache, Apache Aurora, and the Apache feather logo
are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html>
Added:
aurora/site/publish/documentation/0.18.0/additional-resources/tools/index.html
URL:
http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.18.0/additional-resources/tools/index.html?rev=1799392&view=auto
==============================================================================
---
aurora/site/publish/documentation/0.18.0/additional-resources/tools/index.html
(added)
+++
aurora/site/publish/documentation/0.18.0/additional-resources/tools/index.html
Wed Jun 21 06:36:21 2017
@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Aurora</title>
+ <link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css";>
+ <link href="/assets/css/main.css" rel="stylesheet">
+ <!-- Analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-45879646-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <div class="container-fluid section-header">
+ <div class="container">
+ <div class="nav nav-bar">
+ <a href="/"><img src="/assets/img/aurora_logo_dkbkg.svg" width="300"
alt="Transparent Apache Aurora logo with dark background"/></a>
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/community/">Community</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/blog/">Blog</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div class="container-fluid">
+ <div class="container content">
+ <div class="col-md-12 documentation">
+<h5 class="page-header text-uppercase">Documentation
+<select onChange="window.location.href='/documentation/' + this.value +
'/additional-resources/tools/'"
+ value="0.18.0">
+ <option value="0.18.0"
+ selected="selected">
+ 0.18.0
+ (latest)
+ </option>
+ <option value="0.17.0"
+ >
+ 0.17.0
+ </option>
+ <option value="0.16.0"
+ >
+ 0.16.0
+ </option>
+ <option value="0.15.0"
+ >
+ 0.15.0
+ </option>
+ <option value="0.14.0"
+ >
+ 0.14.0
+ </option>
+ <option value="0.13.0"
+ >
+ 0.13.0
+ </option>
+ <option value="0.12.0"
+ >
+ 0.12.0
+ </option>
+ <option value="0.11.0"
+ >
+ 0.11.0
+ </option>
+ <option value="0.10.0"
+ >
+ 0.10.0
+ </option>
+ <option value="0.9.0"
+ >
+ 0.9.0
+ </option>
+ <option value="0.8.0"
+ >
+ 0.8.0
+ </option>
+ <option value="0.7.0-incubating"
+ >
+ 0.7.0-incubating
+ </option>
+ <option value="0.6.0-incubating"
+ >
+ 0.6.0-incubating
+ </option>
+ <option value="0.5.0-incubating"
+ >
+ 0.5.0-incubating
+ </option>
+</select>
+</h5>
+<h1 id="tools">Tools</h1>
+
+<p>Various tools integrate with Aurora. Is there a tool missing? Let us know,
or submit a patch to add it!</p>
+
+<ul>
+<li><p>Load-balancing technology used to direct traffic to services running on
Aurora:</p>
+
+<ul>
+<li><a href="https://github.com/airbnb/synapse";>synapse</a> based on
HAProxy</li>
+<li><a href="https://github.com/tellapart/aurproxy";>aurproxy</a> based on
nginx</li>
+<li><a href="https://github.com/benley/aurora-jobhopper";>jobhopper</a>
performs HTTP redirects for easy developer and administrator access</li>
+</ul></li>
+<li><p>RPC libraries that integrate with the Aurora’s <a
href="../../features/service-discovery/">service discovery mechanism</a>:</p>
+
+<ul>
+<li><a href="https://linkerd.io/";>linkerd</a> RPC proxy</li>
+<li><a href="https://twitter.github.io/finagle";>finagle</a> (Scala)</li>
+<li><a href="https://github.com/steveniemitz/scales";>scales</a> (Python)</li>
+</ul></li>
+<li><p>Monitoring:</p>
+
+<ul>
+<li><a href="https://github.com/zircote/collectd-aurora";>collectd-aurora</a>
for cluster monitoring using collectd</li>
+<li><a href="https://github.com/tommyulfsparre/aurora_exporter";>Prometheus
Aurora exporter</a> for cluster monitoring using Prometheus</li>
+<li><a
href="http://prometheus.io/docs/operating/configuration/#zookeeper-serverset-sd-configurations-serverset_sd_config";>Prometheus
service discovery integration</a> for discovering and monitoring services
running on Aurora</li>
+</ul></li>
+<li><p>Packaging and deployment:</p>
+
+<ul>
+<li><a href="https://github.com/apache/aurora-packaging";>aurora-packaging</a>,
the source of the official Aurora packages</li>
+</ul></li>
+<li><p>Thrift Clients:</p>
+
+<ul>
+<li><a href="https://github.com/rdelval/gorealis";>gorealis</a> for
communicating with the scheduler using Go</li>
+</ul></li>
+</ul>
+
+</div>
+
+ </div>
+ </div>
+ <div class="container-fluid section-footer buffer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-2 col-md-offset-1"><h3>Quick Links</h3>
+ <ul>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Mailing Lists</a></li>
+ <li><a
href="http://issues.apache.org/jira/browse/AURORA";>Issue Tracking</a></li>
+ <li><a href="/documentation/latest/contributing/">How
To Contribute</a></li>
+ </ul>
+ </div>
+ <div class="col-md-2"><h3>The ASF</h3>
+ <ul>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div>
+ <div class="col-md-6">
+ <p class="disclaimer">© 2014-2017 <a
href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under
the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. The <a
href="https://www.flickr.com/photos/trondk/12706051375/";>Aurora Borealis IX
photo</a> displayed on the homepage is available under a <a
href="https://creativecommons.org/licenses/by-nc-nd/2.0/";>Creative Commons
BY-NC-ND 2.0 license</a>. Apache, Apache Aurora, and the Apache feather logo
are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html>
Added: aurora/site/publish/documentation/0.18.0/contributing/index.html
URL:
http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.18.0/contributing/index.html?rev=1799392&view=auto
==============================================================================
--- aurora/site/publish/documentation/0.18.0/contributing/index.html (added)
+++ aurora/site/publish/documentation/0.18.0/contributing/index.html Wed Jun 21
06:36:21 2017
@@ -0,0 +1,231 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Aurora</title>
+ <link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css";>
+ <link href="/assets/css/main.css" rel="stylesheet">
+ <!-- Analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-45879646-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <div class="container-fluid section-header">
+ <div class="container">
+ <div class="nav nav-bar">
+ <a href="/"><img src="/assets/img/aurora_logo_dkbkg.svg" width="300"
alt="Transparent Apache Aurora logo with dark background"/></a>
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/community/">Community</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/blog/">Blog</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div class="container-fluid">
+ <div class="container content">
+ <div class="col-md-12 documentation">
+<h5 class="page-header text-uppercase">Documentation
+<select onChange="window.location.href='/documentation/' + this.value +
'/contributing/'"
+ value="0.18.0">
+ <option value="0.18.0"
+ selected="selected">
+ 0.18.0
+ (latest)
+ </option>
+ <option value="0.17.0"
+ >
+ 0.17.0
+ </option>
+ <option value="0.16.0"
+ >
+ 0.16.0
+ </option>
+ <option value="0.15.0"
+ >
+ 0.15.0
+ </option>
+ <option value="0.14.0"
+ >
+ 0.14.0
+ </option>
+ <option value="0.13.0"
+ >
+ 0.13.0
+ </option>
+ <option value="0.12.0"
+ >
+ 0.12.0
+ </option>
+ <option value="0.11.0"
+ >
+ 0.11.0
+ </option>
+ <option value="0.10.0"
+ >
+ 0.10.0
+ </option>
+ <option value="0.9.0"
+ >
+ 0.9.0
+ </option>
+ <option value="0.8.0"
+ >
+ 0.8.0
+ </option>
+ <option value="0.7.0-incubating"
+ >
+ 0.7.0-incubating
+ </option>
+ <option value="0.6.0-incubating"
+ >
+ 0.6.0-incubating
+ </option>
+ <option value="0.5.0-incubating"
+ >
+ 0.5.0-incubating
+ </option>
+</select>
+</h5>
+<h2 id="get-the-source-code">Get the Source Code</h2>
+
+<p>First things first, you’ll need the source! The Aurora source is
available from Apache git:</p>
+<pre class="highlight plaintext"><code>git clone
https://git-wip-us.apache.org/repos/asf/aurora
+</code></pre>
+
+<h2 id="read-the-style-guides">Read the Style Guides</h2>
+
+<p>Aurora’s codebase is primarily Java and Python and conforms to the
Twitter Commons styleguides for
+both languages.</p>
+
+<ul>
+<li><a
href="https://github.com/twitter/commons/blob/master/src/java/com/twitter/common/styleguide.md";>Java
Style Guide</a></li>
+<li><a
href="https://github.com/twitter/commons/blob/master/src/python/twitter/common/styleguide.md";>Python
Style Guide</a></li>
+</ul>
+
+<h2 id="find-something-to-do">Find Something to Do</h2>
+
+<p>There are issues in <a
href="https://issues.apache.org/jira/browse/AURORA";>Jira</a> with the
+<a
href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20AURORA%20AND%20labels%20%3D%20newbie%20and%20resolution%3Dunresolved";>“newbie”
label</a>
+that are good starting places for new Aurora contributors; pick one of these
and dive in! To assign
+a task to yourself, first ask for your JIRA id to be whitelisted by either
asking in IRC/Slack or by
+emailing <a href="mailto:[email protected]";>[email protected]</a>.
Once your JIRA account has been whitelisted you can assign tickets
+to yourself. The next step is to prepare your patch and finally post it for
review.</p>
+
+<h2 id="getting-your-reviewboard-account">Getting your ReviewBoard Account</h2>
+
+<p>Go to <a href="https://reviews.apache.org";>https://reviews.apache.org</a>
and create an account.</p>
+
+<h2 id="setting-up-your-reviewboard-environment">Setting up your ReviewBoard
Environment</h2>
+
+<p>Run <code>./rbt status</code>. The first time this runs it will bootstrap
and you will be asked to login.
+Subsequent runs will cache your login credentials.</p>
+
+<h2 id="submitting-a-patch-for-review">Submitting a Patch for Review</h2>
+
+<p>Post a review with <code>rbt</code>, fill out the fields in your browser
and hit Publish.</p>
+<pre class="highlight plaintext"><code>./rbt post -o
+</code></pre>
+
+<p>If you’re unsure about who to add as a reviewer, you can default to
adding Zameer Manji (zmanji) and
+Joshua Cohen (jcohen). They will take care of finding an appropriate reviewer
for the patch.</p>
+
+<p>Once you’ve done this, you probably want to mark the associated Jira
issue as Reviewable.</p>
+
+<h2 id="updating-an-existing-review">Updating an Existing Review</h2>
+
+<p>Incorporate review feedback, make some more commits, update your existing
review, fill out the
+fields in your browser and hit Publish.</p>
+<pre class="highlight plaintext"><code>./rbt post -o -r <RB_ID>
+</code></pre>
+
+<h2 id="getting-your-review-merged">Getting Your Review Merged</h2>
+
+<p>If you’re not an Aurora committer, one of the committers will merge
your change in as described
+below. Generally, the last reviewer to give the review a ‘Ship
It!’ will be responsible.</p>
+
+<h3 id="merging-your-own-review-committers">Merging Your Own Review
(Committers)</h3>
+
+<p>Once you have shipits from the right committers, merge your changes in a
single commit and mark
+the review as submitted. The typical workflow is:</p>
+<pre class="highlight plaintext"><code>git checkout master
+git pull origin master
+./rbt patch -c <RB_ID> # Verify the automatically-generated commit
message looks sane,
+ # editing if necessary.
+git show master # Verify everything looks sane
+git push origin master
+./rbt close <RB_ID>
+</code></pre>
+
+<p>Note that even if you’re developing using feature branches you will
not use <code>git merge</code> - each
+commit will be an atomic change accompanied by a ReviewBoard entry.</p>
+
+<h3 id="merging-someone-else-39-s-review">Merging Someone Else’s
Review</h3>
+
+<p>Sometimes you’ll need to merge someone else’s RB. The typical
workflow for this is</p>
+<pre class="highlight plaintext"><code>git checkout master
+git pull origin master
+./rbt patch -c <RB_ID>
+git show master # Verify everything looks sane, author is correct
+git push origin master
+</code></pre>
+
+<p>Note for committers: while we generally use the commit message generated by
<code>./rbt patch</code> some
+changes are often required:</p>
+
+<ol>
+<li>Ensure the the commit message does not exceed 100 characters per line.</li>
+<li>Remove the “Testing Done” section. It’s generally
redundant (can be seen by checking the linked
+review) or entirely irrelevant to the commit itself.</li>
+</ol>
+
+<h2 id="cleaning-up">Cleaning Up</h2>
+
+<p>Your patch has landed, congratulations! The last thing you’ll want to
do before moving on to your
+next fix is to clean up your Jira and Reviewboard. The former of which should
be marked as
+“Resolved” while the latter should be marked as
“Submitted”.</p>
+
+</div>
+
+ </div>
+ </div>
+ <div class="container-fluid section-footer buffer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-2 col-md-offset-1"><h3>Quick Links</h3>
+ <ul>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Mailing Lists</a></li>
+ <li><a
href="http://issues.apache.org/jira/browse/AURORA";>Issue Tracking</a></li>
+ <li><a href="/documentation/latest/contributing/">How
To Contribute</a></li>
+ </ul>
+ </div>
+ <div class="col-md-2"><h3>The ASF</h3>
+ <ul>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div>
+ <div class="col-md-6">
+ <p class="disclaimer">© 2014-2017 <a
href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under
the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. The <a
href="https://www.flickr.com/photos/trondk/12706051375/";>Aurora Borealis IX
photo</a> displayed on the homepage is available under a <a
href="https://creativecommons.org/licenses/by-nc-nd/2.0/";>Creative Commons
BY-NC-ND 2.0 license</a>. Apache, Apache Aurora, and the Apache feather logo
are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html>
Added: aurora/site/publish/documentation/0.18.0/development/client/index.html
URL:
http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.18.0/development/client/index.html?rev=1799392&view=auto
==============================================================================
--- aurora/site/publish/documentation/0.18.0/development/client/index.html
(added)
+++ aurora/site/publish/documentation/0.18.0/development/client/index.html Wed
Jun 21 06:36:21 2017
@@ -0,0 +1,280 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Aurora</title>
+ <link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css";>
+ <link href="/assets/css/main.css" rel="stylesheet">
+ <!-- Analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-45879646-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <div class="container-fluid section-header">
+ <div class="container">
+ <div class="nav nav-bar">
+ <a href="/"><img src="/assets/img/aurora_logo_dkbkg.svg" width="300"
alt="Transparent Apache Aurora logo with dark background"/></a>
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/community/">Community</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/blog/">Blog</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div class="container-fluid">
+ <div class="container content">
+ <div class="col-md-12 documentation">
+<h5 class="page-header text-uppercase">Documentation
+<select onChange="window.location.href='/documentation/' + this.value +
'/development/client/'"
+ value="0.18.0">
+ <option value="0.18.0"
+ selected="selected">
+ 0.18.0
+ (latest)
+ </option>
+ <option value="0.17.0"
+ >
+ 0.17.0
+ </option>
+ <option value="0.16.0"
+ >
+ 0.16.0
+ </option>
+ <option value="0.15.0"
+ >
+ 0.15.0
+ </option>
+ <option value="0.14.0"
+ >
+ 0.14.0
+ </option>
+ <option value="0.13.0"
+ >
+ 0.13.0
+ </option>
+ <option value="0.12.0"
+ >
+ 0.12.0
+ </option>
+ <option value="0.11.0"
+ >
+ 0.11.0
+ </option>
+ <option value="0.10.0"
+ >
+ 0.10.0
+ </option>
+ <option value="0.9.0"
+ >
+ 0.9.0
+ </option>
+ <option value="0.8.0"
+ >
+ 0.8.0
+ </option>
+ <option value="0.7.0-incubating"
+ >
+ 0.7.0-incubating
+ </option>
+ <option value="0.6.0-incubating"
+ >
+ 0.6.0-incubating
+ </option>
+ <option value="0.5.0-incubating"
+ >
+ 0.5.0-incubating
+ </option>
+</select>
+</h5>
+<h1 id="developing-the-aurora-client">Developing the Aurora Client</h1>
+
+<p>The client is written in Python, and uses the
+<a href="http://pantsbuild.github.io/python-readme.html";>Pants</a> build
tool.</p>
+
+<h2 id="building-and-testing">Building and Testing</h2>
+
+<p>Building and testing the client code are both done using Pants. The
relevant targets to know about
+are:</p>
+
+<ul>
+<li>Build a client executable: <code>./pants binary
src/main/python/apache/aurora/client:aurora</code></li>
+<li>Test client code: <code>./pants test
src/test/python/apache/aurora/client/cli:cli</code></li>
+</ul>
+
+<p>If you want to build a source distribution of the client, you need to run
<code>./build-support/release/make-python-sdists</code>.</p>
+
+<h2 id="creating-custom-builds">Creating Custom Builds</h2>
+
+<p>There are situations where you may want to plug in custom logic to the
Client that may not be
+applicable to the open source codebase. Rather than create a whole CLI from
scratch, you can
+easily create your own custom, drop-in replacement aurora.pex using the pants
build tool.</p>
+
+<p>First, create an AuroraCommandLine implementation as an entry-point for
registering customizations:</p>
+<pre class="highlight objective_c"><code><span style="background-color:
#f8f8f8">from</span> <span style="background-color: #f8f8f8">apache</span><span
style="background-color: #f8f8f8">.</span><span style="background-color:
#f8f8f8">aurora</span><span style="background-color: #f8f8f8">.</span><span
style="background-color: #f8f8f8">client</span><span style="background-color:
#f8f8f8">.</span><span style="background-color: #f8f8f8">cli</span><span
style="background-color: #f8f8f8">.</span><span style="background-color:
#f8f8f8">client</span> <span style="background-color: #f8f8f8">import</span>
<span style="background-color: #f8f8f8">AuroraCommandLine</span>
+
+<span style="background-color: #f8f8f8">class</span> <span
style="background-color: #f8f8f8">CustomAuroraCommandLine</span><span
style="background-color: #f8f8f8">(</span><span style="background-color:
#f8f8f8">AuroraCommandLine</span><span style="background-color:
#f8f8f8">)</span><span style="color: #000000;font-weight: bold">:</span>
+<span style="color: #d14">"""Custom AuroraCommandLine for your needs"""</span>
+
+<span style="color: #000000;font-weight: bold">@property</span>
+<span style="background-color: #f8f8f8">def</span> <span
style="background-color: #f8f8f8">name</span><span style="background-color:
#f8f8f8">(</span><span style="background-color: #f8f8f8">self</span><span
style="background-color: #f8f8f8">)</span><span style="color:
#000000;font-weight: bold">:</span>
+ <span style="color: #000000;font-weight: bold">return</span> <span
style="color: #d14">"your-company-aurora"</span>
+
+<span style="color: #a61717;background-color: #e3d2d2">@classmethod</span>
+<span style="background-color: #f8f8f8">def</span> <span
style="background-color: #f8f8f8">get_description</span><span
style="background-color: #f8f8f8">(</span><span style="background-color:
#f8f8f8">cls</span><span style="background-color: #f8f8f8">)</span><span
style="color: #000000;font-weight: bold">:</span>
+ <span style="color: #000000;font-weight: bold">return</span> <span
style="color: #a61717;background-color: #e3d2d2">'</span><span
style="background-color: #f8f8f8">Your</span> <span style="background-color:
#f8f8f8">Company</span> <span style="background-color: #f8f8f8">internal</span>
<span style="background-color: #f8f8f8">Aurora</span> <span
style="background-color: #f8f8f8">client</span> <span style="background-color:
#f8f8f8">command</span> <span style="background-color:
#f8f8f8">line</span><span style="color: #a61717;background-color:
#e3d2d2">'</span>
+
+<span style="background-color: #f8f8f8">def</span> <span
style="background-color: #f8f8f8">__init__</span><span style="background-color:
#f8f8f8">(</span><span style="background-color: #f8f8f8">self</span><span
style="background-color: #f8f8f8">)</span><span style="color:
#000000;font-weight: bold">:</span>
+ <span style="background-color: #f8f8f8">super</span><span
style="background-color: #f8f8f8">(</span><span style="background-color:
#f8f8f8">CustomAuroraCommandLine</span><span style="background-color:
#f8f8f8">,</span> <span style="background-color: #f8f8f8">self</span><span
style="background-color: #f8f8f8">).</span><span style="background-color:
#f8f8f8">__init__</span><span style="background-color: #f8f8f8">()</span>
+ <span style="color: #999999;font-weight: bold"># Add custom plugins..
+</span> <span style="background-color: #f8f8f8">self</span><span
style="background-color: #f8f8f8">.</span><span style="background-color:
#f8f8f8">register_plugin</span><span style="background-color:
#f8f8f8">(</span><span style="background-color:
#f8f8f8">YourCustomPlugin</span><span style="background-color:
#f8f8f8">())</span>
+
+<span style="background-color: #f8f8f8">def</span> <span
style="background-color: #f8f8f8">register_nouns</span><span
style="background-color: #f8f8f8">(</span><span style="background-color:
#f8f8f8">self</span><span style="background-color: #f8f8f8">)</span><span
style="color: #000000;font-weight: bold">:</span>
+ <span style="background-color: #f8f8f8">super</span><span
style="background-color: #f8f8f8">(</span><span style="background-color:
#f8f8f8">CustomAuroraCommandLine</span><span style="background-color:
#f8f8f8">,</span> <span style="background-color: #f8f8f8">self</span><span
style="background-color: #f8f8f8">).</span><span style="background-color:
#f8f8f8">register_nouns</span><span style="background-color: #f8f8f8">()</span>
+ <span style="color: #999999;font-weight: bold"># You can even add new
commands / sub-commands!
+</span> <span style="background-color: #f8f8f8">self</span><span
style="background-color: #f8f8f8">.</span><span style="background-color:
#f8f8f8">register_noun</span><span style="background-color:
#f8f8f8">(</span><span style="background-color:
#f8f8f8">YourStartUpdateProxy</span><span style="background-color:
#f8f8f8">())</span>
+ <span style="background-color: #f8f8f8">self</span><span
style="background-color: #f8f8f8">.</span><span style="background-color:
#f8f8f8">register_noun</span><span style="background-color:
#f8f8f8">(</span><span style="background-color:
#f8f8f8">YourDeployWorkflowCommand</span><span style="background-color:
#f8f8f8">())</span>
+</code></pre>
+
+<p>Secondly, create a main entry point:</p>
+<pre class="highlight plaintext"><code>def proxy_main():
+ client = CustomAuroraCommandLine()
+ if len(sys.argv) == 1:
+ sys.argv.append("-h")
+ sys.exit(client.execute(sys.argv[1:]))
+</code></pre>
+
+<p>Finally, you can wire everything up with a pants BUILD file in your project
directory:</p>
+<pre class="highlight plaintext"><code>python_binary(
+ name='aurora',
+ entry_point='your_company.aurora.client:proxy_main',
+ dependencies=[
+ ':client_lib'
+ ]
+)
+
+python_library(
+ name='client_lib',
+ sources = [
+ 'client.py',
+ 'custom_plugin.py',
+ 'custom_command.py',
+ ],
+ dependencies = [
+ # The Apache Aurora client
+ # Any other dependencies for your custom code
+ ],
+)
+</code></pre>
+
+<p>Using the same commands to build the client as above (but obviously
pointing to this BUILD file
+instead), you will have a drop-in replacement aurora.pex file with your
customizations.</p>
+
+<h2 id="running-debugging">Running/Debugging</h2>
+
+<p>For manually testing client changes against a cluster, we use <a
href="https://www.vagrantup.com/";>Vagrant</a>.
+To start a virtual cluster, you need to install Vagrant, and then run
<code>vagrant up</code> for the root of
+the aurora workspace. This will create a vagrant host named
“devcluster”, with a Mesos master, a set
+of Mesos agents, and an Aurora scheduler.</p>
+
+<p>If you have a change you would like to test in your local cluster,
you’ll rebuild the client:</p>
+<pre class="highlight plaintext"><code>vagrant ssh -c 'aurorabuild client'
+</code></pre>
+
+<p>Once this completes, the <code>aurora</code> command will reflect your
changes.</p>
+
+<h2 id="running-debugging-in-pycharm">Running/Debugging in PyCharm</h2>
+
+<p>It’s possible to use PyCharm to run and debug both the client and
client tests in an IDE. In order
+to do this, first run:</p>
+<pre class="highlight
plaintext"><code>build-support/python/make-pycharm-virtualenv
+</code></pre>
+
+<p>This script will configure a virtualenv with all of our Python
requirements. Once the script
+completes it will emit instructions for configuring PyCharm:</p>
+<pre class="highlight plaintext"><code>Your PyCharm environment is now set up.
You can open the project root
+directory with PyCharm.
+
+Once the project is loaded:
+ - open project settings
+ - click 'Project Interpreter'
+ - click the cog in the upper-right corner
+ - click 'Add Local'
+ - select 'build-support/python/pycharm.venv/bin/python'
+ - click 'OK'
+</code></pre>
+
+<h3 id="running-debugging-tests">Running/Debugging Tests</h3>
+
+<p>After following these instructions, you should now be able to run/debug
tests directly from the IDE
+by right-clicking on a test (or test class) and choosing to run or debug:</p>
+
+<p><a href="/documentation/0.17.0/images/debug-client-test.png"><img
alt="Debug Client Test" src="../../images/debug-client-test.png" /></a></p>
+
+<p>If you’ve set a breakpoint, you can see the run will now stop and let
you debug:</p>
+
+<p><a href="/documentation/0.17.0/images/debugging-client-test.png"><img
alt="Debugging Client Test" src="../../images/debugging-client-test.png"
/></a></p>
+
+<h3 id="running-debugging-the-client">Running/Debugging the Client</h3>
+
+<p>Actually running and debugging the client is unfortunately a bit more
complex. You’ll need to create
+a Run configuration:</p>
+
+<ul>
+<li>Go to Run â Edit Configurations</li>
+<li>Click the + icon to add a new configuration.</li>
+<li>Choose python and name the configuration ‘client’.</li>
+<li>Set the script path to
<code>/your/path/to/aurora/src/main/python/apache/aurora/client/cli/client.py</code></li>
+<li>Set the script parameters to the command you want to run (e.g. <code>job
status <job key></code>)</li>
+<li>Expand the Environment section and click the ellipsis to add a new
environment variable</li>
+<li>Click the + at the bottom to add a new variable named
AURORA<em>CONFIG</em>ROOT whose value is the
+path where the your cluster configuration can be found. For example, to talk
to the scheduler
+running in the vagrant image, it would be set to
<code>/your/path/to/aurora/examples/vagrant</code> (this
+is the directory where our example clusters.json is found).</li>
+<li>You should now be able to run and debug this configuration!</li>
+</ul>
+
+</div>
+
+ </div>
+ </div>
+ <div class="container-fluid section-footer buffer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-2 col-md-offset-1"><h3>Quick Links</h3>
+ <ul>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Mailing Lists</a></li>
+ <li><a
href="http://issues.apache.org/jira/browse/AURORA";>Issue Tracking</a></li>
+ <li><a href="/documentation/latest/contributing/">How
To Contribute</a></li>
+ </ul>
+ </div>
+ <div class="col-md-2"><h3>The ASF</h3>
+ <ul>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div>
+ <div class="col-md-6">
+ <p class="disclaimer">© 2014-2017 <a
href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under
the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. The <a
href="https://www.flickr.com/photos/trondk/12706051375/";>Aurora Borealis IX
photo</a> displayed on the homepage is available under a <a
href="https://creativecommons.org/licenses/by-nc-nd/2.0/";>Creative Commons
BY-NC-ND 2.0 license</a>. Apache, Apache Aurora, and the Apache feather logo
are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html>
Added:
aurora/site/publish/documentation/0.18.0/development/committers-guide/index.html
URL:
http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.18.0/development/committers-guide/index.html?rev=1799392&view=auto
==============================================================================
---
aurora/site/publish/documentation/0.18.0/development/committers-guide/index.html
(added)
+++
aurora/site/publish/documentation/0.18.0/development/committers-guide/index.html
Wed Jun 21 06:36:21 2017
@@ -0,0 +1,232 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Aurora</title>
+ <link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css";>
+ <link href="/assets/css/main.css" rel="stylesheet">
+ <!-- Analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-45879646-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <div class="container-fluid section-header">
+ <div class="container">
+ <div class="nav nav-bar">
+ <a href="/"><img src="/assets/img/aurora_logo_dkbkg.svg" width="300"
alt="Transparent Apache Aurora logo with dark background"/></a>
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/community/">Community</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/blog/">Blog</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div class="container-fluid">
+ <div class="container content">
+ <div class="col-md-12 documentation">
+<h5 class="page-header text-uppercase">Documentation
+<select onChange="window.location.href='/documentation/' + this.value +
'/development/committers-guide/'"
+ value="0.18.0">
+ <option value="0.18.0"
+ selected="selected">
+ 0.18.0
+ (latest)
+ </option>
+ <option value="0.17.0"
+ >
+ 0.17.0
+ </option>
+ <option value="0.16.0"
+ >
+ 0.16.0
+ </option>
+ <option value="0.15.0"
+ >
+ 0.15.0
+ </option>
+ <option value="0.14.0"
+ >
+ 0.14.0
+ </option>
+ <option value="0.13.0"
+ >
+ 0.13.0
+ </option>
+ <option value="0.12.0"
+ >
+ 0.12.0
+ </option>
+ <option value="0.11.0"
+ >
+ 0.11.0
+ </option>
+ <option value="0.10.0"
+ >
+ 0.10.0
+ </option>
+ <option value="0.9.0"
+ >
+ 0.9.0
+ </option>
+ <option value="0.8.0"
+ >
+ 0.8.0
+ </option>
+ <option value="0.7.0-incubating"
+ >
+ 0.7.0-incubating
+ </option>
+ <option value="0.6.0-incubating"
+ >
+ 0.6.0-incubating
+ </option>
+ <option value="0.5.0-incubating"
+ >
+ 0.5.0-incubating
+ </option>
+</select>
+</h5>
+<h1 id="committer-39-s-guide">Committer’s Guide</h1>
+
+<p>Information for official Apache Aurora committers.</p>
+
+<h2 id="setting-up-your-email-account">Setting up your email account</h2>
+
+<p>Once your Apache ID has been set up you can configure your account and add
ssh keys and setup an
+email forwarding address at</p>
+<pre class="highlight plaintext"><code>http://id.apache.org
+</code></pre>
+
+<p>Additional instructions for setting up your new committer email can be
found at</p>
+<pre class="highlight
plaintext"><code>http://www.apache.org/dev/user-email.html
+</code></pre>
+
+<p>The recommended setup is to configure all services (mailing lists, JIRA,
ReviewBoard) to send
+emails to your @apache.org email address.</p>
+
+<h2 id="creating-a-gpg-key-for-releases">Creating a gpg key for releases</h2>
+
+<p>In order to create a release candidate you will need a gpg key published to
an external key server
+and that key will need to be added to our KEYS file as well.</p>
+
+<ol>
+<li><p>Create a key:</p>
+<pre class="highlight plaintext"><code> gpg --gen-key
+</code></pre></li>
+<li><p>Add your gpg key to the Apache Aurora KEYS file:</p>
+<pre class="highlight plaintext"><code> git clone
https://git-wip-us.apache.org/repos/asf/aurora.git
+ (gpg --list-sigs <KEY ID> && gpg --armor --export <KEY
ID>) >> KEYS
+ git add KEYS && git commit -m "Adding gpg key for <APACHE
ID>"
+ ./rbt post -o -g
+</code></pre></li>
+<li><p>Publish the key to an external key server:</p>
+<pre class="highlight plaintext"><code> gpg --keyserver pgp.mit.edu
--send-keys <KEY ID>
+</code></pre></li>
+<li><p>Update the changes to the KEYS file to the Apache Aurora svn dist
locations listed below:</p>
+<pre class="highlight plaintext"><code>
https://dist.apache.org/repos/dist/dev/aurora/KEYS
+ https://dist.apache.org/repos/dist/release/aurora/KEYS
+</code></pre></li>
+<li><p>Add your key to git config for use with the release scripts:</p>
+<pre class="highlight plaintext"><code> git config --global
user.signingkey <KEY ID>
+</code></pre></li>
+</ol>
+
+<h2 id="creating-a-release">Creating a release</h2>
+
+<p>The following will guide you through the steps to create a release
candidate, vote, and finally an
+official Apache Aurora release. Before starting your gpg key should be in the
KEYS file and you
+must have access to commit to the dist.a.o repositories.</p>
+
+<ol>
+<li>Ensure that all issues resolved for this release candidate are tagged with
the correct Fix
+Version in JIRA, the changelog script will use this to generate the CHANGELOG
in step #2.
+To assign the fix version:</li>
+</ol>
+<pre class="highlight plaintext"><code>* Look up the [previous release
date](https://issues.apache.org/jira/browse/aurora/?selectedTab=com.atlassian.jira.jira-projects-plugin:versions-panel).
+* Query all issues resolved after that release date: `project = AURORA AND
status in (resolved, Closed) and fixVersion is empty and resolutiondate >=
"YYYY/MM/DD"`
+* In the upper right corner of the query result, select Tools > Bulk Edit.
+* Select all issues > edit issue > set 'Change Fix Version/s' to the
release version.
+* Make sure to uncheck 'Send mail for this update' at the bottom.
+</code></pre>
+
+<ol>
+<li><p>Prepare RELEASE-NOTES.md for the release. This just boils down to
removing the “(Not yet
+released)” suffix from the impending release.</p></li>
+<li><p>Create a release candidate. This will automatically update the
CHANGELOG and commit it, create a
+branch and update the current version within the trunk. To create a minor
version update and publish
+it run</p>
+<pre class="highlight plaintext"><code>
./build-support/release/release-candidate -l m -p
+</code></pre></li>
+<li><p>Update, if necessary, the draft email created from the
<code>release-candidate</code> script in step #2 and
+send the [VOTE] email to the dev@ mailing list. You can verify the release
signature and checksums
+by running</p>
+<pre class="highlight plaintext"><code>
./build-support/release/verify-release-candidate
+</code></pre></li>
+<li><p>Wait for the vote to complete. If the vote fails close the vote by
replying to the initial [VOTE]
+email sent in step #3 by editing the subject to [RESULT][VOTE] … and
noting the failure reason
+(example <a href="http://markmail.org/message/d4d6xtvj7vgwi76f";>here</a>).
You’ll also need to manually revert
+the commits generated by the release candidate script that incremented the
snapshot version and
+updated the changelog. Once that is done, now address any issues and go back
to step #1 and run
+again, this time you will use the -r flag to increment the release candidate
version. This will
+automatically clean up the release candidate rc0 branch and source
distribution.</p>
+<pre class="highlight plaintext"><code>
./build-support/release/release-candidate -l m -r 1 -p
+</code></pre></li>
+<li><p>Once the vote has successfully passed create the release</p></li>
+</ol>
+
+<p><strong>IMPORTANT: make sure to use the correct release at this final step
(e.g.: <code>-r 1</code> if rc1 candidate
+has been voted for). Once the release tag is pushed it will be very hard to
undo due to remote
+git pre-receive hook explicitly forbidding release tag
manipulations.</strong></p>
+<pre class="highlight plaintext"><code>
./build-support/release/release
+</code></pre>
+
+<ol>
+<li>Update the draft email created fom the <code>release</code> script in step
#5 to include the Apache ID’s for
+all binding votes and send the [RESULT][VOTE] email to the dev@ mailing
list.</li>
+</ol>
+
+</div>
+
+ </div>
+ </div>
+ <div class="container-fluid section-footer buffer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-2 col-md-offset-1"><h3>Quick Links</h3>
+ <ul>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Mailing Lists</a></li>
+ <li><a
href="http://issues.apache.org/jira/browse/AURORA";>Issue Tracking</a></li>
+ <li><a href="/documentation/latest/contributing/">How
To Contribute</a></li>
+ </ul>
+ </div>
+ <div class="col-md-2"><h3>The ASF</h3>
+ <ul>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div>
+ <div class="col-md-6">
+ <p class="disclaimer">© 2014-2017 <a
href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under
the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. The <a
href="https://www.flickr.com/photos/trondk/12706051375/";>Aurora Borealis IX
photo</a> displayed on the homepage is available under a <a
href="https://creativecommons.org/licenses/by-nc-nd/2.0/";>Creative Commons
BY-NC-ND 2.0 license</a>. Apache, Apache Aurora, and the Apache feather logo
are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html>
Added:
aurora/site/publish/documentation/0.18.0/development/db-migration/index.html
URL:
http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.18.0/development/db-migration/index.html?rev=1799392&view=auto
==============================================================================
---
aurora/site/publish/documentation/0.18.0/development/db-migration/index.html
(added)
+++
aurora/site/publish/documentation/0.18.0/development/db-migration/index.html
Wed Jun 21 06:36:21 2017
@@ -0,0 +1,167 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Aurora</title>
+ <link rel="stylesheet"
href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css";>
+ <link href="/assets/css/main.css" rel="stylesheet">
+ <!-- Analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-45879646-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <div class="container-fluid section-header">
+ <div class="container">
+ <div class="nav nav-bar">
+ <a href="/"><img src="/assets/img/aurora_logo_dkbkg.svg" width="300"
alt="Transparent Apache Aurora logo with dark background"/></a>
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/community/">Community</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/blog/">Blog</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div class="container-fluid">
+ <div class="container content">
+ <div class="col-md-12 documentation">
+<h5 class="page-header text-uppercase">Documentation
+<select onChange="window.location.href='/documentation/' + this.value +
'/development/db-migration/'"
+ value="0.18.0">
+ <option value="0.18.0"
+ selected="selected">
+ 0.18.0
+ (latest)
+ </option>
+ <option value="0.17.0"
+ >
+ 0.17.0
+ </option>
+ <option value="0.16.0"
+ >
+ 0.16.0
+ </option>
+ <option value="0.15.0"
+ >
+ 0.15.0
+ </option>
+ <option value="0.14.0"
+ >
+ 0.14.0
+ </option>
+ <option value="0.13.0"
+ >
+ 0.13.0
+ </option>
+ <option value="0.12.0"
+ >
+ 0.12.0
+ </option>
+ <option value="0.11.0"
+ >
+ 0.11.0
+ </option>
+ <option value="0.10.0"
+ >
+ 0.10.0
+ </option>
+ <option value="0.9.0"
+ >
+ 0.9.0
+ </option>
+ <option value="0.8.0"
+ >
+ 0.8.0
+ </option>
+ <option value="0.7.0-incubating"
+ >
+ 0.7.0-incubating
+ </option>
+ <option value="0.6.0-incubating"
+ >
+ 0.6.0-incubating
+ </option>
+ <option value="0.5.0-incubating"
+ >
+ 0.5.0-incubating
+ </option>
+</select>
+</h5>
+<h1 id="db-migrations">DB Migrations</h1>
+
+<p>Changes to the DB schema should be made in the form of migrations. This
ensures that all changes
+are applied correctly after a DB dump from a previous version is restored.</p>
+
+<p>DB migrations are managed through a system built on top of
+<a href="http://www.mybatis.org/migrations/";>MyBatis Migrations</a>. The
migrations are run automatically when
+a snapshot is restored, no manual interaction is required by cluster
operators.</p>
+
+<h2 id="upgrades">Upgrades</h2>
+
+<p>When adding or altering tables or changing data, in addition to making to
change in
+<a
href="../../src/main/resources/org/apache/aurora/scheduler/storage/db/schema.sql">schema.sql</a>,
a new
+migration class should be created under the
org.apache.aurora.scheduler.storage.db.migration
+package. The class should implement the <a
href="https://github.com/mybatis/migrations/blob/master/src/main/java/org/apache/ibatis/migration/MigrationScript.java";>MigrationScript</a>
+interface (see <a
href="https://github.com/apache/aurora/blob/rel/0.18.0/src/test/java/org/apache/aurora/scheduler/storage/db/testmigration/V001_TestMigration.java";>V001_TestMigration</a>
+as an example). The upgrade and downgrade scripts are defined in this class.
When restoring a
+snapshot the list of migrations on the classpath is compared to the list of
applied changes in the
+DB. Any changes that have not yet been applied are executed and their
downgrade script is stored
+alongside the changelog entry in the database to faciliate downgrades in the
event of a rollback.</p>
+
+<h2 id="downgrades">Downgrades</h2>
+
+<p>If, while running migrations, a rollback is detected, i.e. a change exists
in the DB changelog that
+does not exist on the classpath, the downgrade script associated with each
affected change is
+applied.</p>
+
+<h2 id="baselines">Baselines</h2>
+
+<p>After enough time has passed (at least 1 official release), it should be
safe to baseline migrations
+if desired. This can be accomplished by ensuring the changes from migrations
have been applied to
+<a
href="../../src/main/resources/org/apache/aurora/scheduler/storage/db/schema.sql">schema.sql</a>
and then
+removing the corresponding migration classes and adding a migration to remove
the changelog entries.</p>
+
+</div>
+
+ </div>
+ </div>
+ <div class="container-fluid section-footer buffer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-2 col-md-offset-1"><h3>Quick Links</h3>
+ <ul>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Mailing Lists</a></li>
+ <li><a
href="http://issues.apache.org/jira/browse/AURORA";>Issue Tracking</a></li>
+ <li><a href="/documentation/latest/contributing/">How
To Contribute</a></li>
+ </ul>
+ </div>
+ <div class="col-md-2"><h3>The ASF</h3>
+ <ul>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div>
+ <div class="col-md-6">
+ <p class="disclaimer">© 2014-2017 <a
href="http://www.apache.org/";>Apache Software Foundation</a>. Licensed under
the <a href="http://www.apache.org/licenses/";>Apache License v2.0</a>. The <a
href="https://www.flickr.com/photos/trondk/12706051375/";>Aurora Borealis IX
photo</a> displayed on the homepage is available under a <a
href="https://creativecommons.org/licenses/by-nc-nd/2.0/";>Creative Commons
BY-NC-ND 2.0 license</a>. Apache, Apache Aurora, and the Apache feather logo
are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html>
