mirror of
https://github.com/valitydev/salt.git
synced 2024-11-09 01:36:48 +00:00
498a612078
Conflicts: doc/topics/cloud/linode.rst doc/topics/cloud/misc.rst doc/topics/cloud/parallels.rst doc/topics/cloud/proxmox.rst Conflicts: doc/topics/development/architecture.rst doc/topics/development/translating.rst
25 lines
978 B
ReStructuredText
25 lines
978 B
ReStructuredText
.. _targeting-batch:
|
|
|
|
Batch Size
|
|
----------
|
|
|
|
The ``-b`` (or ``--batch-size``) option allows commands to be executed on only
|
|
a specified 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. |