Puppet Class: manila

Inherits:
manila::params
Defined in:
manifests/init.pp

Overview

Class: manila

Parameters

state_path

(optional) Directory for storing state. Defaults to ‘/var/lib/manila’

default_transport_url

(optional) A URL representing the messaging driver to use and its full configuration. Transport URLs take the form:

transport://user:pass@host1:port[,hostN:portN]/virtual_host

Defaults to $facts

rpc_response_timeout

(Optional) Seconds to wait for a response from a call. Defaults to $facts

control_exchange

(Optional) The default exchange under which topics are scope. Defaults to $facts

executor_thread_pool_size

(Optional) Size of executor thread pool when executor is threading or eventlet. Defaults to $facts.

package_ensure

(Optional) Ensure state for package. Defaults to ‘present’

notification_transport_url

(optional) A URL representing the messaging driver to use for notifications and its full configuration. Transport URLs take the form:

transport://user:pass@host1:port[,hostN:portN]/virtual_host

Defaults to $facts.

notification_topics

(optional) AMQP topics to publish to when using the RPC notification driver. (list value) Default to $facts

notification_driver

(optional) Driver or drivers to handle sending notifications. Defaults to ‘messaging’

rabbit_ha_queues

(optional) Use HA queues in RabbitMQ (x-ha-policy: all). Defaults to $facts.

rabbit_quorum_queue

(Optional) Use quorum queues in RabbitMQ. Defaults to $facts

rabbit_transient_quorum_queue

(Optional) Use quorum queues for transients queues in RabbitMQ. Defaults to $facts

rabbit_quorum_delivery_limit

(Optional) Each time a message is rdelivered to a consumer, a counter is incremented. Once the redelivery count exceeds the delivery limit the message gets dropped or dead-lettered. Defaults to $facts

rabbit_quorum_max_memory_length

(Optional) Limit the number of messages in the quorum queue. Defaults to $facts

rabbit_quorum_max_memory_bytes

(Optional) Limit the number of memory bytes used by the quorum queue. Defaults to $facts

rabbit_use_ssl

(Optional) Connect over SSL for RabbitMQ. Defaults to $facts.

kombu_ssl_ca_certs

(optional) SSL certification authority file (valid only if SSL enabled). Defaults to $facts

kombu_ssl_certfile

(optional) SSL cert file (valid only if SSL enabled). Defaults to $facts

kombu_ssl_keyfile

(optional) SSL key file (valid only if SSL enabled). Defaults to $facts

kombu_ssl_version

(optional) SSL version to use (valid only if SSL enabled). Valid values are TLSv1, SSLv23 and SSLv3. SSLv2 may be available on some distributions. Defaults to $facts

kombu_failover_strategy

(Optional) Determines how the next RabbitMQ node is chosen in case the one we are currently connected to becomes unavailable. Takes effect only if more than one RabbitMQ node is provided in config. (string value) Defaults to $facts

amqp_durable_queues

(optional) Use durable queues in amqp. Defaults to $facts.

use_ssl

(optional) Enable SSL on the API server Defaults to false, not set

cert_file

(optional) Certificate file to use when starting API server securely Defaults to false, not set

key_file

(optional) Private key file to use when starting API server securely Defaults to false, not set

ca_file

(optional) CA certificate file to use to verify connecting clients Defaults to false, not set_

api_paste_config

(Optional) Allow Configuration of /etc/manila/api-paste.ini.

storage_availability_zone

(optional) Availability zone of the node. Defaults to ‘nova’

rootwrap_config

(optional) Path to the rootwrap configuration file to use for running commands as root

lock_path

(optional) Location to store Manila locks Defaults to $::manila::params::lock_path

amqp_server_request_prefix

address prefix used when sending to a specific server Defaults to ‘exclusive’

amqp_broadcast_prefix

address prefix used when broadcasting to all servers Defaults to ‘broadcast’

amqp_group_request_prefix

address prefix when sending to any server in group Defaults to ‘unicast’

amqp_container_name

Name for the AMQP container Defaults to guest

amqp_idle_timeout

Timeout for inactive connections (in seconds) Defaults to 0

amqp_trace

Debug: dump AMQP frames to stdout Defaults to false

amqp_ssl_ca_file

(optional) CA certificate PEM file to verify server certificate Defaults to $facts

amqp_ssl_cert_file

(optional) Identifying certificate PEM file to present to clients Defaults to $facts

