mirror of
https://github.com/valitydev/salt.git
synced 2024-11-08 17:33:54 +00:00
38 lines
1.5 KiB
ReStructuredText
38 lines
1.5 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 file_roots configuration
|
|
available in addition to other backends, or the ability to mix multiple
|
|
backends.
|
|
|
|
This feature is managed by the `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
|
|
|
|
If this configuration the environments and files defined in the `file_roots`
|
|
configuration will be searched first, if the referenced environment and file
|
|
is not found then the git backend will be searched.
|
|
|
|
Environments
|
|
------------
|
|
|
|
The concept of environments is followed in all backend systems. The
|
|
environments in the classic `roots` backend are defined in the `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.
|