mirror of
https://github.com/valitydev/salt.git
synced 2024-11-08 01:18:58 +00:00
63 lines
2.4 KiB
ReStructuredText
63 lines
2.4 KiB
ReStructuredText
=========================
|
|
File Server Configuration
|
|
=========================
|
|
|
|
The Salt file server is a high performance file server written in ZeroMQ. It
|
|
manages large files quickly and with little overhead, and has been optimized
|
|
to handle small files in an extremely efficient manner.
|
|
|
|
The Salt file server is an environment aware file server, this means that
|
|
files can be allocated within many root directories and accessed by
|
|
specifying both the file path and the environment to search. The
|
|
individual environments can also be spanned across multiple directory roots
|
|
to crate overlays and to allow for files to be organized in many flexible
|
|
ways.
|
|
|
|
Environments
|
|
============
|
|
|
|
The Salt file server defaults to the mandatory ``base`` environment. This
|
|
environment MUST be defined and is used to download files when no
|
|
environment is specified.
|
|
|
|
Environments allow for files and sls data to be logically separated, but
|
|
environments are not isolated from each other. This allows for logical
|
|
isolation of environments by the engineer using Salt, but also allows
|
|
for information to be used in multiple environments for maximum flexibility.
|
|
|
|
|
|
Directory Overlay
|
|
=================
|
|
|
|
The environment setting is a list of directories to publish files from. These
|
|
directories are searched in order to find the specified file and the first file
|
|
found is returned.
|
|
|
|
This means that directory data is prioritized based on the order in which they
|
|
are listed. In the case of this ``file_roots`` configuration:
|
|
|
|
.. code-block:: yaml
|
|
|
|
file_roots:
|
|
base:
|
|
- /srv/salt/base
|
|
- /srv/salt/failover
|
|
|
|
If a file uri os salt://httpd/httpd.conf will first search for the file at
|
|
/srv/salt/base/httpd/httpd.conf, if the file is found there it will be
|
|
returned, if the file is not found there, then
|
|
/srv/salt/failover/httpd/httpd.conf is searched for the file.
|
|
|
|
This allows for directories to be overlaid and prioritized based on the order
|
|
they are defined in the configuration.
|
|
|
|
Local File Server
|
|
=================
|
|
|
|
The file server can be rerouted to run from the minion. This is primarily to
|
|
enable running salt states without a salt master. To use the local file server
|
|
interface, copy the file server data to the minion and set the file_roots
|
|
option on the minion to point to the directories copied from the master.
|
|
Once the minion ``file_roots`` option has been set, change the ``file_client``
|
|
option to local to make sure that the local file server interface is used.
|