@@ -6224,7 +6224,8 @@ <h2 id="deployments">Deployments</h2>
62246224
62256225<ul>
62266226<li><p><a href="https://docs.cloudfoundry.org/devguide/deploy-apps/rolling-deploy.html">Rolling deployments</a> allows for
6227- applications to be deployed without incurring downtime by gradually rolling out instances.</p></li>
6227+ applications to be deployed without incurring downtime by gradually rolling out instances. Max-in-flight can be configured
6228+ to specify how many instances are rolled out simultaneously.</p></li>
62286229<li><p>Canary deployments deploy a single instance and pause for user evaluation. If the canary instance is deemed successful, the deployment can be resumed via the <a href="#continue-a-deployment">continue action</a>. The deployment then continues like a rolling deployment. This feature is experimental and is subject to change.</p></li>
62296230</ul>
62306231<h3 id="the-deployment-object">The deployment object</h3>
@@ -6240,6 +6241,9 @@ <h3 id="the-deployment-object">The deployment object</h3>
62406241 </span><span class="p">}</span><span class="w">
62416242 </span><span class="p">},</span><span class="w">
62426243 </span><span class="nl">"strategy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"canary"</span><span class="p">,</span><span class="w">
6244+ </span><span class="nl">"options"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
6245+ </span><span class="nl">"max_in_flight"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
6246+ </span><span class="p">},</span><span class="w">
62436247 </span><span class="nl">"droplet"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
62446248 </span><span class="nl">"guid"</span><span class="p">:</span><span class="w"> </span><span class="s2">"44ccfa61-dbcf-4a0d-82fe-f668e9d2a962"</span><span class="w">
62456249 </span><span class="p">},</span><span class="w">
@@ -6336,6 +6340,11 @@ <h3 id="the-deployment-object">The deployment object</h3>
63366340<td>Strategy used for the deployment; supported strategies are <code class="prettyprint">rolling</code> and <code class="prettyprint">canary</code> (experimental)</td>
63376341</tr>
63386342<tr>
6343+ <td><strong>options.max_in_flight</strong></td>
6344+ <td><em>integer</em></td>
6345+ <td>The maximum number of new instances to deploy simultaneously</td>
6346+ </tr>
6347+ <tr>
63396348<td><strong>droplet.guid</strong></td>
63406349<td><em>string</em></td>
63416350<td>The droplet guid that the deployment is transitioning the app to</td>
@@ -6428,6 +6437,9 @@ <h3 id="create-a-deployment">Create a deployment</h3>
64286437 </span><span class="p">}</span><span class="w">
64296438 </span><span class="p">},</span><span class="w">
64306439 </span><span class="nl">"strategy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"canary"</span><span class="p">,</span><span class="w">
6440+ </span><span class="nl">"options"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
6441+ </span><span class="nl">"max_in_flight"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
6442+ </span><span class="p">},</span><span class="w">
64316443 </span><span class="nl">"droplet"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
64326444 </span><span class="nl">"guid"</span><span class="p">:</span><span class="w"> </span><span class="s2">"44ccfa61-dbcf-4a0d-82fe-f668e9d2a962"</span><span class="w">
64336445 </span><span class="p">},</span><span class="w">
@@ -6527,6 +6539,12 @@ <h4 id="optional-parameters">Optional parameters</h4>
65276539<td><code class="prettyprint">rolling</code></td>
65286540</tr>
65296541<tr>
6542+ <td><strong>options.max_in_flight</strong></td>
6543+ <td><em>integer</em></td>
6544+ <td>The maximum number of new instances to deploy simultaneously</td>
6545+ <td>1</td>
6546+ </tr>
6547+ <tr>
65306548<td><strong>metadata.labels</strong></td>
65316549<td><a href="#labels"><em>label object</em></a></td>
65326550<td>Labels applied to the deployment</td>
@@ -6579,6 +6597,9 @@ <h3 id="get-a-deployment">Get a deployment</h3>
65796597 </span><span class="p">}</span><span class="w">
65806598 </span><span class="p">},</span><span class="w">
65816599 </span><span class="nl">"strategy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"canary"</span><span class="p">,</span><span class="w">
6600+ </span><span class="nl">"options"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
6601+ </span><span class="nl">"max_in_flight"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
6602+ </span><span class="p">},</span><span class="w">
65826603 </span><span class="nl">"droplet"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
65836604 </span><span class="nl">"guid"</span><span class="p">:</span><span class="w"> </span><span class="s2">"44ccfa61-dbcf-4a0d-82fe-f668e9d2a962"</span><span class="w">
65846605 </span><span class="p">},</span><span class="w">
@@ -6693,6 +6714,9 @@ <h3 id="list-deployments">List deployments</h3>
66936714 </span><span class="nl">"reason"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DEPLOYED"</span><span class="w">
66946715 </span><span class="p">},</span><span class="w">
66956716 </span><span class="nl">"strategy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"rolling"</span><span class="p">,</span><span class="w">
6717+ </span><span class="nl">"options"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
6718+ </span><span class="nl">"max_in_flight"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
6719+ </span><span class="p">},</span><span class="w">
66966720 </span><span class="nl">"droplet"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
66976721 </span><span class="nl">"guid"</span><span class="p">:</span><span class="w"> </span><span class="s2">"44ccfa61-dbcf-4a0d-82fe-f668e9d2a962"</span><span class="w">
66986722 </span><span class="p">},</span><span class="w">
@@ -6836,6 +6860,9 @@ <h3 id="update-a-deployment">Update a deployment</h3>
68366860 </span><span class="p">}</span><span class="w">
68376861 </span><span class="p">},</span><span class="w">
68386862 </span><span class="nl">"strategy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"canary"</span><span class="p">,</span><span class="w">
6863+ </span><span class="nl">"options"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
6864+ </span><span class="nl">"max_in_flight"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
6865+ </span><span class="p">},</span><span class="w">
68396866 </span><span class="nl">"droplet"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
68406867 </span><span class="nl">"guid"</span><span class="p">:</span><span class="w"> </span><span class="s2">"44ccfa61-dbcf-4a0d-82fe-f668e9d2a962"</span><span class="w">
68416868 </span><span class="p">},</span><span class="w">
0 commit comments