在配置管理系统中,从中心服务器想客户端推送文件是很基本的需求。SaltStack使用内建的ZeroMQ服务器做为文件服务器。 文件服务器主要用来在state系统中推送文件到客户端,也可以用于其他文件的传输。
客户端对文件服务器的操作都在cp模块中。Salt State系统,Salt-cp都用到了cp模块。
因为文件服务器是为Salt state系统服务,所以也支持环境的概念。master的配置文件中定义各环境的路径,文件的路径基于指定环境的根目录(参见下面的例子)。
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不存在,将会建立此目录。
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
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
cp.get_template可以在文件下载之前用模板引擎处理。
# salt '*' cp.get_template salt://path/to/template /minion/dest
cp.push可以从客户端传文件到master上,处于很明显的安全考虑,默认没有启用此功能,如果你需要的话可以参考文档。