salt/doc/ref/file_server/dynamic-modules.rst

38 lines
1.2 KiB
ReStructuredText
Raw Normal View History

2012-02-26 06:19:09 +00:00
===========================
2012-01-14 00:44:16 +00:00
Dynamic Module Distribution
===========================
.. versionadded:: 0.9.5
2012-02-26 06:19:09 +00:00
Salt python modules can be distributed automatically via the salt file server.
Under the root of any environment defined via the file_roots option on the
master server directories corresponding to the type of module can be used.
The directories are prepended with an underscore:
1. _modules
2. _grains
3. _renderers
4. _returners
5. _states
The contents of these directories need to be synced over to the minions after
python modules have been created in them. There are a number of ways to sync
the modules.
2012-02-26 06:19:09 +00:00
Sync Via States
===============
The minion configuration contains an option ``autoload_dynamic_modules``
which defaults to True. This option makes the state system refresh all
dynamic modules when states are run. To disable this behavior set
``autoload_dynamic_modules`` to False in the minion config.
Sync Via the saltutil Module
============================
2012-01-14 00:44:16 +00:00
2012-02-26 06:19:09 +00:00
The saltutil module has a number of functions that can be used to sync all
or specific dynamic modules. The saltutil module function ``saltutil.sync_all``
will sync all module types over to a minion. For more information see:
:mod:`salt.modules.saltutil`