2012-04-03 15:49:39 +00:00
|
|
|
Batch Size
|
|
|
|
|
----------
|
|
|
|
|
|
2013-08-11 02:55:51 +00:00
|
|
|
The ``-b`` (or ``--batch-size``) option allows commands to be executed on only
|
2013-09-20 12:01:20 +00:00
|
|
|
a specified number of minions at a time. Both percentages and finite numbers are
|
2013-08-11 02:55:51 +00:00
|
|
|
supported.
|
2012-04-03 15:49:39 +00:00
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
2013-08-12 03:17:47 +00:00
|
|
|
salt '*' -b 10 test.ping
|
2012-04-03 15:49:39 +00:00
|
|
|
|
|
|
|
|
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.
|
