mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 08:58:59 +00:00
ccc7665c42
The grains example would traceback if the grain was not defined, so I have replaced this example with a better one. Also made a few changes for consistency in formatting, and made a couple terms into links to the relevant documentation.
45 lines
1.2 KiB
ReStructuredText
45 lines
1.2 KiB
ReStructuredText
===========
|
|
Node groups
|
|
===========
|
|
|
|
.. glossary::
|
|
|
|
Node group
|
|
A predefined group of minions declared in the master configuration file
|
|
:conf_master:`nodegroups` setting as a compound target.
|
|
|
|
Nodegroups are declared using a compound target specification. The compound
|
|
target documentation can be found :doc:`here <compound>`.
|
|
|
|
The :conf_master:`nodegroups` master config file parameter is used to define
|
|
nodegroups. Here's an example nodegroup configuration within
|
|
``/etc/salt/master``:
|
|
|
|
.. code-block:: yaml
|
|
|
|
nodegroups:
|
|
group1: 'L@foo.domain.com,bar.domain.com,baz.domain.com or bl*.domain.com'
|
|
group2: 'G@os:Debian and foo.domain.com'
|
|
|
|
.. note::
|
|
|
|
The ``L`` within group1 is matching a list of minions, while the ``G`` in
|
|
group2 is matching specific grains. See the :doc:`compound matchers
|
|
<compound>` documentation for more details.
|
|
|
|
To match a nodegroup on the CLI, use the ``-N`` command-line option:
|
|
|
|
.. code-block:: bash
|
|
|
|
salt -N group1 test.ping
|
|
|
|
To match a nodegroup in your :term:`top file`, make sure to put ``- match:
|
|
nodegroup`` on the line directly following the nodegroup name.
|
|
|
|
.. code-block:: yaml
|
|
|
|
base:
|
|
group1:
|
|
- match: nodegroup
|
|
- webserver
|