Puppet文档：模块基础

Puppet模块

模块是Puppet自包含的代码和数据集合。绝大多数的清单都可以放到模块中，唯一的例外是主清单site.pp，包含站点级和节点级的代码。

每个Puppet使用者都应该要求自己能够编写一些属于自己的模块：

阅读完本文档将能够学习到如何编写和使用自己的Puppet模块。
通过"安装模块"学习如何从Puppet Forge安装模块。
通过"发布模块"学习如何发布自己的模块到Puppet Forge。
通过"使用插件"学习如何组织模块中的插件(例如自定义的行为和自定义的资源类型)和如何将它们同步到代理节点。

使用模块

Puppet能够自动载入在模块中定义的类和函数。在清单或外部节点分类器(external node classifier，ENC)中，类或者函数都可以通过名字的方式被定义：

# /etc/puppetlabs/puppet/site.pp

node default {
    include apache

    class {'ntp':
        enable => false;
    }
    
    apache::vhost {'personal_site':
        port    => 80,
        docroot => '/var/www/personal',
        options => 'Indexes MultiViews',
    }
}

同样地，Puppet也能够自动地载入在模块中定义的插件（例如自定义的行为和自定义的资源类型）。查阅"使用插件"获取更多的细节。

编写的模块要在Puppet中能够使用，必须将它放在moudlepath配置的一个目录中。

modulepath配置是通过系统路径分隔符连起来的一系列目录。绝大多数情况下是这样的：

/etc/puppetlabs/puppet/modules:/opt/puppet/share/puppet/modules (针对Puppet企业版本)
/etc/puppet/modules:/usr/share/puppet/modules (针对Puppet开源版本)

使用puppet config print modulepath命令可以查看当前的modulepath配置。

使用puppet.conf配置时，如果需要Puppet服务器和代理都能够访问到模块，则modulepath配置必须出现在[main]节。modulepath也可以根据不同的环境设置不同的配置。

使用puppet module命令可以方便地安装其它使用者编写的模块。查阅"安装模块"获取更多的细节。

模块结构

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

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。

编写模块

通过上面的讲述，现在我们应该能够编写简单的类和函数了。

Classes：获取关于类的更多信息。
Defined Resource Types：获取关于函数的更多信息。

最佳实践

一个模块中的类、函数和插件可以是互相关联的。

一个模块中的清单绝不应该引用其它模块中的文件或模块。

如果有模块中的一个类使用了其它模块中的另外一个类，这种情况应该尽可能避免，它会让模块的发布变得非常困难。解决此问题的方法是创建一个包含很多“超级类”的公共模块。