鸟在笼中,恨关羽不能张飞;Survival of the fittest
分类: 系统运维
2014-06-29 18:13:21
file 资源
管理系统本地文件
正如puppet手册提到到一样,我们希望你尽量少的使用file文件类型对内容进行管理. 而是用封装的更好的资源类型来替代. 如果你发现你经常从puppet服务器拷贝文件到本地,请你联系puppetlabs ,让他们给你开发适合你的私有资源类型.
依赖
该资源类型没有依赖
平台
该资源类型支持所有平台
例子
下面是一个简单的例子
file { "/var/www/my/file": source => "/path/in/nfs/or/something", mode => 666 }
backup
决定文件的内容在被修改前是否进行备份. 利用filebucket对文件进行备份,按文件的md5sum进行归类,便于恢复文件的时候找到文件.可以把文件备份到 puppet 客户端,也可以通过设置backpup => bucket_name 把文件备份到网络上的其他机器. 如果backup的值是一个点号"."开头的字符串,puppet会把文件备份在同一目录下,备份文件的扩展名就是 bakcup里面的那个字符串.如果设置 backup => false , 该文件不做备份.
puppet自动在本地创建目录,并且把要修改的文件备份到那里, 如果要用网络上面的机器进行备份,你必须对filebucket进行配置,例如
filebucket { main: server => puppet }
file { "/my/file": source => "/path/in/nfs/or/something", backup => main }
checksum
怎样检查文件是否被修改,这个状态用来在复制文件的时候使用, 这里有几种检测方式,包括md5 ,mtime等.
默认的检测是用md5
content
把文件的内容设置为content 参数后面的字符串, 新行,tab,空格可用 escaped syntax 表示. 这个参数主要用于提供一种简洁的基于模板的的文件内容设置.例如
define resolve(nameserver1, nameserver2, domain, search) { $str = "search $search domain $domain nameserver $nameserver1 nameserver $nameserver2" file { "/etc/resolv.conf": content => $str } }
ensure
如果文件本来不存在是否要新建文件,可以设置的值是 absent和present,file和directory. 如果指定 present,就会检查该文件是否存在,如果不存在就新建该文件,如果指定是 absent, 就会删除该文件(如果recurse => true ,就会删除目录)
如果提供的值不是上面提到的4种,那么就会创建一个文件的符号链接. 下面的代码将创建一个符号链接.
# Useful on solaris file { "/etc/inetd.conf": ensure => "/etc/inet/inetd.conf" }
也可以做相当路径的符号链接
# Useful on solaris file { "/etc/inetd.conf": ensure => "inet/inetd.conf" }
force
force 当前的唯一作用是用在把一个目录变成一个链接,可用的值是ture和false
group
指定那个该文件的用户组,值可以是gid或者组名
ignore
当用recursion 方法复制一个目录的时候,可以用ignore来设定过滤条件,符合过滤条件的文件不被复制. 使用ruby自带的匹配法则.因此shell级别的过滤表达式完全支持,例如[a-g]*
links
定义操作符合链接文件. 可以设置的值是follow和manage; 文件拷贝的时候,设置follow,会拷贝文件的内容,而不是只拷贝符合链接本身,如果设置成manage ,会拷贝符合链接本身.
mode
mode用于设置文件的权限
owner
设置文件的属主
path
指定要管理文件的路径,必须用引号引起来, 这也是一个资源的 namevar ,通常path 等于资源的title
recurse
设置是否以及如何进行递归操作, 可以设置的值是 false,ture ,inf ,remote
recurselimit
递归的深度,设置的值可以匹配/^[0-9]+$/.
source
拷贝一个文件覆盖当前文件,用checksum来判断是否有必要进行复制,可以设置的值是一个引用的完整的文件路径,或者是URI,当前支持的URI只有puppet和file ; 这是一个对文件常用的操作,可以让puppet修改系统的配置文件.
class sendmail { file { "/etc/mail/sendmail.cf": source => "puppet://server/module/sendmail.cf" } }
上面的代码从puppet服务器上面下载sendmail.cf,覆盖到 /etc/mail/sendmail.cf
当前支持puppet 这个URI ,puppet会连接到puppet服务器上面的fileserver服务, 可以参考puppet fileserver的配置文件更好的理解file server.
原文地址