Question

1. 动手练习－光看不练假把式

本节作者：周维宇

建议阅读时间 2 小时

基础知识

cinder 概述

• 它是一个资源管理系统，负责向虚拟机提供持久块存储资源（云硬盘)。
• 主要核心是对卷的管理，允许对卷，卷的类型，卷的快照进行处理
• 它把不同的后端存储进行封装，向外提供统一的 API。
• 它不是新开发的块设备存储系统，而是使用插件的方式结合不同后端存储的驱动提供块存储服务。

cinder 架构

上图环境是根据本章的实验环境绘制

主要组件介绍

• cinder-api：主要服务接口，负责接受和处理外界的 API 请求，并将请求放入消息队列，交由其他组件执行。
• cinder-scheduer: 根据预定的策略选择合适的 cinder-volume 节点来处理用户的请求，如果用户请求中执行的具体的存储节点则不需要 cinder-scheduler 介入。
• cinder-volume: 该服务运行在存储节点，通过 driver 负责实际的卷管理工作。
• cinder-backup: 备份 cinder 卷到其他存储(swift,ceph 等)。

实验环境说明

• cinder-api/mariadb/rabbitmq 部署在控制节点,cinder-volume/ceph-monitor/ceph-osd 部署在存储节点（你也可以把所有服务部署在同一节点)
• 部署了两个 cinder－volume,一个使用 ceph 作为存储后端，一个使用 lvm 作为存储后端
• 本实验环境依赖前面章节部署的 mariadb/keystone/ceph/rabbitmq

先睹为快

在讲解 cinder 模块之前让我们先使用 puppet 把我们的实验环境部署起来，请根据你的具体环境修改 learn_cinder.pp

编写 learn_cinder.pp

class  { 'cinder':
  database_connection     => 'mysql://cinder:secret_block_password@openstack-controller.example.com/cinder',
  rabbit_password         => 'secret_rpc_password_for_blocks',
  rabbit_host             => 'openstack-controller.example.com',
  verbose                 => true,
}

class  { 'cinder::api':
  keystone_password       => $keystone_password,
  keystone_enabled        => $keystone_enabled,
  keystone_user           => $keystone_user,
  keystone_auth_host      => $keystone_auth_host,
  keystone_auth_port      => $keystone_auth_port,
  keystone_auth_protocol  => $keystone_auth_protocol,
  service_port            => $keystone_service_port,
  package_ensure          => $cinder_api_package_ensure,
  bind_host               => $cinder_bind_host,
  enabled                 => $cinder_api_enabled,
}

class  { 'cinder::scheduler': }

class  { 'cinder::volume': }

cinder::backend::rbd {'rbd-images':
  rbd_pool => 'images',
  rbd_user => 'images',
}

cinder_type {'ceph':
  ensure     => present,
  properties => ['volume_backend_name=rbd-images'],
}

class  { 'cinder::backends':
  enabled_backends => ['iscsi1', 'iscsi2', 'rbd-images']
}

在终端执行以下命令:

puppet apply -v learn_cinder.pp

ok，恭喜你，已经有了一个使用 ceph 作为后端的 cinder 服务，敢紧来试试吧

source openrc
openstack volume create test_cinder --size 1 --type ceph

你已经创建了一个 1G 大小的 cinder 卷

核心代码讲解

Class cinder

class cinder 非常简单主要做了两件核心工作

• 安装 cinder 基础包
• 配置 cinder.conf 中的核心参数

软件包管理

这里有一个非常有用的参数是$package_ensure，我们可以指定软件包的版本，或者将其标记为总是安装最新版本，我们将会在最佳实践部分去介绍它。

  package { 'cinder':
    ensure  => $package_ensure,
    name    => $::cinder::params::package_name,
    tag     => ['openstack', 'cinder-package'],
    require => Anchor['cinder-start'],
  }

cinder 核心参数管理

class cinder 里管理了大量的配置参数，比如 db,rpc,az 设置等相关参数，这里不一一列举。 这里只一个代码片段为例来解释 cinder_config 的用法。和前面介绍的 keystone_config 类似 cinder_config 是一个自定义的 resource type，其源码路径位于：

lib/puppet/type/cinder_config.rb 定义

lib/puppet/provider/cinder_config/ini_setting.rb 实现

在这里我们关注如何使用，在 Advanced Puppet 一书中我们将讲解如何编写 custom resource type。 cinder_config 有多种使用方法:

对指定参数赋值：

cinder_config { 'section_name/option_name': value => option_value}

对指定参数赋值，并设置为加密：

cinder_config { 'section_name/option_name': value => option_value， secret => true}

我们知道 puppet agent 的所有输出默认都会被 syslog 打到系统日志/var/log/messages 中，那么有心人只要用 grep 就能从中搜到许多敏感信息，例如：admin_token, user_password, keystone_db_password 等等。只要设置了 secret 为 true 后，那么就不会把该参数的相关日志打到系统日志中。 OK，讲解就到这里，我们来看代码。

  cinder_config {
    'DEFAULT/enable_v1_api':        value => $enable_v1_api;
    'DEFAULT/enable_v2_api':        value => $enable_v2_api;
    'DEFAULT/enable_v3_api':        value => $enable_v3_api;
  }

