puppet-oslo

  1. 先睹为快 - 一言不合，立马动手?
  2. 核心代码讲解 - 公共define库
  3. 小结
  4. 动手练习 - 光看不练假把式

本节作者：余兴超

建议阅读时间 30分钟

这是读者和作者都会感到轻松又欢快的一章，因为puppet-oslo模块的结构非常简单。
回到正题，puppet-oslo模块是我(xingchao)在16年年初提出并和鹏辉一起贡献到社区的puppet module。它的目的就是为了消灭当时存在于各模块中大量的冗余代码，例如：每个模块当中都有rabbitmq的配置，都有log的配置，都有db的配置，那么为何不做一个公共库，把这些代码抽取出来呢？

先睹为快

很可惜，这是一个公共define库，不会单独存在，而是被其他模块调用来使用。

核心代码讲解

所有代码的结构都是一样的，就是针对某个oslo.xxx库的参数设置，因此在这里我们只举一个例子来说明：

define oslo::log

在oslo::log的代码中，继续给大家讲解一些函数的使用。

以下代码中，我们看到了：

  • is_service_default用于判断变量是否使用了默认值；
  • validate_hash用于判断变量是否为hash类型；
  • join使用分隔符将list连接成字符串;
  • sort将字符串和数组进行按单词排序；
  • join_keys_to_values将key和value使用分隔符连接，例如：join_keys_to_values({‘a’=>1,’b’=>2}, “ is “)` 结果为 [“a is 1”,”b is 2”]
  1.   if is_service_default($default_log_levels) {
  2.     $default_log_levels_real = $default_log_levels
  3.   } else {
  4.     validate_hash($default_log_levels)
  5.     $default_log_levels_real = join(sort(join_keys_to_values($default_log_levels, '=')), ',')
  6.   }

我们接着往下看，下面的关键是create_resources函数，终于到了值得讲一讲的地方了。

Puppet中的迭代用法

学习Puppet的人常会问起Puppet中的迭代用法，因为多数Puppet用户都有命令式编程的经验，比如说在Bash Shell下，使用for语句来表示循环。但是Puppet是一门声明式DSL( domain-specific language )，DSL不是图灵完备的(Turing complete)。因此在Puppet 4.x之前(Language: Iteration and Loops)，是不支持迭代语法的，不过从Puppet 3.3开始，可以通过一定的配置来开启Puppet中的试验性迭代功能。

我们还有另外一种方式来实现迭代功能，那就是使用create_resources函数，create_resource可以接受3个参数:

  • resource名称
  • hash类型变量
  • 可选，hash变量，用于设置resrouce公共属性
  1. # A hash of user resources:
  2. $myusers = {
  3.   'nick' => { uid    => '1330',
  4.               gid    => allstaff,
  5.               groups => ['developers', 'operations', 'release'], },
  6.   'dan'  => { uid    => '1308',
  7.               gid    => allstaff,
  8.               groups => ['developers', 'prosvc', 'release'], },
  9. }
  10. create_resources(user, $myusers)
  12. $defaults = {
  13.   'ensure'   => present,
  14.   'provider' => 'ldap',
  15. }
  16. create_resources(user, $myusers, $defaults)

OK，我们再回过头来看这段代码，是不是就很容易理解了？

  1.   $log_options = {
  2.     'DEFAULT/debug'                         => { value => $debug },
  3.     'DEFAULT/verbose'                       => { value => $verbose },
  4.     'DEFAULT/log_config_append'             => { value => $log_config_append },
  5.     'DEFAULT/log_date_format'               => { value => $log_date_format },
  6.     'DEFAULT/log_file'                      => { value => $log_file },
  7.     'DEFAULT/log_dir'                       => { value => $log_dir },
  8.     'DEFAULT/watch_log_file'                => { value => $watch_log_file },
  9.     'DEFAULT/use_syslog'                    => { value => $use_syslog },
  10.     'DEFAULT/syslog_log_facility'           => { value => $syslog_log_facility },
  11.     'DEFAULT/use_stderr'                    => { value => $use_stderr },
  12.     'DEFAULT/logging_context_format_string' => { value => $logging_context_format_string },
  13.     'DEFAULT/logging_default_format_string' => { value => $logging_default_format_string },
  14.     'DEFAULT/logging_debug_format_suffix'   => { value => $logging_debug_format_suffix },
  15.     'DEFAULT/logging_exception_prefix'      => { value => $logging_exception_prefix },
  16.     'DEFAULT/logging_user_identity_format'  => { value => $logging_user_identity_format },
  17.     'DEFAULT/default_log_levels'            => { value => $default_log_levels_real },
  18.     'DEFAULT/publish_errors'                => { value => $publish_errors },
  19.     'DEFAULT/instance_format'               => { value => $instance_format },
  20.     'DEFAULT/instance_uuid_format'          => { value => $instance_uuid_format },
  21.     'DEFAULT/fatal_deprecations'            => { value => $fatal_deprecations },
  22.   }
  24.   create_resources($name, $log_options)

小结

这章的内容比较简单，我们主要介绍了几个函数的使用说明，着重说明了Puppet中的迭代，它们的加入使得代码逻辑变得更加强大。

动手练习

  1. define和class有什么区别？为什么要使用define而不使用class？