valitydev/salt
14
0
Fork 0
mirror of https://github.com/valitydev/salt.git synced 2024-11-07 17:09:03 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Add note about top-file only env assignment and the show_top() function

Browse Source
This commit is contained in:
Seth House 2015-08-07 16:33:55 -06:00 committed by rallytime
parent 5864111429
commit 4471c3f237
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/ref/states/top.rst
View File

@ -170,6 +170,13 @@ the state into QA by copying the state file into `/srv/salt/qa`.
Choosing an Environment to Target
=================================
The top file is used to assign a minion to an environment unless overridden
using the methods described below. The environment in the top file must match
an environment in :conf_master:`file_roots` in order for any states to be
applied to that minion. The states that will be applied to a minion in a given
environment can be viewed using the :py:func:`state.show_top
<salt.modules.state.show_top>` execution function.
Minions may be pinned to a particular environment by setting the `environment`
value in the minion configuration file. In doing so, a minion will only
request files from the environment to which it is assigned.