puppet模块汇总

在磁盘上，一个模块对应一个特殊的目录结构：

• MODULE_NAME
  • manifests
  • files
  • templates
  • lib
  • tests
  • spec

 

例如，一个名为"my_module"的模块，它的目录结构应该是：

• my_module - 顶层目录，对应到模块名称。
  • manifests/ - 模块所有的清单。
    • init.pp - 类定义。该文件中的类名必须对应到模块名称。
    • other_class.pp - 类定义。该文件中的类名必须是my_module::other_class。
    • my_defined_type.pp - 函数定义。该文件中的函数名必须是my_module::my_defined_type。
    • implementation/ - 清单子目录。
      • foo.pp - 类定义。该文件中的类名必须是my_module::implementation::foo。
      • bar.pp - 类定义。该文件中的类别必须是my_module::implementation::bar。
  • files/ - 静态文件目录，能够被被代理节点下载。
    • service.conf - 该文件对应的URL是puppet://modules/my_module/service.conf。
  • lib/ - 插件目录 ，例如自定义的行为和自定义的资源类型。查阅"使用插件 "获取更多的细节。
  • templates/ - 清单中用到的模板文件目录 。查阅"模版 "获取更多的细节。
    • component.erp - 在清单中可以使用template('my_module/component.erp')的方式使用该模版。
  • tests/ - 讲述如何使用类和函数的一些实例。
    • init.pp
    • other_class.pp - 清单目录中的每个类和函数在实例目录中都可以有对应的实例。
  • spec/ - 讲述如何使用插件的一些实例。

 

manifests目录中的每个清单文件都只能定义一个类或函数，文件名称要与其中定义的类或函数名称对应。

init.pp是特殊的清单文件，包含的类名同模块名。 其它清单文件包含的类或函数要满足下面的规则：

模块名	::	其它目录::(如果存在)	文件名(不包含后缀)
my_module	::		other_class
my_module	::	implementation::	foo

 

 

 

• my_module::other_class必须在 my_module/manifests/other_class.pp文件中定义。
• my_module::implementation::foo必须在 my_module/manifests/implementation/foo.pp定义。

类名中间的双冒号(::)被称为命名空间分割符 (namespace separator)。

 

模块名只能包含小写字母、数字和下划线，而且必须以小写字母开头，也就是必须满足正则表达式[a-z][a-z0-9_]*。类名在相同限制上再加上不能包含命名空间分隔符。一些特殊的名称是不允许的，例如：

• main
• settings

 

模块中的静态文件都可以通过file 资源类型的source属性访问。每个静态文件都可以映射到一个URL ：

协议	三个斜杠符号	“modules”/	模块名/	文件名
puppet:	///	modules/	my_module/	service.conf

例如，puppet:///modules/my_module/service.conf对应的文件是 my_module/files/service.conf。

 

每个ERB模版文件(查阅"模版 "获取更多信息)都可以通过template函数被输出。输出的内容是一个简单的字符串，通常作为file 资源类型的content属性，或者保存到一个变量。

template函数按照下面的方式定位模版文件：

template函数	(‘	模块名/	模版名	’)
template	('	my_module/	component.erb	')

例如，template('my_module/component.erb')对应的文件是 my_module/templates/component.erb 。