amqp_ssl_key_file

(optional) Private key PEM file used to sign cert_file certificate Defaults to $facts

amqp_ssl_key_password

(optional) Password for decrypting ssl_key_file (if encrypted) Defaults to $facts

amqp_sasl_mechanisms

(Optional) Space separated list of acceptable SASL mechanisms Defaults to $facts.

amqp_sasl_config_dir

(Optional) Path to directory that contains the SASL configuration Defaults to $facts.

amqp_sasl_config_name

(Optional) Name of configuration file (without .conf suffix) Defaults to $facts.

amqp_username

(Optional) User name for message broker authentication Defaults to $facts.

amqp_password

(Optional) Password for message broker authentication Defaults to $facts.

purge_config

(optional) Whether to set only the specified config options in the manila config. Defaults to false.

host

(optional) Name of this node. This can be an opaque identifier. It is not necessarily a host name, FQDN, or IP address. Defaults to $facts

rabbit_heartbeat_in_pthread

(Optional) EXPERIMENTAL: Run the health check heartbeat thread through a native python thread. By default if this option isn’t provided the health check heartbeat will inherit the execution model from the parent process. By example if the parent process have monkey patched the stdlib by using eventlet/greenlet then the heartbeat will be run through a green thread. Defaults to $facts

report_interval

(optional) Seconds between nodes reporting state to datastore. Defaults to $facts

periodic_interval

(optional) Seconds between running periodic tasks. Defaults to $facts

periodic_fuzzy_delay

(optional) Range of seconds to randomly delay when starting the periodic task scheduler to reduce stampeding. Defaults to $facts.

Parameters:

  • default_transport_url (Any) (defaults to: $facts['os_service_default'])
  • rpc_response_timeout (Any) (defaults to: $facts['os_service_default'])
  • control_exchange (Any) (defaults to: $facts['os_service_default'])
  • executor_thread_pool_size (Any) (defaults to: $facts['os_service_default'])
  • notification_transport_url (Any) (defaults to: $facts['os_service_default'])
  • notification_driver (Any) (defaults to: 'messaging')
  • notification_topics (Any) (defaults to: $facts['os_service_default'])
  • rabbit_ha_queues (Any) (defaults to: $facts['os_service_default'])
  • rabbit_quorum_queue (Any) (defaults to: $facts['os_service_default'])
  • rabbit_transient_quorum_queue (Any) (defaults to: $facts['os_service_default'])
  • rabbit_quorum_delivery_limit (Any) (defaults to: $facts['os_service_default'])
  • rabbit_quorum_max_memory_length (Any) (defaults to: $facts['os_service_default'])
  • rabbit_quorum_max_memory_bytes (Any) (defaults to: $facts['os_service_default'])
  • rabbit_use_ssl (Any) (defaults to: $facts['os_service_default'])
  • kombu_ssl_ca_certs (Any) (defaults to: $facts['os_service_default'])
  • kombu_ssl_certfile (Any) (defaults to: $facts['os_service_default'])
  • kombu_ssl_keyfile (Any) (defaults to: $facts['os_service_default'])
  • kombu_ssl_version (Any) (defaults to: $facts['os_service_default'])
  • kombu_failover_strategy (Any) (defaults to: $facts['os_service_default'])
  • amqp_durable_queues (Any) (defaults to: $facts['os_service_default'])
  • rabbit_heartbeat_in_pthread (Any) (defaults to: $facts['os_service_default'])
  • package_ensure (Any) (defaults to: 'present')
  • use_ssl (Boolean) (defaults to: false)
  • ca_file (Any) (defaults to: false)
  • cert_file (Any) (defaults to: false)
  • key_file (Any) (defaults to: false)
  • api_paste_config (Any) (defaults to: '/etc/manila/api-paste.ini')
  • storage_availability_zone (Any) (defaults to: 'nova')
  • rootwrap_config (Any) (defaults to: '/etc/manila/rootwrap.conf')
  • state_path (Any) (defaults to: '/var/lib/manila')
  • lock_path (Any) (defaults to: $::manila::params::lock_path)
  • amqp_server_request_prefix (Any) (defaults to: $facts['os_service_default'])
  • amqp_broadcast_prefix (Any) (defaults to: $facts['os_service_default'])
  • amqp_group_request_prefix (Any) (defaults to: $facts['os_service_default'])
  • amqp_container_name (Any) (defaults to: $facts['os_service_default'])
  • amqp_idle_timeout (Any) (defaults to: $facts['os_service_default'])
  • amqp_trace (Any) (defaults to: $facts['os_service_default'])
  • amqp_ssl_ca_file (Any) (defaults to: $facts['os_service_default'])
  • amqp_ssl_cert_file (Any) (defaults to: $facts['os_service_default'])
  • amqp_ssl_key_file (Any) (defaults to: $facts['os_service_default'])
  • amqp_ssl_key_password (Any) (defaults to: $facts['os_service_default'])
  • amqp_sasl_mechanisms (Any) (defaults to: $facts['os_service_default'])
  • amqp_sasl_config_dir (Any) (defaults to: $facts['os_service_default'])
  • amqp_sasl_config_name (Any) (defaults to: $facts['os_service_default'])
  • amqp_username (Any) (defaults to: $facts['os_service_default'])
  • amqp_password (Any) (defaults to: $facts['os_service_default'])
  • purge_config (Boolean) (defaults to: false)
  • host (Any) (defaults to: $facts['os_service_default'])
  • report_interval (Any) (defaults to: $facts['os_service_default'])
  • periodic_interval (Any) (defaults to: $facts['os_service_default'])
  • periodic_fuzzy_delay (Any) (defaults to: $facts['os_service_default'])


