Modified: aurora/site/publish/documentation/0.9.0/configuration-tutorial/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/configuration-tutorial/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/configuration-tutorial/index.html (original) +++ aurora/site/publish/documentation/0.9.0/configuration-tutorial/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/configuration-tutorial/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" >
Modified: aurora/site/publish/documentation/0.9.0/contributing/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/contributing/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/contributing/index.html (original) +++ aurora/site/publish/documentation/0.9.0/contributing/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/contributing/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/cron-jobs/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/cron-jobs/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/cron-jobs/index.html (original) +++ aurora/site/publish/documentation/0.9.0/cron-jobs/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/cron-jobs/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/deploying-aurora-scheduler/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/deploying-aurora-scheduler/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/deploying-aurora-scheduler/index.html (original) +++ aurora/site/publish/documentation/0.9.0/deploying-aurora-scheduler/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/deploying-aurora-scheduler/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/design/command-hooks/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/design/command-hooks/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/design/command-hooks/index.html (original) +++ aurora/site/publish/documentation/0.9.0/design/command-hooks/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/design/command-hooks/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/developing-aurora-client/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/developing-aurora-client/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/developing-aurora-client/index.html (original) +++ aurora/site/publish/documentation/0.9.0/developing-aurora-client/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/developing-aurora-client/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/developing-aurora-scheduler/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/developing-aurora-scheduler/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/developing-aurora-scheduler/index.html (original) +++ aurora/site/publish/documentation/0.9.0/developing-aurora-scheduler/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/developing-aurora-scheduler/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/hooks/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/hooks/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/hooks/index.html (original) +++ aurora/site/publish/documentation/0.9.0/hooks/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/hooks/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/index.html (original) +++ aurora/site/publish/documentation/0.9.0/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/monitoring/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/monitoring/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/monitoring/index.html (original) +++ aurora/site/publish/documentation/0.9.0/monitoring/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/monitoring/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/presentations/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/presentations/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/presentations/index.html (original) +++ aurora/site/publish/documentation/0.9.0/presentations/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/presentations/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/resource-isolation/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/resource-isolation/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/resource-isolation/index.html (original) +++ aurora/site/publish/documentation/0.9.0/resource-isolation/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/resource-isolation/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/scheduler-storage/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/scheduler-storage/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/scheduler-storage/index.html (original) +++ aurora/site/publish/documentation/0.9.0/scheduler-storage/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/scheduler-storage/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/security/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/security/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/security/index.html (original) +++ aurora/site/publish/documentation/0.9.0/security/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/security/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/sla/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/sla/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/sla/index.html (original) +++ aurora/site/publish/documentation/0.9.0/sla/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/sla/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/storage-config/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/storage-config/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/storage-config/index.html (original) +++ aurora/site/publish/documentation/0.9.0/storage-config/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/storage-config/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/storage/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/storage/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/storage/index.html (original) +++ aurora/site/publish/documentation/0.9.0/storage/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/storage/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/test-resource-generation/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/test-resource-generation/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/test-resource-generation/index.html (original) +++ aurora/site/publish/documentation/0.9.0/test-resource-generation/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/test-resource-generation/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/thrift-deprecation/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/thrift-deprecation/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/thrift-deprecation/index.html (original) +++ aurora/site/publish/documentation/0.9.0/thrift-deprecation/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/thrift-deprecation/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/tutorial/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/tutorial/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/tutorial/index.html (original) +++ aurora/site/publish/documentation/0.9.0/tutorial/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/tutorial/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/user-guide/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/user-guide/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/user-guide/index.html (original) +++ aurora/site/publish/documentation/0.9.0/user-guide/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/user-guide/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/0.9.0/vagrant/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/0.9.0/vagrant/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/0.9.0/vagrant/index.html (original) +++ aurora/site/publish/documentation/0.9.0/vagrant/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/vagrant/'" value="0.9.0"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/additional-resources/presentations/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/additional-resources/presentations/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/additional-resources/presentations/index.html (original) +++ aurora/site/publish/documentation/latest/additional-resources/presentations/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/additional-resources/presentations/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/additional-resources/tools/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/additional-resources/tools/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/additional-resources/tools/index.html (original) +++ aurora/site/publish/documentation/latest/additional-resources/tools/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/additional-resources/tools/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -150,7 +154,7 @@ <li><p>Thrift Clients:</p> <ul> -<li><a href="https://github.com/rdelval/gorealis";>gorealis</a> for communicating with the scheduler using Go</li> +<li><a href="https://github.com/paypal/gorealis";>gorealis</a> for communicating with the scheduler using Go</li> </ul></li> </ul> Modified: aurora/site/publish/documentation/latest/contributing/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/contributing/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/contributing/index.html (original) +++ aurora/site/publish/documentation/latest/contributing/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/contributing/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -119,7 +123,7 @@ <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 +<pre class="highlight plaintext"><code>git clone https://gitbox.apache.org/repos/asf/aurora </code></pre> <h2 id="read-the-style-guides">Read the Style Guides</h2> @@ -156,8 +160,8 @@ Subsequent runs will cache your login cr <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>If you’re unsure about who to add as a reviewer, you can default to adding Stephan Erb (StephanErb) and +Renan DelValle (rdelvalle). 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> Modified: aurora/site/publish/documentation/latest/development/client/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/client/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/client/index.html (original) +++ aurora/site/publish/documentation/latest/development/client/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/client/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/development/committers-guide/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/committers-guide/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/committers-guide/index.html (original) +++ aurora/site/publish/documentation/latest/development/committers-guide/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/committers-guide/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -144,7 +148,7 @@ and that key will need to be added to ou <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 +<pre class="highlight plaintext"><code> git clone https://gitbox.apache.org/repos/asf/aurora (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 Modified: aurora/site/publish/documentation/latest/development/db-migration/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/db-migration/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/db-migration/index.html (original) +++ aurora/site/publish/documentation/latest/development/db-migration/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/db-migration/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -131,7 +135,7 @@ a snapshot is restored, no manual intera <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.20.0/src/test/java/org/apache/aurora/scheduler/storage/db/testmigration/V001_TestMigration.java";>V001_TestMigration</a> +interface (see <a href="https://github.com/apache/aurora/blob/master/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 Modified: aurora/site/publish/documentation/latest/development/design-documents/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/design-documents/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/design-documents/index.html (original) +++ aurora/site/publish/documentation/latest/development/design-documents/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/design-documents/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/development/design/command-hooks/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/design/command-hooks/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/design/command-hooks/index.html (original) +++ aurora/site/publish/documentation/latest/development/design/command-hooks/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/design/command-hooks/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/development/scheduler/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/scheduler/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/scheduler/index.html (original) +++ aurora/site/publish/documentation/latest/development/scheduler/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/scheduler/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/development/thermos/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/thermos/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/thermos/index.html (original) +++ aurora/site/publish/documentation/latest/development/thermos/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/thermos/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/development/thrift/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/thrift/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/thrift/index.html (original) +++ aurora/site/publish/documentation/latest/development/thrift/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/thrift/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -123,7 +127,7 @@ client/server RPC protocol as well as fo correctly handling additions and renames of the existing members, field removals must be done carefully to ensure backwards compatibility and provide predictable deprecation cycle. This document describes general guidelines for making Thrift schema changes to the existing fields in -<a href="https://github.com/apache/aurora/blob/rel/0.20.0/api/src/main/thrift/org/apache/aurora/gen/api.thrift";>api.thrift</a>.</p> +<a href="https://github.com/apache/aurora/blob/master/api/src/main/thrift/org/apache/aurora/gen/api.thrift";>api.thrift</a>.</p> <p>It is highly recommended to go through the <a href="http://diwakergupta.github.io/thrift-missing-guide/";>Thrift: The Missing Guide</a> first to refresh on @@ -151,7 +155,7 @@ communicate with scheduler/client from v * Add a new field as an eventual replacement of the old one and implement a dual read/write anywhere the old field is used. If a thrift struct is mapped in the DB store make sure both columns are marked as <code>NOT NULL</code> -* Check <a href="https://github.com/apache/aurora/blob/rel/0.20.0/api/src/main/thrift/org/apache/aurora/gen/storage.thrift";>storage.thrift</a> to see if +* Check <a href="https://github.com/apache/aurora/blob/master/api/src/main/thrift/org/apache/aurora/gen/storage.thrift";>storage.thrift</a> to see if the affected struct is stored in Aurora scheduler storage. If so, it’s almost certainly also necessary to perform a <a href="../db-migration/">DB migration</a>. * Add a deprecation jira ticket into the vCurrent+1 release candidate Modified: aurora/site/publish/documentation/latest/development/ui/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/development/ui/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/development/ui/index.html (original) +++ aurora/site/publish/documentation/latest/development/ui/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/development/ui/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/constraints/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/constraints/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/constraints/index.html (original) +++ aurora/site/publish/documentation/latest/features/constraints/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/constraints/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/containers/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/containers/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/containers/index.html (original) +++ aurora/site/publish/documentation/latest/features/containers/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/containers/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/cron-jobs/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/cron-jobs/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/cron-jobs/index.html (original) +++ aurora/site/publish/documentation/latest/features/cron-jobs/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/cron-jobs/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/custom-executors/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/custom-executors/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/custom-executors/index.html (original) +++ aurora/site/publish/documentation/latest/features/custom-executors/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/custom-executors/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/job-updates/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/job-updates/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/job-updates/index.html (original) +++ aurora/site/publish/documentation/latest/features/job-updates/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/job-updates/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -185,7 +189,7 @@ acknowledging (“heartbeating&rdquo service updates where explicit job health monitoring is vital during the entire job update lifecycle. Such job updates would rely on an external service (or a custom client) periodically pulsing an active coordinated job update via a -<a href="https://github.com/apache/aurora/blob/rel/0.20.0/api/src/main/thrift/org/apache/aurora/gen/api.thrift";>pulseJobUpdate RPC</a>.</p> +<a href="https://github.com/apache/aurora/blob/master/api/src/main/thrift/org/apache/aurora/gen/api.thrift";>pulseJobUpdate RPC</a>.</p> <p>A coordinated update is defined by setting a positive <a href="../../reference/configuration/#updateconfig-objects">pulse<em>interval</em>secs</a> value in job configuration @@ -198,6 +202,17 @@ progress until the first pulse arrives. <code>ROLL_BACK_PAUSED</code>) is still considered active and upon resuming will immediately make progress provided the pulse interval has not expired.</p> +<h2 id="sla-aware-updates">SLA-Aware Updates</h2> + +<p>Updates can take advantage of <a href="../../features/sla-requirements/">Custom SLA Requirements</a> and +specify the <code>sla_aware=True</code> option within +<a href="../../reference/configuration/#updateconfig-objects">UpdateConfig</a> to only update instances if +the action will maintain the task’s SLA requirements. This feature allows updates to avoid killing +too many instances in the face of unexpected failures outside of the update range.</p> + +<p>See the <a href="../../reference/configuration/#using-the-sla-aware-option">Using the <code>sla_aware</code> option</a> +for more information on how to use this feature.</p> + <h2 id="canary-deployments">Canary Deployments</h2> <p>Canary deployments are a pattern for rolling out updates to a subset of job instances, Modified: aurora/site/publish/documentation/latest/features/mesos-fetcher/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/mesos-fetcher/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/mesos-fetcher/index.html (original) +++ aurora/site/publish/documentation/latest/features/mesos-fetcher/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/mesos-fetcher/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/multitenancy/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/multitenancy/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/multitenancy/index.html (original) +++ aurora/site/publish/documentation/latest/features/multitenancy/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/multitenancy/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/resource-isolation/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/resource-isolation/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/resource-isolation/index.html (original) +++ aurora/site/publish/documentation/latest/features/resource-isolation/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/resource-isolation/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/service-discovery/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/service-discovery/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/service-discovery/index.html (original) +++ aurora/site/publish/documentation/latest/features/service-discovery/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/service-discovery/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/services/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/services/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/services/index.html (original) +++ aurora/site/publish/documentation/latest/features/services/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/services/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/features/sla-metrics/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/sla-metrics/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/sla-metrics/index.html (original) +++ aurora/site/publish/documentation/latest/features/sla-metrics/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/sla-metrics/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -186,7 +190,7 @@ relevant to uptime calculations. By appl transition records, we can build a deterministic downtime trace for every given service instance.</p> <p>A task going through a state transition carries one of three possible SLA meanings -(see <a href="https://github.com/apache/aurora/blob/rel/0.20.0/src/main/java/org/apache/aurora/scheduler/sla/SlaAlgorithm.java";>SlaAlgorithm.java</a> for +(see <a href="https://github.com/apache/aurora/blob/master/src/main/java/org/apache/aurora/scheduler/sla/SlaAlgorithm.java";>SlaAlgorithm.java</a> for sla-to-task-state mapping):</p> <ul> @@ -236,7 +240,7 @@ metric that helps track the dependency o <li>Per job - <code>sla_<job_key>_mtta_ms</code></li> <li>Per cluster - <code>sla_cluster_mtta_ms</code></li> <li>Per instance size (small, medium, large, x-large, xx-large). Size are defined in: -<a href="https://github.com/apache/aurora/blob/rel/0.20.0/src/main/java/org/apache/aurora/scheduler/resources/ResourceBag.java";>ResourceBag.java</a> +<a href="https://github.com/apache/aurora/blob/master/src/main/java/org/apache/aurora/scheduler/resources/ResourceBag.java";>ResourceBag.java</a> <ul> <li>By CPU:</li> @@ -278,7 +282,7 @@ for a task.</em></p> <li>Per job - <code>sla_<job_key>_mtts_ms</code></li> <li>Per cluster - <code>sla_cluster_mtts_ms</code></li> <li>Per instance size (small, medium, large, x-large, xx-large). Size are defined in: -<a href="https://github.com/apache/aurora/blob/rel/0.20.0/src/main/java/org/apache/aurora/scheduler/resources/ResourceBag.java";>ResourceBag.java</a> +<a href="https://github.com/apache/aurora/blob/master/src/main/java/org/apache/aurora/scheduler/resources/ResourceBag.java";>ResourceBag.java</a> <ul> <li>By CPU:</li> @@ -318,7 +322,7 @@ reflecting on the overall time it takes <li>Per job - <code>sla_<job_key>_mttr_ms</code></li> <li>Per cluster - <code>sla_cluster_mttr_ms</code></li> <li>Per instance size (small, medium, large, x-large, xx-large). Size are defined in: -<a href="https://github.com/apache/aurora/blob/rel/0.20.0/src/main/java/org/apache/aurora/scheduler/resources/ResourceBag.java";>ResourceBag.java</a> +<a href="https://github.com/apache/aurora/blob/master/src/main/java/org/apache/aurora/scheduler/resources/ResourceBag.java";>ResourceBag.java</a> <ul> <li>By CPU:</li> Modified: aurora/site/publish/documentation/latest/features/webhooks/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/features/webhooks/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/features/webhooks/index.html (original) +++ aurora/site/publish/documentation/latest/features/webhooks/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/features/webhooks/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/getting-started/overview/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/getting-started/overview/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/getting-started/overview/index.html (original) +++ aurora/site/publish/documentation/latest/getting-started/overview/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/getting-started/overview/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/getting-started/tutorial/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/getting-started/tutorial/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/getting-started/tutorial/index.html (original) +++ aurora/site/publish/documentation/latest/getting-started/tutorial/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/getting-started/tutorial/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/getting-started/vagrant/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/getting-started/vagrant/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/getting-started/vagrant/index.html (original) +++ aurora/site/publish/documentation/latest/getting-started/vagrant/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/getting-started/vagrant/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/index.html (original) +++ aurora/site/publish/documentation/latest/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -150,6 +154,7 @@ the <code>#aurora</code> IRC channel on <li><a href="features/services/">Services</a></li> <li><a href="features/service-discovery/">Service Discovery</a></li> <li><a href="features/sla-metrics/">SLA Metrics</a></li> +<li><a href="features/sla-requirements/">SLA Requirements</a></li> <li><a href="features/webhooks/">Webhooks</a></li> </ul> Modified: aurora/site/publish/documentation/latest/operations/backup-restore/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/backup-restore/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/backup-restore/index.html (original) +++ aurora/site/publish/documentation/latest/operations/backup-restore/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/backup-restore/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -136,86 +140,69 @@ so any tasks that have been rescheduled <p>Instructions below have been verified in <a href="../../getting-started/vagrant/">Vagrant environment</a> and with minor syntax/path changes should be applicable to any Aurora cluster.</p> -<h2 id="preparation">Preparation</h2> - <p>Follow these steps to prepare the cluster for restoring from a backup:</p> -<ul> -<li><p>Stop all scheduler instances</p></li> -<li><p>Consider blocking external traffic on a port defined in <code>-http_port</code> for all schedulers to -prevent users from interacting with the scheduler during the restoration process. This will help -troubleshooting by reducing the scheduler log noise and prevent users from making changes that will -be erased after the backup snapshot is restored.</p></li> -<li><p>Configure <code>aurora_admin</code> access to run all commands listed in -<a href="#restore-from-backup">Restore from backup</a> section locally on the leading scheduler:</p> - -<ul> -<li>Make sure the <a href="../../reference/client-cluster-configuration/">clusters.json</a> file configured to -access scheduler directly. Set <code>scheduler_uri</code> setting and remove <code>zk</code>. Since leader can get -re-elected during the restore steps, consider doing it on all scheduler replicas.</li> -<li><p>Depending on your particular security approach you will need to either turn off scheduler -authorization by removing scheduler <code>-http_authentication_mechanism</code> flag or make sure the -direct scheduler access is properly authorized. E.g.: in case of Kerberos you will need to make -a <code>/etc/hosts</code> file change to match your local IP to the scheduler URL configured in keytabs:</p> - -<p><local_ip> <scheduler_domain_in_keytabs></p></li> -</ul></li> -<li><p>Next steps are required to put scheduler into a partially disabled state where it would still be -able to accept storage recovery requests but unable to schedule or change task states. This may be -accomplished by updating the following scheduler configuration options:</p> +<h2 id="preparation">Preparation</h2> <ul> -<li>Set <code>-mesos_master_address</code> to a non-existent zk address. This will prevent scheduler from -registering with Mesos. E.g.: <code>-mesos_master_address=zk://localhost:1111/mesos/master</code></li> -<li><code>-max_registration_delay</code> - set to sufficiently long interval to prevent registration timeout -and as a result scheduler suicide. E.g: <code>-max_registration_delay=360mins</code></li> -<li>Make sure <code>-reconciliation_initial_delay</code> option is set high enough (e.g.: <code>365days</code>) to -prevent accidental task GC. This is important as scheduler will attempt to reconcile the cluster -state and will kill all tasks when restarted with an empty Mesos replicated log.</li> -</ul></li> -<li><p>Restart all schedulers</p></li> +<li><p>Stop all scheduler instances.</p></li> +<li><p>Pick a backup to use for rehydrating the mesos-replicated log. Backups can be found in the +directory given to the scheduler as the <code>-backup_dir</code> argument. Backups are stored in the format +<code>scheduler-backup-<yyyy-MM-dd-HH-mm></code>.</p></li> +<li><p>If running the Aurora Scheduler in HA mode, pick a single scheduler instance to rehydrate.</p></li> +<li><p>Locate the <code>recovery-tool</code> in your setup. If Aurora was installed using a Debian package +generated by our <code>aurora-packaging</code> script, the recovery tool can be found +in <code>/usr/share/aurora/bin/recovery-tool</code>.</p></li> </ul> -<h2 id="cleanup-and-re-initialize-mesos-replicated-log">Cleanup and re-initialize Mesos replicated log</h2> - -<p>Get rid of the corrupted files and re-initialize Mesos replicated log:</p> +<h2 id="cleanup">Cleanup</h2> <ul> -<li>Stop schedulers</li> -<li>Delete all files under <code>-native_log_file_path</code> on all schedulers</li> -<li>Initialize Mesos replica’s log file: <code>sudo mesos-log initialize --path=<-native_log_file_path></code></li> -<li>Start schedulers</li> +<li><p>Delete (or move) the Mesos replicated log path for each scheduler instance. The location of the +Mesos replicated log file path can be found by looking at the value given to the flag +<code>-native_log_file_path</code> for each instance.</p></li> +<li><p>Initialize the Mesos replicated log files using the mesos-log tool: +<code> +sudo su -u <USER> mesos-log initialize --path=<native_log_file_path> +</code> +Where <code>USER</code> is the user under which the scheduler instance will be run. For installations using +Debian packages, the default user will be <code>aurora</code>. You may alternatively choose to specify +a group as well by passing the <code>-g <GROUP></code> option to <code>su</code>. +Note that if the user under which the Aurora scheduler instance is run <em>does not</em> have permissions +to read this directory and the files it contains, the instance will fail to start.</p></li> </ul> <h2 id="restore-from-backup">Restore from backup</h2> -<p>At this point the scheduler is ready to rehydrate from the backup:</p> - <ul> -<li><p>Identify the leading scheduler by:</p> +<li>Run the <code>recovery-tool</code>. Wherever the flags match those used for the scheduler instance, +use the same values: +<code> +$ recovery-tool -from BACKUP \ +-to LOG \ +-backup=<selected_backup_location> \ +-native_log_zk_group_path=<native_log_zk_group_path> \ +-native_log_file_path=<native_log_file_path> \ +-zk_endpoints=<zk_endpoints> +</code></li> +</ul> + +<h2 id="bring-scheduler-instances-back-online">Bring scheduler instances back online</h2> + +<h3 id="if-running-in-ha-mode">If running in HA Mode</h3> <ul> -<li>examining the <code>scheduler_lifecycle_LEADER_AWAITING_REGISTRATION</code> metric at the scheduler -<code>/vars</code> endpoint. Leader will have 1. All other replicas - 0.</li> -<li>examining scheduler logs</li> -<li>or examining Zookeeper registration under the path defined by <code>-zk_endpoints</code> -and <code>-serverset_path</code></li> -</ul></li> -<li><p>Locate the desired backup file, copy it to the leading scheduler’s <code>-backup_dir</code> folder and stage -recovery by running the following command on a leader -<code>aurora_admin scheduler_stage_recovery --bypass-leader-redirect <cluster> scheduler-backup-<yyyy-MM-dd-HH-mm></code></p></li> -<li><p>At this point, the recovery snapshot is staged and available for manual verification/modification -via <code>aurora_admin scheduler_print_recovery_tasks --bypass-leader-redirect</code> and -<code>scheduler_delete_recovery_tasks --bypass-leader-redirect</code> commands. -See <code>aurora_admin help <command></code> for usage details.</p></li> -<li><p>Commit recovery. This instructs the scheduler to overwrite the existing Mesos replicated log with -the provided backup snapshot and initiate a mandatory failover -<code>aurora_admin scheduler_commit_recovery --bypass-leader-redirect <cluster></code></p></li> +<li><p>Start the rehydrated scheduler instance along with enough cleaned up instances to +meet the <code>-native_log_quorum_size</code>. The mesos-replicated log algorithm will replenish +the “blank” scheduler instances with the information from the rehydrated instance.</p></li> +<li><p>Start any remaining scheduler instances.</p></li> </ul> -<h2 id="cleanup">Cleanup</h2> +<h3 id="if-running-in-singleton-mode">If running in singleton mode</h3> -<p>Undo any modification done during <a href="#preparation">Preparation</a> sequence.</p> +<ul> +<li>Start the single scheduler instance.</li> +</ul> </div> Modified: aurora/site/publish/documentation/latest/operations/configuration/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/configuration/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/configuration/index.html (original) +++ aurora/site/publish/documentation/latest/operations/configuration/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/configuration/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -241,7 +245,7 @@ can furthermore help with storage perfor <p>ZooKeeper path used for Mesos replicated log quorum discovery.</p> -<p>See <a href="https://github.com/apache/aurora/blob/rel/0.20.0/src/main/java/org/apache/aurora/scheduler/log/mesos/MesosLogStreamModule.java";>code</a> for +<p>See <a href="https://github.com/apache/aurora/blob/master/src/main/java/org/apache/aurora/scheduler/log/mesos/MesosLogStreamModule.java";>code</a> for other available Mesos replicated log configuration options and default values.</p> <h3 id="changing-the-quorum-size">Changing the Quorum Size</h3> @@ -309,7 +313,7 @@ the latter needs to be enabled via:</p> <pre class="highlight plaintext"><code>-enable_revocable_ram=true </code></pre> -<p>Unless you want to use the <a href="https://github.com/apache/aurora/blob/rel/0.20.0/src/main/resources/org/apache/aurora/scheduler/tiers.json";>default</a> +<p>Unless you want to use the <a href="https://github.com/apache/aurora/blob/master/src/main/resources/org/apache/aurora/scheduler/tiers.json";>default</a> tier configuration, you will also have to specify a file path:</p> <pre class="highlight plaintext"><code>-tier_config=path/to/tiers/config.json </code></pre> @@ -453,19 +457,19 @@ attempt to reuse the same agent for the increased).</p> <p>To enable this in the Scheduler, you can set the following options:</p> -<pre class="highlight plaintext"><code>--enable_update_affinity=true ---update_affinity_reservation_hold_time=3mins +<pre class="highlight plaintext"><code>-enable_update_affinity=true +-update_affinity_reservation_hold_time=3mins </code></pre> <p>You will need to tune the hold time to match the behavior you see in your cluster. If you have extremely high update throughput, you might have to extend it as processing updates could easily add significant delays between scheduling attempts. You may also have to tune scheduling parameters to achieve the throughput you need in your cluster. Some relevant settings (with defaults) are:</p> -<pre class="highlight plaintext"><code>--max_schedule_attempts_per_sec=40 ---initial_schedule_penalty=1secs ---max_schedule_penalty=1mins ---scheduling_max_batch_size=3 ---max_tasks_per_schedule_attempt=5 +<pre class="highlight plaintext"><code>-max_schedule_attempts_per_sec=40 +-initial_schedule_penalty=1secs +-max_schedule_penalty=1mins +-scheduling_max_batch_size=3 +-max_tasks_per_schedule_attempt=5 </code></pre> <p>There are metrics exposed by the Scheduler which can provide guidance on where the bottleneck is. @@ -480,6 +484,46 @@ Example metrics to look at:</p> before you run into any other limits. So if your total work done per minute starts to exceed 2k instances, you may need to extend the update<em>affinity</em>reservation<em>hold</em>time.</p> +<h2 id="cluster-maintenance">Cluster Maintenance</h2> + +<p>Aurora performs maintenance related task drains. One of the scheduler options that can control +how often the scheduler polls for maintenance work can be controlled via,</p> +<pre class="highlight plaintext"><code>-host_maintenance_polling_interval=1min +</code></pre> + +<h2 id="enforcing-sla-limitations">Enforcing SLA limitations</h2> + +<p>Since tasks can specify their own <code>SLAPolicy</code>, the cluster needs to limit these SLA requirements. +Too aggressive a requirement can permanently block any type of maintenance work +(ex: OS/Kernel/Security upgrades) on a host and hold it hostage.</p> + +<p>An operator can control the limits for SLA requirements via these scheduler configuration options:</p> +<pre class="highlight plaintext"><code>-max_sla_duration_secs=2hrs +-min_required_instances_for_sla_check=20 +</code></pre> + +<p><em>Note: These limits only apply for <code>CountSlaPolicy</code> and <code>PercentageSlaPolicy</code>.</em></p> + +<h3 id="limiting-coordinator-sla">Limiting Coordinator SLA</h3> + +<p>With <code>CoordinatorSlaPolicy</code> the SLA calculation is off-loaded to an external HTTP service. Some +relevant scheduler configuration options are,</p> +<pre class="highlight plaintext"><code>-sla_coordinator_timeout=1min +-max_parallel_coordinated_maintenance=10 +</code></pre> + +<p>Since handing off the SLA calculation to an external service can potentially block maintenance +on hosts for an indefinite amount of time (either due to a mis-configured coordinator or due to +a valid degraded service). In those situations the following metrics will be helpful to identify the +offending tasks.</p> +<pre class="highlight plaintext"><code>sla_coordinator_user_errors_* (counter tracking number of times the coordinator for the task + returned a bad response.) +sla_coordinator_errors_* (counter tracking number of times the scheduler was not able + to communicate with the coordinator of the task.) +sla_coordinator_lock_starvation_* (counter tracking number of times the scheduler was not able to + get the lock for the coordinator of the task.) +</code></pre> + </div> </div> Modified: aurora/site/publish/documentation/latest/operations/installation/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/installation/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/installation/index.html (original) +++ aurora/site/publish/documentation/latest/operations/installation/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/installation/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/operations/monitoring/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/monitoring/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/monitoring/index.html (original) +++ aurora/site/publish/documentation/latest/operations/monitoring/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/monitoring/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/operations/security/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/security/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/security/index.html (original) +++ aurora/site/publish/documentation/latest/operations/security/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/security/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/operations/storage/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/storage/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/storage/index.html (original) +++ aurora/site/publish/documentation/latest/operations/storage/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/storage/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/operations/troubleshooting/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/troubleshooting/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/troubleshooting/index.html (original) +++ aurora/site/publish/documentation/latest/operations/troubleshooting/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/troubleshooting/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/operations/upgrades/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/operations/upgrades/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/operations/upgrades/index.html (original) +++ aurora/site/publish/documentation/latest/operations/upgrades/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/operations/upgrades/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/reference/client-cluster-configuration/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/client-cluster-configuration/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/client-cluster-configuration/index.html (original) +++ aurora/site/publish/documentation/latest/reference/client-cluster-configuration/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/client-cluster-configuration/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/reference/client-commands/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/client-commands/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/client-commands/index.html (original) +++ aurora/site/publish/documentation/latest/reference/client-commands/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/client-commands/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/reference/client-hooks/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/client-hooks/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/client-hooks/index.html (original) +++ aurora/site/publish/documentation/latest/reference/client-hooks/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/client-hooks/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/reference/configuration-best-practices/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/configuration-best-practices/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/configuration-best-practices/index.html (original) +++ aurora/site/publish/documentation/latest/reference/configuration-best-practices/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/configuration-best-practices/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/reference/configuration-templating/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/configuration-templating/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/configuration-templating/index.html (original) +++ aurora/site/publish/documentation/latest/reference/configuration-templating/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/configuration-templating/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/reference/configuration-tutorial/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/configuration-tutorial/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/configuration-tutorial/index.html (original) +++ aurora/site/publish/documentation/latest/reference/configuration-tutorial/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/configuration-tutorial/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > Modified: aurora/site/publish/documentation/latest/reference/configuration/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/configuration/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/configuration/index.html (original) +++ aurora/site/publish/documentation/latest/reference/configuration/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/configuration/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" > @@ -149,6 +153,7 @@ configuration design.</p> <li><a href="#announcer-objects">Announcer Objects</a></li> <li><a href="#container">Container Objects</a></li> <li><a href="#lifecycleconfig-objects">LifecycleConfig Objects</a></li> +<li><a href="#slapolicy-objects">SlaPolicy Objects</a></li> </ul></li> <li><a href="#specifying-scheduling-constraints">Specifying Scheduling Constraints</a></li> <li><a href="#template-namespaces">Template Namespaces</a> @@ -646,7 +651,7 @@ resources are allocated.</p> <tr> <td><code>cron_collision_policy</code></td> <td style="text-align: center">String</td> -<td>Policy to use when a cron job is triggered while a previous run is still active. KILL<em>EXISTING Kill the previous run, and schedule the new run CANCEL</em>NEW Let the previous run continue, and cancel the new run. (Default: KILL_EXISTING)</td> +<td>Policy to use when a cron job is triggered while a previous run is still active. KILL_EXISTING Kill the previous run, and schedule the new run CANCEL_NEW Let the previous run continue, and cancel the new run. (Default: KILL_EXISTING)</td> </tr> <tr> <td><code>update_config</code></td> @@ -723,6 +728,11 @@ resources are allocated.</p> <td style="text-align: center"><code>ExecutorConfig</code> object</td> <td>Allows choosing an alternative executor defined in <code>custom_executor_config</code> to be used instead of Thermos. Tasks will be launched with Thermos as the executor by default. See <a href="../../features/custom-executors/">Custom Executors</a> for more info.</td> </tr> +<tr> +<td><code>sla_policy</code></td> +<td style="text-align: center">Choice of <code>CountSlaPolicy</code>, <code>PercentageSlaPolicy</code> or <code>CoordinatorSlaPolicy</code> object</td> +<td>An optional SLA policy that allows job owners to describe the SLA requirements for the job. See <a href="#slapolicy-objects">SlaPolicy Objects</a> for more information.</td> +</tr> </tbody></table> <h3 id="updateconfig-objects">UpdateConfig Objects</h3> @@ -771,8 +781,43 @@ resources are allocated.</p> <td style="text-align: center">Integer</td> <td>Indicates a <a href="../../features/job-updates/#coordinated-job-updates">coordinated update</a>. If no pulses are received within the provided interval the update will be blocked. Beta-updater only. Will fail on submission when used with client updater. (Default: None)</td> </tr> +<tr> +<td><code>sla_aware</code></td> +<td style="text-align: center">boolean</td> +<td>When True, updates will only update an instance if it does not break the task’s specified <a href="../../features/sla-requirements/">SLA Requirements</a>. (Default: None)</td> +</tr> </tbody></table> +<h4 id="using-the-sla_aware-option">Using the <code>sla_aware</code> option</h4> + +<p>There are some nuances around the <code>sla_aware</code> option that users should be aware of:</p> + +<ul> +<li>SLA-aware updates work in tandem with maintenance. Draining a host that has an instance of the +job being updated affects the SLA and thus will be taken into account when the update determines +whether or not it is safe to update another instance.</li> +<li>SLA-aware updates will use the <a href="../../features/sla-requirements/#custom-sla">SLAPolicy</a> of the +<em>newest</em> configuration when determining whether or not it is safe to update an instance. For +example, if the current configuration specifies a +<a href="../../features/sla-requirements/#percentageslapolicy-objects">PercentageSlaPolicy</a> that allows for +5% of instances to be down and the updated configuration increaes this value to 10%, the SLA +calculation will be done using the 10% policy. Be mindful of this when doing an update that +modifies the <code>SLAPolicy</code> since it may be possible to put the old configuration in a bad state +that the new configuration would not be affected by. Additionally, if the update is rolled back, +then the rollback will use the old <code>SLAPolicy</code> (or none if there was not one previously).</li> +<li>If using the <a href="../../features/sla-requirements/#coordinatorslapolicy-objects">CoordinatorSlaPolicy</a>, +it is important to pay attention to the <code>batch_size</code> of the update. If you have a complex SLA +requirement, then you may be limiting the throughput of your updates with an insufficient +<code>batch_size</code>. For example, imagine you have a job with 9 instance that represents three +replicated caches, and you can only update one instance per replica set: <code>[0 1 2] +[3 4 5] [6 7 8]</code> (the number indicates the instance ID and the brackets represent replica +sets). If your <code>batch_size</code> is 3, then you will slowly update one replica set at a time. If your +<code>batch_size</code> is 9, then you can update all replica sets in parallel and thus speeding up the update.</li> +<li>If an instance fails an SLA check for an update, then it will be rechecked starting at a delay +from <code>sla_aware_kill_retry_min_delay</code> and exponentially increasing up to +<code>sla_aware_kill_retry_max_delay</code>. These are cluster-operator set values.</li> +</ul> + <h3 id="healthcheckconfig-objects">HealthCheckConfig Objects</h3> <p>Parameters for controlling a task’s health checks via HTTP or a shell command.</p> @@ -1233,7 +1278,7 @@ See <a href="https://docs.docker.com/ref </tr> </tbody></table> -<h4 id="gracefulshutdownendpoint">graceful<em>shutdown</em>endpoint</h4> +<h4 id="graceful_shutdown_endpoint">graceful_shutdown_endpoint</h4> <p>If the Job is listening on the port as specified by the HttpLifecycleConfig (default: <code>health</code>), a HTTP POST request will be sent over localhost to this @@ -1249,6 +1294,74 @@ endpoint to request as a final warning b does not shut down on its own after <code>shutdown_wait_secs</code> seconds, it will be forcefully killed.</p> +<h3 id="slapolicy-objects">SlaPolicy Objects</h3> + +<p>Configuration for specifying custom <a href="../../features/sla-requirements/">SLA requirements</a> for a job. There are 3 supported SLA policies +namely, <a href="#countslapolicy-objects"><code>CountSlaPolicy</code></a>, <a href="#percentageslapolicy-objects"><code>PercentageSlaPolicy</code></a> and <a href="#coordinatorslapolicy-objects"><code>CoordinatorSlaPolicy</code></a>.</p> + +<h3 id="countslapolicy-objects">CountSlaPolicy Objects</h3> + +<table><thead> +<tr> +<th>param</th> +<th style="text-align: center">type</th> +<th>description</th> +</tr> +</thead><tbody> +<tr> +<td><code>count</code></td> +<td style="text-align: center">Integer</td> +<td>The number of active instances required every <code>durationSecs</code>.</td> +</tr> +<tr> +<td><code>duration_secs</code></td> +<td style="text-align: center">Integer</td> +<td>Minimum time duration a task needs to be <code>RUNNING</code> to be treated as active.</td> +</tr> +</tbody></table> + +<h3 id="percentageslapolicy-objects">PercentageSlaPolicy Objects</h3> + +<table><thead> +<tr> +<th>param</th> +<th style="text-align: center">type</th> +<th>description</th> +</tr> +</thead><tbody> +<tr> +<td><code>percentage</code></td> +<td style="text-align: center">Float</td> +<td>The percentage of active instances required every <code>durationSecs</code>.</td> +</tr> +<tr> +<td><code>duration_secs</code></td> +<td style="text-align: center">Integer</td> +<td>Minimum time duration a task needs to be <code>RUNNING</code> to be treated as active.</td> +</tr> +</tbody></table> + +<h3 id="coordinatorslapolicy-objects">CoordinatorSlaPolicy Objects</h3> + +<table><thead> +<tr> +<th>param</th> +<th style="text-align: center">type</th> +<th>description</th> +</tr> +</thead><tbody> +<tr> +<td><code>coordinator_url</code></td> +<td style="text-align: center">String</td> +<td>The URL to the <a href="../../features/sla-requirements/#coordinator">Coordinator</a> service to be contacted before performing SLA affecting actions (job updates, host drains etc).</td> +</tr> +<tr> +<td><code>status_key</code></td> +<td style="text-align: center">String</td> +<td>The field in the Coordinator response that indicates the SLA status for working on the task. (Default: <code>drain</code>)</td> +</tr> +</tbody></table> + <h1 id="specifying-scheduling-constraints">Specifying Scheduling Constraints</h1> <p>In the <code>Job</code> object there is a map <code>constraints</code> from String to String Modified: aurora/site/publish/documentation/latest/reference/observer-configuration/index.html URL: http://svn.apache.org/viewvc/aurora/site/publish/documentation/latest/reference/observer-configuration/index.html?rev=1840514&r1=1840513&r2=1840514&view=diff ============================================================================== --- aurora/site/publish/documentation/latest/reference/observer-configuration/index.html (original) +++ aurora/site/publish/documentation/latest/reference/observer-configuration/index.html Tue Sep 11 05:25:44 2018 @@ -41,10 +41,14 @@ <h5 class="page-header text-uppercase">Documentation <select onChange="window.location.href='/documentation/' + this.value + '/reference/observer-configuration/'" value="latest"> + <option value="0.21.0" + > + 0.21.0 + (latest) + </option> <option value="0.20.0" > 0.20.0 - (latest) </option> <option value="0.19.1" >
