salt/doc/topics/blackout/index.rst
Jacob Hammons dd21da4992 Add autodoc topics for new modules added in Carbon (#36933)
Module formatting issues
Add list of new Carbon modules to release notes
2016-10-12 09:31:07 -06:00

27 lines
935 B
ReStructuredText

.. _blackout:
=============================
Minion Blackout Configuration
=============================
.. versionadded:: 2016.3.0
Salt supports minion blackouts. When a minion is in blackout mode, all remote
execution commands are disabled. This allows production minions to be put
"on hold", eliminating the risk of an untimely configuration change.
Minion blackouts are configured via a special pillar key, ``minion_blackout``.
If this key is set to ``True``, then the minion will reject all incoming
commands, except for ``saltutil.refresh_pillar``. (The exception is important,
so minions can be brought out of blackout mode)
Salt also supports an explicit whitelist of additional functions that will be
allowed during blackout. This is configured with the special pillar key
``minion_blackout_whitelist``, which is formed as a list:
.. code-block:: yaml
minion_blackout_whitelist:
- test.ping
- pillar.get