63 lines
1.5 KiB
ReStructuredText
63 lines
1.5 KiB
ReStructuredText
.. _wait_for:
|
|
|
|
wait_for
|
|
``````````````````````````````
|
|
|
|
.. versionadded:: 0.7
|
|
|
|
This is useful for when services are not immediately available after their init scripts return - which is true of certain Java application servers. It is also useful when starting guests with the ``virt`` module and needing to pause until they are ready.
|
|
|
|
.. raw:: html
|
|
|
|
<table>
|
|
<tr>
|
|
<th class="head">parameter</th>
|
|
<th class="head">required</th>
|
|
<th class="head">default</th>
|
|
<th class="head">choices</th>
|
|
<th class="head">comments</th>
|
|
</tr>
|
|
<tr>
|
|
<td>delay</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>number of seconds to wait before starting to poll</td>
|
|
</tr>
|
|
<tr>
|
|
<td>host</td>
|
|
<td>no</td>
|
|
<td>127.0.0.1</td>
|
|
<td><ul></ul></td>
|
|
<td>hostname or IP address to wait for</td>
|
|
</tr>
|
|
<tr>
|
|
<td>port</td>
|
|
<td>yes</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>port number to poll</td>
|
|
</tr>
|
|
<tr>
|
|
<td>timeout</td>
|
|
<td>no</td>
|
|
<td>300</td>
|
|
<td><ul></ul></td>
|
|
<td>maximum number of seconds to wait for</td>
|
|
</tr>
|
|
<tr>
|
|
<td>state</td>
|
|
<td>no</td>
|
|
<td>started</td>
|
|
<td><ul><li>started</li><li>stopped</li></ul></td>
|
|
<td>either <code>started</code>, or <code>stopped</code> depending on whether the module should poll for the port being open or closed.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
.. raw:: html
|
|
|
|
<p>Example from Ansible Playbooks</p> <p><pre>
|
|
wait_for port=8000 delay=10
|
|
</pre></p>
|
|
<br/>
|
|
|