《Puppet实战手册》——2.2 使用社区推荐的Puppet风格

本节书摘来自异步社区《puppet实战手册》一书中的第2章，第2.2节，作者：【英】john arundel著，更多章节内容可以访问云栖社区“异步社区”公众号查看

如果其他人需要阅读或维护你的配置清单，或者如果读者想通过社区分享自己的代码，那么尽可能密切地按照现有风格、规范进行代码编写会是一个很好的主意。这些会在代码的布局、间距、引号、对齐方式和变量引用等方面进行约束，puppet实验室官方在风格上的建议可以参考<code>http://docs.puppetlabs.com/guides/style_guide</code>。

工作原理

本节会向读者展示一些更加重要的例子，以及如何确保代码是遵循风格规范的。

缩进

配置清单中使用两个空格（不要使用tab）进行缩进，可参考下面的代码：

引号

资源名字要始终使用引号注明，如下：

<code>package { 'exim4':</code>

而非如下所示：

<code>package { exim4:</code>

所有的字符串都使用单引号，除非：

字符串中引用了变量（如${name}）；

字符串中包含了转义序列（如n）。

在这些情况下，应该使用双引号。除非变量引用或转义序列在双引号内，否则puppet会不处理它们。

在puppet中要始终将非保留字的参数值用引号引起来。例如，下面的值都是非保留字：

但是，下面这些为保留字的参数值则不需要引号：

变量

当字符串中引入变量时，要确保它们的名字被大括号（{}）括起来，如下：

<code>source =&gt; "puppet:///modules/webserver/${brand}.conf",</code>

否则，puppet的语法分析器就不得不猜测哪些字符是变量名，哪些属于外围的字符串。而大括号能够帮助语法分析器明确这些语义。

参数

确保在声明参数的行尾加上逗号，即便在最后一个参数的行尾。

这种方式是puppet允许的，并且它会在用户将来增加参数或是调整参数顺序时变得更加容易。

当声明一个仅仅带有一个参数的资源时，要把全部声明写在一行，并且不要在参数行尾添加逗号。

··package { 'puppet': ensure =&gt; installed }··

而在那些多个参数的声明代码中，需要让每一个参数各占据一行。

为了使代码更容易阅读，所有的参数箭头要与最长参数名所在行的参数箭头对齐，如下所示：

箭头对齐应该在每个资源内部保持一致，而不是在整个文件中，否则会使用户难以从一个文件中剪切代码粘贴到另一个文件。

符号链接

当声明的file资源是符号链接这种类型时，要设置ensure =&gt; link及target属性，如下所示：

更多参考

当存在多人同时操作代码库时，很容易因为风格不一致而导致混乱。幸运的是，有一个工具可以自动检查代码是否符合风格指南，这个工具就是puppet-lint。在下一节，读者将看到如何使用这个工具。