puppet进阶指南——exec资源详解

exec资源
exec资源的功能是调用linux系统命令，完成系统管理的基础操作。

1、exec资源常用属性
exec {'资源标题':
command
creates
cwd
environment
group
logoutput
onlyif
path
refresh
refreshonly
returns
timeout
tries
try_sleep
user
provider
}

◆ command：指定要执行的系统命令。
◆ creates：指定命令所生成的文件。如果提供了这个参数，那么命令只会在所指定的文件不存在的情况的被执行，防止出现同一时刻多次执行的情况。
exec {'tar -xf /root/nginx.tar.gz':
cwd => '/var/tmp',
creates => '/var/tmp/myfile',
path => ["/usr/bin","/usr/sbin"]
}
◆ cwd：指定命令执行的目录。如果目录不存在，则命令执行失败。
◆ environment：为命令设定额外的环境变量。要注意的是如果你用这个来设定PATH，那么PATH的属性会被覆盖。多个环境变量应该以数组的形式来设定。
◆ group：执行命令运行的账户组。
◆ logoutput：是否记录输出。默认会根据exec资源的日志等级（loglevel） 来记录输出。若定义为on_failure，则仅在命令返回错误的时候记录输出。可取的值为：true，false和其他合法的日志等级。
◆ onlyif：如果这个参数被设定了，则exec只会在onlyif设定的命令返回0时才执行。
◆ path：命令执行的搜索路径。如果path没有被定义，命令需要使用绝对路径。路径可以以数组或以冒号分隔的形式来定义。path => [ "/bin/", "/sbin/" , "/usr/bin/", "/usr/sbin/" ]
◆ refresh =>true|false：刷新命令执行状态。
◆ refreshonly =>true|false：该属性可以使命令变成仅刷新触发的，也就是说只有在一个依赖的对象被改变时，命令才会被执行。只有同时使用subscribe或notify才有意义。
◆ returns：指定返回的代码。如果被执行的命令返回了其他的代码，一个错误（error）会被返回。默认值是0，可以定义为一个由可以接受的返回代码组成的数组或单值。
◆ timeout：命令运行的最长时间。如果命令运行的时间超过了timeout定义的时间，那么这个命令就会被终止，并作为运行失败处理。当定义为负值时就会取消运行时间的限制。timeout的值是以秒为单位的。
◆ tries：命令执行重试次数，默认为1。设置这个值之后命令会重试设置的次数直到正确的代码返回。
◆ try_sleep：设置命令重试的间隔时间，单位为秒。
◆ user：指定执行命令的账户。
◆ provider：shell和windows。

2、案例分析
通过exec资源以puppet账户身份来解压soft.tar.gz文件，编辑/etc/puppet/manifests/exec.pp。
exec { 'test':
path => ["/usr/bin","/bin"],
creates => '/tmp/lock',
user => 'puppet',
group => 'puppet',
timeout => '3',
command => 'tar xf /root/soft.tar.gz',
}

进行测试查看一下，可以看到文件正常解压好。
# puppet apply /etc/puppet/manifests/exec.pp
notice: /Stage[main]//Exec[test]/returns: executed successfully
notice: Finished catalog run in 0.20 seconds

欢迎关注http://www.wzlinux.com:45 和http://www.wzlinux.com 。