# puppet-oslo

1. [先睹为快 - 一言不合，立马动手?](https://newptone.gitbook.io/deployopenstackwithpuppet/library_modules/pages/-LeYyoQ6RmgGCAUHuGtk#先睹为快)
2. [核心代码讲解 - 公共define库](https://newptone.gitbook.io/deployopenstackwithpuppet/library_modules/pages/-LeYyoQ6RmgGCAUHuGtk#核心代码讲解)
   * [define oslo::log](https://newptone.gitbook.io/deployopenstackwithpuppet/library_modules/pages/-LeYyoQ6RmgGCAUHuGtk###define%20log)
3. [小结](https://newptone.gitbook.io/deployopenstackwithpuppet/library_modules/pages/-LeYyoQ6RmgGCAUHuGtk##小结)
4. [动手练习 - 光看不练假把式](https://newptone.gitbook.io/deployopenstackwithpuppet/library_modules/pages/-LeYyoQ6RmgGCAUHuGtk##动手练习)

**本节作者：余兴超**

**建议阅读时间 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](https://en.wikipedia.org/wiki/Domain-specific_language) )，DSL不是图灵完备的([Turing complete](https://en.wikipedia.org/wiki/Turing_completeness))。因此在Puppet 4.x之前([Language: Iteration and Loops](https://docs.puppet.com/puppet/latest/reference/lang_iteration.html#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？


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://newptone.gitbook.io/deployopenstackwithpuppet/library_modules/puppet-oslo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.