saltstack/salt
1
0
Fork 0
mirror of https://github.com/saltstack/salt.git synced 2025-04-17 10:10:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Merge pull request #53338 from AstraLuma/patch-3

Browse source 
[master]Modular Systems: Document saltenvs and modules
This commit is contained in:
Daniel Wozniak 2023-12-09 22:10:59 -07:00 • committed by GitHub
commit aa20365fd6
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
doc/topics/development/modules/index.rst
View file

@ -55,9 +55,11 @@ prepended by underscore, such as:
Modules must be synced before they can be used. This can happen a few ways,
discussed below.
.. note::
Using saltenvs besides ``base`` may not work in all contexts.
Sync Via States
~~~~~~~~~~~~~~~
@ -67,7 +69,7 @@ dynamic modules when states are run. To disable this behavior set
:conf_minion:`autoload_dynamic_modules` to ``False`` in the minion config.
When dynamic modules are autoloaded via states, only the modules defined in the
same saltenvs as the states currently being run.
same saltenv as the states currently being run are synced.
Sync Via the saltutil Module
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -78,6 +80,8 @@ or specific dynamic modules. The ``saltutil.sync_*``
:py:mod:`runner functions <salt.runners.saltutil>` can be used to sync modules
to minions and the master, respectively.
If saltenv environments are used (through the :ref:`top file <states-top>`, the :conf_minion:`environment` option of the minion configuration file, or as an argument on the command line) modules will be synced from the applied environments.
The extmods Directory
---------------------