puppet-oslo

1. 先睹为快 - 一言不合，立马动手?

2. 核心代码讲解 - 公共define库

   • define oslo::log

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”]

  if is_service_default($default_log_levels) {
    $default_log_levels_real = $default_log_levels
  } else {
    validate_hash($default_log_levels)
    $default_log_levels_real = join(sort(join_keys_to_values($default_log_levels, '=')), ',')
  }

我们接着往下看，下面的关键是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公共属性

# A hash of user resources:
$myusers = {
  'nick' => { uid    => '1330',
              gid    => allstaff,
              groups => ['developers', 'operations', 'release'], },
  'dan'  => { uid    => '1308',
              gid    => allstaff,
              groups => ['developers', 'prosvc', 'release'], },
}
create_resources(user, $myusers)

$defaults = {
  'ensure'   => present,
  'provider' => 'ldap',
}
create_resources(user, $myusers, $defaults)

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

  $log_options = {
    'DEFAULT/debug'                         => { value => $debug },
    'DEFAULT/verbose'                       => { value => $verbose },
    'DEFAULT/log_config_append'             => { value => $log_config_append },
    'DEFAULT/log_date_format'               => { value => $log_date_format },
    'DEFAULT/log_file'                      => { value => $log_file },
    'DEFAULT/log_dir'                       => { value => $log_dir },
    'DEFAULT/watch_log_file'                => { value => $watch_log_file },
    'DEFAULT/use_syslog'                    => { value => $use_syslog },
    'DEFAULT/syslog_log_facility'           => { value => $syslog_log_facility },
    'DEFAULT/use_stderr'                    => { value => $use_stderr },
    'DEFAULT/logging_context_format_string' => { value => $logging_context_format_string },
    'DEFAULT/logging_default_format_string' => { value => $logging_default_format_string },
    'DEFAULT/logging_debug_format_suffix'   => { value => $logging_debug_format_suffix },
    'DEFAULT/logging_exception_prefix'      => { value => $logging_exception_prefix },
    'DEFAULT/logging_user_identity_format'  => { value => $logging_user_identity_format },
    'DEFAULT/default_log_levels'            => { value => $default_log_levels_real },
    'DEFAULT/publish_errors'                => { value => $publish_errors },
    'DEFAULT/instance_format'               => { value => $instance_format },
    'DEFAULT/instance_uuid_format'          => { value => $instance_uuid_format },
    'DEFAULT/fatal_deprecations'            => { value => $fatal_deprecations },
  }

  create_resources($name, $log_options)

小结

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

动手练习

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