SaltStack中的文件服务器

SaltStack中的文件服务器

cp模块

环境

get_file

get_dir

get_url

get_template

push

参考链接: 原文Salt File Server

在配置管理系统中，从中心服务器想客户端推送文件是很基本的需求。SaltStack使用内建的ZeroMQ服务器做为文件服务器。 文件服务器主要用来在state系统中推送文件到客户端，也可以用于其他文件的传输。

cp模块

客户端对文件服务器的操作都在cp模块中。Salt State系统，Salt-cp都用到了cp模块。

环境

因为文件服务器是为Salt state系统服务，所以也支持环境的概念。master的配置文件中定义各环境的路径，文件的路径基于指定环境的根目录（参见下面的例子）。

get_file

cp.get_file用来从master下载文件到客户端，语法如下：

# salt '*' cp.get_file salt://vimrc /etc/vimrc

其中vimrc在master上的实际路径要看环境中定义的根目录，假设在master中有如下定义：

file_roots:

  base:

    - /srv/salt/

那么vimrc的实际路径就是/srv/salt/vimrc，这样做的好处是，可以满足state系统中环境的概念。

源路径和目标路径中都可以使用模板，如下：

# salt '*' cp.get_file "salt://{{grains.os}}/vimrc" /etc/vimrc template=jinja

这个例子中，将下载与客户端操作系统名字相同的目录下的文件。

对于大文件，cp.get_file支持gzip压缩，在参数中指定gzip的压缩级别，如下:

# salt '*' cp.get_file salt://vimrc /etc/vimrc gzip=5

其中，1代表作小压缩，9代表最大压缩。

cp.get_file默认不在客户端上建立目录，如果客户端上没有这个目录了，文件拷贝将失败，可以指定makedirs=True来创建目录：

# salt '*' cp.get_file salt://vimrc /etc/vim/vimrc makedirs=True

在这个例子中，如果@@/etc/vim不存在，将会建立此目录。

get_dir

cp.get_dir可以从master下载整个目录，语法如下：

# salt '*' cp.get_dir salt://etc/apache2 /etc

cp.get_dir也支持模板和压缩：

# salt '*' cp.get_dir salt://etc/{{pillar.webserver}} /etc gzip=5 template=jinja

get_url

cp.get_url可以从一个URL地址下载文件，URL可以是msater上的路径（salt://），也可以是http网址。

# salt '*' cp.get_url salt://my/file /tmp/mine

# salt '*' cp.get_url http://www.slashdot.org /tmp/index.html

get_template?

cp.get_template可以在文件下载之前用模板引擎处理。

# salt '*' cp.get_template salt://path/to/template /minion/dest

push

cp.push可以从客户端传文件到master上，处于很明显的安全考虑，默认没有启用此功能，如果你需要的话可以参考文档。

本文出自 “DavideyLee” 博客，谢绝转载！