229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
# File 'manifests/init.pp', line 229

class manila (
  $default_transport_url           = $facts['os_service_default'],
  $rpc_response_timeout            = $facts['os_service_default'],
  $control_exchange                = $facts['os_service_default'],
  $executor_thread_pool_size       = $facts['os_service_default'],
  $notification_transport_url      = $facts['os_service_default'],
  $notification_driver             = 'messaging',
  $notification_topics             = $facts['os_service_default'],
  $rabbit_ha_queues                = $facts['os_service_default'],
  $rabbit_quorum_queue             = $facts['os_service_default'],
  $rabbit_transient_quorum_queue   = $facts['os_service_default'],
  $rabbit_quorum_delivery_limit    = $facts['os_service_default'],
  $rabbit_quorum_max_memory_length = $facts['os_service_default'],
  $rabbit_quorum_max_memory_bytes  = $facts['os_service_default'],
  $rabbit_use_ssl                  = $facts['os_service_default'],
  $kombu_ssl_ca_certs              = $facts['os_service_default'],
  $kombu_ssl_certfile              = $facts['os_service_default'],
  $kombu_ssl_keyfile               = $facts['os_service_default'],
  $kombu_ssl_version               = $facts['os_service_default'],
  $kombu_failover_strategy         = $facts['os_service_default'],
  $amqp_durable_queues             = $facts['os_service_default'],
  $rabbit_heartbeat_in_pthread     = $facts['os_service_default'],
  $package_ensure                  = 'present',
  Boolean $use_ssl                 = false,
  $ca_file                         = false,
  $cert_file                       = false,
  $key_file                        = false,
  $api_paste_config                = '/etc/manila/api-paste.ini',
  $storage_availability_zone       = 'nova',
  $rootwrap_config                 = '/etc/manila/rootwrap.conf',
  $state_path                      = '/var/lib/manila',
  $lock_path                       = $::manila::params::lock_path,
  $amqp_server_request_prefix      = $facts['os_service_default'],
  $amqp_broadcast_prefix           = $facts['os_service_default'],
  $amqp_group_request_prefix       = $facts['os_service_default'],
  $amqp_container_name             = $facts['os_service_default'],
  $amqp_idle_timeout               = $facts['os_service_default'],
  $amqp_trace                      = $facts['os_service_default'],
  $amqp_ssl_ca_file                = $facts['os_service_default'],
  $amqp_ssl_cert_file              = $facts['os_service_default'],
  $amqp_ssl_key_file               = $facts['os_service_default'],
  $amqp_ssl_key_password           = $facts['os_service_default'],
  $amqp_sasl_mechanisms            = $facts['os_service_default'],
  $amqp_sasl_config_dir            = $facts['os_service_default'],
  $amqp_sasl_config_name           = $facts['os_service_default'],
  $amqp_username                   = $facts['os_service_default'],
  $amqp_password                   = $facts['os_service_default'],
  Boolean $purge_config            = false,
  $host                            = $facts['os_service_default'],
  $report_interval                 = $facts['os_service_default'],
  $periodic_interval               = $facts['os_service_default'],
  $periodic_fuzzy_delay            = $facts['os_service_default'],
) inherits manila::params {

  include manila::deps
  include manila::db

  if $use_ssl {
    if !$cert_file {
      fail('The cert_file parameter is required when use_ssl is set to true')
    }
    if !$key_file {
      fail('The key_file parameter is required when use_ssl is set to true')
    }
  }

  package { 'manila':
    ensure => $package_ensure,
    name   => $::manila::params::package_name,
    tag    => ['openstack', 'manila-package'],
  }

  resources { 'manila_config':
    purge => $purge_config,
  }

  oslo::messaging::rabbit { 'manila_config':
    rabbit_use_ssl                  => $rabbit_use_ssl,
    amqp_durable_queues             => $amqp_durable_queues,
    rabbit_ha_queues                => $rabbit_ha_queues,
    kombu_ssl_ca_certs              => $kombu_ssl_ca_certs,
    kombu_ssl_certfile              => $kombu_ssl_certfile,
    kombu_ssl_keyfile               => $kombu_ssl_keyfile,
    kombu_ssl_version               => $kombu_ssl_version,
    kombu_failover_strategy         => $kombu_failover_strategy,
    heartbeat_in_pthread            => $rabbit_heartbeat_in_pthread,
    rabbit_quorum_queue             => $rabbit_quorum_queue,
    rabbit_transient_quorum_queue   => $rabbit_transient_quorum_queue,
    rabbit_quorum_delivery_limit    => $rabbit_quorum_delivery_limit,
    rabbit_quorum_max_memory_length => $rabbit_quorum_max_memory_length,
    rabbit_quorum_max_memory_bytes  => $rabbit_quorum_max_memory_bytes,
  }

  oslo::messaging::amqp { 'manila_config':
    server_request_prefix => $amqp_server_request_prefix,
    broadcast_prefix      => $amqp_broadcast_prefix,
    group_request_prefix  => $amqp_group_request_prefix,
    container_name        => $amqp_container_name,
    idle_timeout          => $amqp_idle_timeout,
    trace                 => $amqp_trace,
    ssl_ca_file           => $amqp_ssl_ca_file,
    ssl_key_password      => $amqp_ssl_key_password,
    ssl_cert_file         => $amqp_ssl_cert_file,
    ssl_key_file          => $amqp_ssl_key_file,
    sasl_mechanisms       => $amqp_sasl_mechanisms,
    sasl_config_dir       => $amqp_sasl_config_dir,
    sasl_config_name      => $amqp_sasl_config_name,
    username              => $amqp_username,
    password              => $amqp_password,
  }

  oslo::messaging::default { 'manila_config':
    executor_thread_pool_size => $executor_thread_pool_size,
    transport_url             => $default_transport_url,
    rpc_response_timeout      => $rpc_response_timeout,
    control_exchange          => $control_exchange,
  }

  oslo::messaging::notifications { 'manila_config':
    transport_url => $notification_transport_url,
    driver        => $notification_driver,
    topics        => $notification_topics,
  }

  manila_config {
    'DEFAULT/api_paste_config':          value => $api_paste_config;
    'DEFAULT/storage_availability_zone': value => $storage_availability_zone;
    'DEFAULT/rootwrap_config':           value => $rootwrap_config;
    'DEFAULT/state_path':                value => $state_path;
    'DEFAULT/host':                      value => $host;
    'DEFAULT/report_interval':           value => $report_interval;
    'DEFAULT/periodic_interval':         value => $periodic_interval;
    'DEFAULT/periodic_fuzzy_delay':      value => $periodic_fuzzy_delay;
  }

  oslo::concurrency { 'manila_config': lock_path => $lock_path }

  # SSL Options
  if $use_ssl {
    manila_config {
      'DEFAULT/ssl_cert_file' : value => $cert_file;
      'DEFAULT/ssl_key_file' :  value => $key_file;
    }
    if $ca_file {
      manila_config { 'DEFAULT/ssl_ca_file' :
        value => $ca_file,
      }
    } else {
      manila_config { 'DEFAULT/ssl_ca_file' :
        ensure => absent,
      }
    }
  } else {
    manila_config {
      'DEFAULT/ssl_cert_file' : ensure => absent;
      'DEFAULT/ssl_key_file' :  ensure => absent;
      'DEFAULT/ssl_ca_file' :   ensure => absent;
    }
  }

}