mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 17:09:03 +00:00
1c442f7c4e
This commit turns some of the config file parameters into links to the master config file docs, and also links to the pages for the fileserver backends being described.
40 lines
1.6 KiB
ReStructuredText
40 lines
1.6 KiB
ReStructuredText
====================
|
|
File Server Backends
|
|
====================
|
|
|
|
Salt version 0.12.0 introduced the ability for the Salt Master to integrate
|
|
different file server backends. File server backends allows the Salt file
|
|
server to act as a transparent bridge to external resources. The primary
|
|
example of this is the git backend which allows for all of the Salt formulas
|
|
and files to be maintained in a remote git repository.
|
|
|
|
The fileserver backend system can accept multiple backends as well. This makes
|
|
it possible to have the environments listed in the :conf_master:`file_roots`
|
|
configuration available in addition to other backends, or the ability to mix
|
|
multiple backends.
|
|
|
|
This feature is managed by the :conf_master:`fileserver_backend` option in the
|
|
master config. The desired backend systems are listed in order of search
|
|
priority:
|
|
|
|
.. code-block:: yaml
|
|
|
|
fileserver_backend:
|
|
- roots
|
|
- git
|
|
|
|
With this configuration, the environments and files defined in the
|
|
:conf_master:`file_roots` parameter will be searched first, if the referenced
|
|
environment and file is not found then the :mod:`git <salt.fileserver.gitfs>`
|
|
backend will be searched.
|
|
|
|
Environments
|
|
------------
|
|
|
|
The concept of environments is followed in all backend systems. The
|
|
environments in the classic :mod:`roots <salt.fileserver.roots>` backend are
|
|
defined in the :conf_master:`file_roots` option. Environments map differently
|
|
based on the backend, for instance the git backend translated branches and tags
|
|
in git to environments. This makes it easy to define environments in git by
|
|
just setting a tag or forking a branch.
|