mirror of
https://github.com/valitydev/salt.git
synced 2024-11-08 01:18:58 +00:00
9c63495e04
This completes the documentation audit begun in cf365f7, using proper
backticks and :strong: tags to emphasize text, converting groups of
shell commands to bash code-block sections, etc. This also replaces the
use of \* with the easier-to-grok '*', which will hopefully reduce
confusion among new users.
24 lines
956 B
ReStructuredText
24 lines
956 B
ReStructuredText
Batch Size
|
|
----------
|
|
|
|
The ``-b`` (or ``--batch-size``) option allows commands to be executed on only
|
|
a specifed number of minions at a time. Both percentages and finite numbers are
|
|
supported.
|
|
|
|
.. code-block:: bash
|
|
|
|
salt '*' -b 10 test.ping
|
|
|
|
salt -G 'os:RedHat' --batch-size 25% apache.signal restart
|
|
|
|
This will only run test.ping on 10 of the targeted minions at a time and then
|
|
restart apache on 25% of the minions matching ``os:RedHat`` at a time and work
|
|
through them all until the task is complete. This makes jobs like rolling web
|
|
server restarts behind a load balancer or doing maintenance on BSD firewalls
|
|
using carp much easier with salt.
|
|
|
|
The batch system maintains a window of running minions, so, if there are a
|
|
total of 150 minions targeted and the batch size is 10, then the command is
|
|
sent to 10 minions, when one minion returns then the command is sent to one
|
|
additional minion, so that the job is constantly running on 10 minions.
|