Puppet - 自定义函数
如上一章所述,函数为用户提供了开发自定义函数的权限。Puppet 可以通过使用自定义函数来扩展其解释能力。自定义函数有助于增加和扩展 Puppet 模块和清单文件的功能。
编写自定义函数
在编写函数之前,需要记住一些事项。
在 Puppet 中,函数由编译器执行,这意味着所有函数都在 Puppet Master 上运行,并且它们不需要处理任何 Puppet 客户端。函数只能与代理交互,前提是信息是 Facts 形式。
Puppet master 会捕获自定义函数,这意味着如果对 Puppet 函数进行了一些更改,则需要重新启动 Puppet master。
函数将在服务器上执行,这意味着函数所需的任何文件都应该存在于服务器上,如果函数需要直接访问客户端计算机,则无法执行任何操作。
有两种完全不同的函数类型,一种是返回值的 Rvalue 函数,另一种是不会返回任何内容的语句函数。
包含函数的文件的名称应与文件中的函数名称相同。否则,它不会自动加载。
放置自定义函数的位置
所有自定义函数都作为单独的 .rb 文件实现,并分布在模块之间。需要将自定义函数放在 lib/puppet/parser/function 中。可以从以下位置的 .rb 文件加载函数。
- $libdir/puppet/parser/functions
- Ruby $LOAD_PATH 中的 puppet/parser/functions 子目录
创建新函数
使用 puppet::parser::Functions 模块内的 newfunction 方法创建或定义新函数。需要将函数名称作为符号传递给 newfunction 方法,并将代码作为块运行。以下示例是一个函数,用于将字符串写入 /user 目录中的文件。
module Puppet::Parser::Functions newfunction(:write_line_to_file) do |args| filename = args[0] str = args[1] File.open(filename, 'a') {|fd| fd.puts str } end end
一旦用户声明了该函数,就可以在清单文件中使用它,如下所示。
write_line_to_file('/user/vipin.txt, "Hello vipin!")