Puppet - 自定义函数

如前一章所述，函数为用户提供了开发自定义函数的特权。Puppet 可以通过使用自定义函数来扩展其解释能力。自定义功能有助于增强和扩展 Puppet 模块和清单文件的功能。

编写自定义函数

在编写函数之前，有几件事需要记住。

在 Puppet 中，函数由编译器执行，这意味着所有函数都在 Puppet master 上运行，并且它们不需要处理任何 Puppet 客户端。函数只能与代理交互，前提是信息是事实的形式。
Puppet master 捕获自定义函数，这意味着如果对 Puppet 函数进行一些更改，则需要重新启动 Puppet master。
函数将在服务器上执行，这意味着函数所需的任何文件都应该存在于服务器上，如果函数需要直接访问客户端计算机，则无法执行任何操作。
有两种完全不同类型的函数可用，一种是返回值的右值函数，另一种是不返回任何内容的语句函数。
包含函数的文件的名称应与文件中函数的名称相同。否则，它将不会自动加载。

放置自定义函数的位置

所有自定义函数都作为单独的.rb文件实现，并分布在模块之间。需要将自定义函数放入 lib/puppet/parser/function 中。可以从以下位置从.rb文件加载函数。

$libdir/puppet/解析器/函数
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!")