Puppet之File资源参数
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
}
puppetmaster 默认也会创建一个filebucket ,因此你可以在配置文件里面使用这个 filebucket. 一旦你按照上面的代码进行了配置,你在其他代码中就可以使用网络上面的filebucket了.
file { "/my/file":
source => "/path/in/nfs/or/something",
backup => main
}
上面的代码会让文件备份到 puppetmaster 所在机器,既puppet的主服务器.
这样你就不用在每个机器上都创建一个本地的filebucket, 每个版本的文件通常只备份一次, 通常你可以手工的恢复你备份的文件.
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级别的过滤表达式完全支持,例如*
links
定义操作符合链接文件. 可以设置的值是follow和manage; 文件拷贝的时候,设置follow,会拷贝文件的内容,而不是只拷贝符合链接本身,如果设置成manage ,会拷贝符合链接本身.
mode
mode用于设置文件的权限
owner
设置文件的属主
path
指定要管理文件的路径,必须用引号引起来, 这也是一个资源的 namevar ,通常path 等于资源的title
recurse
设置是否以及如何进行递归操作, 可以设置的值是 false,ture ,inf ,remote
recurselimit
递归的深度,设置的值可以匹配/^+$/.
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.
http://docs.puppetlabs.com/guides/types/file.html 原文地址
页:
[1]