Class cinder::api

class cinder::api 主要配置和管理 cinder 的 api 服务

管理服务

cinder 可以作为一个服务启动，也可以启动在 apache 下

  if $service_name == $::cinder::params::api_service {
    service { 'cinder-api':
      ensure    => $ensure,
      name      => $::cinder::params::api_service,
      enable    => $enabled,
      hasstatus => true,
      require   => Package['cinder'],
      tag       => 'cinder-service',
    }

  } elsif $service_name == 'httpd' {
    include ::apache::params
    service { 'cinder-api':
      ensure => 'stopped',
      name   => $::cinder::params::api_service,
      enable => false,
      tag    => ['cinder-service'],
    }

服务检查

调用 cinder list 命令来确确认 cinder 服务是否 ready

  if $validate {
    $defaults = {
      'cinder-api' => {
        'command'  => "cinder --os-auth-url ${auth_uri} --os-tenant-name ${keystone_tenant} --os-username ${keystone_user} --os-password ${keystone_password} list",
      }
    }
    $validation_options_hash = merge ($defaults, $validation_options)
    create_resources('openstacklib::service_validation', $validation_options_hash, {'subscribe' => 'Service[cinder-api]'})
  }

Class cinder::scheduler

这个 class 没什么好讲的，无非是装包，改配置，启服务三板斧

Class cinder::volume

同上

Class cinder::backup

同上

Define cinder::backend::backend_name

后端的定义由很多 define 组成，我们举例我们用到的 cinder::backend::rbd,比较值得注意的是用 define 来实现后端定义，因为在 cinder 中可能有多个同一类型的后端，比如一个 cinder 配置两个 ceph 作为 cinder 存储后端，这时候用 class 实现显然是不合适的 主要也是调用 cinder_config 来修改 cinder.conf 文件

  cinder_config {
    "${name}/volume_backend_name":              value => $volume_backend_name;
    "${name}/volume_driver":                    value => 'cinder.volume.drivers.rbd.RBDDriver';
    "${name}/rbd_ceph_conf":                    value => $rbd_ceph_conf;
    "${name}/rbd_user":                         value => $rbd_user;
    "${name}/rbd_pool":                         value => $rbd_pool;
    "${name}/rbd_max_clone_depth":              value => $rbd_max_clone_depth;
    "${name}/rbd_flatten_volume_from_snapshot": value => $rbd_flatten_volume_from_snapshot;
    "${name}/rbd_secret_uuid":                  value => $rbd_secret_uuid;
    "${name}/rados_connect_timeout":            value => $rados_connect_timeout;
    "${name}/rados_connection_interval":        value => $rados_connection_interval;
    "${name}/rados_connection_retries":         value => $rados_connection_retries;
    "${name}/rbd_store_chunk_size":             value => $rbd_store_chunk_size;
  }

Class cinder::backends

由于 cinder 支持多后端，这个类主要用来管理开启哪些存储后端

调用 cinder_config 来修改 cinder.conf

class cinder::backends (
  $enabled_backends    = undef,
) {

  # Maybe this could be extented to dynamicly find the enabled names
  cinder_config {
    'DEFAULT/enabled_backends': value => join($enabled_backends, ',');
  }
}

Define cinder::type

cinder 开启多后端后，如何确定要将卷创建到哪个后端呢，这就要有 type 来决定。

define cinder::type (
  $set_key        = undef,
  $set_value      = undef,
  # DEPRECATED PARAMETERS
  $os_password    = undef,
  $os_tenant_name = undef,
  $os_username    = undef,
  $os_auth_url    = undef,
  $os_region_name = undef,
  ) {

  if $os_password or $os_region_name or $os_tenant_name or $os_username or $os_auth_url {
    warning('Parameters $os_password/$os_region_name/$os_tenant_name/$os_username/$os_auth_url are not longer required')
    warning('Auth creds will be used from env or /root/openrc file or cinder.conf')
  }

  if ($set_value and $set_key) {
    if is_array($set_value) {
      $value = join($set_value, ',')
    } else {
      $value = $set_value
    }
    cinder_type { $name:
      ensure     => present,
      properties => ["${set_key}=${value}"],
    }
  } else {
    cinder_type { $name:
      ensure     => present,
    }
  }
}

这个关键的是 cinder_type,其源码路径为

lib/puppet/type/cinder_type.rb

lib/puppet/provider/cinder_type/openstack.rb

小结

ok，核心代码的解析就到这里，后面的像 cinder::quota,cinder::policy,cinder::logging 等配置就不在一一解析，留给读者课后去学习.总之 puppet-cinder 除了多后端配置和其他模块略有不同之外，其余部分都十分相似，是一个比较容易学习的模块。

动手练习

1.在另外一个节点部署一个 cinder-volume，并使用 lvm 作存储后端。

2.创建一个新的 volume-type lvm,将该 type 的卷存储到 lvm 后端。

3.创建一个 type 为 lvm 的卷，并挂载到虚机。