# == Class: manila::api # # Setup and configure the manila API endpoint # # === Parameters # # [*auth_strategy*] # (optional) Type of authentication to be used. # Defaults to 'keystone' # # [*package_ensure*] # (optional) The state of the package # Defaults to present # # [*bind_host*] # (optional) The manila api bind address # Defaults to 0.0.0.0 # # [*default_share_type*] # (optional) Name of default share type which is used if user doesn't # set a share type explicitly when creating a share. # Defaults to $::os_service_default. # # [*enabled*] # (optional) The state of the service # Defaults to true # # [*sync_db*] # (optional) Run db sync on the node # Defaults to true # # [*service_name*] # (optional) Name of the service that will be providing the # server functionality of manila-api. # If the value is 'httpd', this means manila-api will be a web # service, and you must use another class to configure that # web service. For example, use class { 'manila::wsgi::apache'...} # to make manila-api be a web app using apache mod_wsgi. # Defaults to '$::manila::params::api_service' # # [*manage_service*] # (optional) Whether to start/stop the service # Defaults to true # # [*ratelimits*] # (optional) The state of the service # Defaults to undef. If undefined the default ratelimiting values are used. # # [*ratelimits_factory*] # (optional) Factory to use for ratelimiting # Defaults to 'manila.api.v1.limits:RateLimitingMiddleware.factory' # # [*enable_proxy_headers_parsing*] # (Optional) Enable paste middleware to handle SSL requests through # HTTPProxyToWSGI middleware. # Defaults to $::os_service_default. # # [*max_request_body_size*] # (Optional) Set max request body size # Defaults to $::os_service_default. # # [*enabled_share_protocols*] # (optional) Defines the enabled share protocols provided by Manila. # Defaults to $::os_service_default # # [*service_workers*] # (optional) Number of manila-api workers # Defaults to $::os_workers # class manila::api ( $auth_strategy = 'keystone', $package_ensure = 'present', $bind_host = '0.0.0.0', $default_share_type = $::os_service_default, $enabled = true, $sync_db = true, $manage_service = true, $service_name = $::manila::params::api_service, $ratelimits = undef, $ratelimits_factory = 'manila.api.v1.limits:RateLimitingMiddleware.factory', $enable_proxy_headers_parsing = $::os_service_default, $max_request_body_size = $::os_service_default, $enabled_share_protocols = $::os_service_default, $service_workers = $::os_workers, ) inherits manila::params { include manila::deps include manila::params include manila::policy require keystone::client if $::manila::params::api_package { package { 'manila-api': ensure => $package_ensure, name => $::manila::params::api_package, tag => ['openstack', 'manila-package'], } } if $sync_db { include manila::db::sync } if $enabled { if $manage_service { $ensure = 'running' } } else { if $manage_service { $ensure = 'stopped' } } if $service_name == $::manila::params::api_service { service { 'manila-api': ensure => $ensure, name => $::manila::params::api_service, enable => $enabled, hasstatus => true, tag => 'manila-service', } } elsif $service_name == 'httpd' { # We need to make sure manila-api/eventlet is stopped before trying to # start apache include apache::params service { 'manila-api': ensure => 'stopped', name => $::manila::params::api_service, enable => false, tag => ['manila-service'], } Service <| title == 'httpd' |> { tag +> 'manila-service' } Service['manila-api'] -> Service[$service_name] } else { fail("Invalid service_name. Either use manila-api/openstack-manila-api \ for running as a standalone service, or httpd for being run by a httpd \ server.") } manila_config { 'DEFAULT/osapi_share_listen': value => $bind_host; 'DEFAULT/enabled_share_protocols': value => $enabled_share_protocols; 'DEFAULT/default_share_type': value => $default_share_type; 'DEFAULT/osapi_share_workers': value => $service_workers; } oslo::middleware { 'manila_config': enable_proxy_headers_parsing => $enable_proxy_headers_parsing, max_request_body_size => $max_request_body_size, } if $auth_strategy == 'keystone' { manila_config { 'DEFAULT/auth_strategy': value => $auth_strategy; } include manila::keystone::authtoken if ($ratelimits != undef) { manila_api_paste_ini { 'filter:ratelimit/paste.filter_factory': value => $ratelimits_factory; 'filter:ratelimit/limits': value => $ratelimits; } } } }