diff --git a/lib/puppet/provider/manila_api_uwsgi_config/ini_setting.rb b/lib/puppet/provider/manila_api_uwsgi_config/ini_setting.rb new file mode 100644 index 00000000..a11c6cd6 --- /dev/null +++ b/lib/puppet/provider/manila_api_uwsgi_config/ini_setting.rb @@ -0,0 +1,8 @@ +Puppet::Type.type(:manila_api_uwsgi_config).provide( + :ini_setting, + :parent => Puppet::Type.type(:openstack_config).provider(:ini_setting) +) do + def self.file_path + '/etc/manila/manila-api-uwsgi.ini' + end +end diff --git a/lib/puppet/type/manila_api_uwsgi_config.rb b/lib/puppet/type/manila_api_uwsgi_config.rb new file mode 100644 index 00000000..dd9ab3bc --- /dev/null +++ b/lib/puppet/type/manila_api_uwsgi_config.rb @@ -0,0 +1,29 @@ +Puppet::Type.newtype(:manila_api_uwsgi_config) do + + ensurable + + newparam(:name, :namevar => true) do + desc 'Section/setting name to manage from /etc/manila/manila-api-uwsgi.ini' + newvalues(/\S+\/\S+/) + end + + newproperty(:value) do + desc 'The value of the setting to be defined.' + munge do |value| + value = value.to_s.strip + value.capitalize! if value =~ /^(true|false)$/i + value + end + newvalues(/^[\S ]*$/) + end + + newparam(:ensure_absent_val) do + desc 'A value that is specified as the value property will behave as if ensure => absent was specified' + defaultto('') + end + + autorequire(:anchor) do + ['manila::install::end'] + end + +end diff --git a/manifests/deps.pp b/manifests/deps.pp index 68f279dd..bc71a61c 100644 --- a/manifests/deps.pp +++ b/manifests/deps.pp @@ -38,6 +38,11 @@ class manila::deps { -> Openstacklib::Policy::Base<||> ~> Anchor['manila::config::end'] + # On any uwsgi config change, we must restart Manila API. + Anchor['manila::config::begin'] + -> Manila_api_uwsgi_config<||> + ~> Anchor['manila::config::end'] + # Support packages need to be installed in the install phase, but we don't # put them in the chain above because we don't want any false dependencies # between packages with the manila-package tag and the manila-support-package diff --git a/manifests/wsgi/uwsgi.pp b/manifests/wsgi/uwsgi.pp new file mode 100644 index 00000000..21fd5ac0 --- /dev/null +++ b/manifests/wsgi/uwsgi.pp @@ -0,0 +1,41 @@ +# +# Copyright 2021 Thomas Goirand +# +# Author: Thomas Goirand +# +# == Class: manila::wsgi::uwsgi +# +# Configure the UWSGI service for Manila API. +# +# == Parameters +# +# [*processes*] +# (Optional) Number of processes. +# Defaults to $::os_workers. +# +# [*threads*] +# (Optional) Number of threads. +# Defaults to 32. +# +# [*listen_queue_size*] +# (Optional) Socket listen queue size. +# Defaults to 100 +# +class manila::wsgi::uwsgi ( + $processes = $::os_workers, + $threads = 32, + $listen_queue_size = 100, +){ + + include manila::deps + + if $::os_package_type != 'debian'{ + warning('This class is only valid for Debian, as other operating systems are not using uwsgi by default.') + } + + manila_api_uwsgi_config { + 'uwsgi/processes': value => $processes; + 'uwsgi/threads': value => $threads; + 'uwsgi/listen': value => $listen_queue_size; + } +} diff --git a/releasenotes/notes/uwsgi-7ada89bee7842ad4.yaml b/releasenotes/notes/uwsgi-7ada89bee7842ad4.yaml new file mode 100644 index 00000000..ecabad7f --- /dev/null +++ b/releasenotes/notes/uwsgi-7ada89bee7842ad4.yaml @@ -0,0 +1,7 @@ +--- +features: + - | + A new class manila::wsgi::uwsgi exist to allow configuring uwsgi in + operating systems that support this (ie: currently Debian). This helps + configuring the number of processes, threads and listen socket. + Also, a new manila_api_uwsgi_config provider now exist. diff --git a/spec/classes/manila_wsgi_uwsgi_spec.rb b/spec/classes/manila_wsgi_uwsgi_spec.rb new file mode 100644 index 00000000..925b3a39 --- /dev/null +++ b/spec/classes/manila_wsgi_uwsgi_spec.rb @@ -0,0 +1,31 @@ +require 'spec_helper' + +describe 'manila::wsgi::uwsgi' do + + shared_examples 'manila::wsgi::uwsgi' do + context 'with default parameters' do + it { + should contain_class('manila::deps') + } + + it { + is_expected.to contain_manila_api_uwsgi_config('uwsgi/processes').with_value(facts[:os_workers]) + is_expected.to contain_manila_api_uwsgi_config('uwsgi/threads').with_value('32') + is_expected.to contain_manila_api_uwsgi_config('uwsgi/listen').with_value('100') + } + end + end + + on_supported_os({ + :supported_os => OSDefaults.get_supported_os + }).each do |os,facts| + context "on #{os}" do + let (:facts) do + facts.merge!(OSDefaults.get_facts({ + :os_workers => 8, + })) + end + it_behaves_like 'manila::wsgi::uwsgi' + end + end +end diff --git a/spec/unit/provider/manila_api_uwsgi_config/ini_setting_spec.rb b/spec/unit/provider/manila_api_uwsgi_config/ini_setting_spec.rb new file mode 100644 index 00000000..e551dd08 --- /dev/null +++ b/spec/unit/provider/manila_api_uwsgi_config/ini_setting_spec.rb @@ -0,0 +1,57 @@ +# +# these tests are a little concerning b/c they are hacking around the +# modulepath, so these tests will not catch issues that may eventually arise +# related to loading these plugins. +# I could not, for the life of me, figure out how to programatcally set the modulepath +$LOAD_PATH.push( + File.join( + File.dirname(__FILE__), + '..', + '..', + '..', + 'fixtures', + 'modules', + 'inifile', + 'lib') +) +require 'spec_helper' +provider_class = Puppet::Type.type(:manila_api_uwsgi_config).provider(:ini_setting) +describe provider_class do + + it 'should default to the default setting when no other one is specified' do + resource = Puppet::Type::Manila_api_uwsgi_config.new( + {:name => 'DEFAULT/foo', :value => 'bar'} + ) + provider = provider_class.new(resource) + expect(provider.section).to eq('DEFAULT') + expect(provider.setting).to eq('foo') + end + + it 'should allow setting to be set explicitly' do + resource = Puppet::Type::Manila_api_uwsgi_config.new( + {:name => 'dude/foo', :value => 'bar'} + ) + provider = provider_class.new(resource) + expect(provider.section).to eq('dude') + expect(provider.setting).to eq('foo') + end + + it 'should ensure absent when is specified as a value' do + resource = Puppet::Type::Manila_api_uwsgi_config.new( + {:name => 'dude/foo', :value => ''} + ) + provider = provider_class.new(resource) + provider.exists? + expect(resource[:ensure]).to eq :absent + end + + it 'should ensure absent when value matches ensure_absent_val' do + resource = Puppet::Type::Manila_api_uwsgi_config.new( + {:name => 'dude/foo', :value => 'foo', :ensure_absent_val => 'foo' } + ) + provider = provider_class.new(resource) + provider.exists? + expect(resource[:ensure]).to eq :absent + end + +end diff --git a/spec/unit/type/manila_api_uwsgi_config_spec.rb b/spec/unit/type/manila_api_uwsgi_config_spec.rb new file mode 100644 index 00000000..06f884ee --- /dev/null +++ b/spec/unit/type/manila_api_uwsgi_config_spec.rb @@ -0,0 +1,64 @@ +require 'puppet' +require 'puppet/type/manila_api_uwsgi_config' + +describe 'Puppet::Type.type(:manila_api_uwsgi_config)' do + before :each do + @manila_api_uwsgi_config = Puppet::Type.type(:manila_api_uwsgi_config).new(:name => 'DEFAULT/foo', :value => 'bar') + end + + it 'should require a name' do + expect { + Puppet::Type.type(:manila_api_uwsgi_config).new({}) + }.to raise_error(Puppet::Error, 'Title or name must be provided') + end + + it 'should not expect a name with whitespace' do + expect { + Puppet::Type.type(:manila_api_uwsgi_config).new(:name => 'f oo') + }.to raise_error(Puppet::Error, /Parameter name failed/) + end + + it 'should fail when there is no section' do + expect { + Puppet::Type.type(:manila_api_uwsgi_config).new(:name => 'foo') + }.to raise_error(Puppet::Error, /Parameter name failed/) + end + + it 'should not require a value when ensure is absent' do + Puppet::Type.type(:manila_api_uwsgi_config).new(:name => 'DEFAULT/foo', :ensure => :absent) + end + + it 'should accept a valid value' do + @manila_api_uwsgi_config[:value] = 'bar' + expect(@manila_api_uwsgi_config[:value]).to eq('bar') + end + + it 'should not accept a value with whitespace' do + @manila_api_uwsgi_config[:value] = 'b ar' + expect(@manila_api_uwsgi_config[:value]).to eq('b ar') + end + + it 'should accept valid ensure values' do + @manila_api_uwsgi_config[:ensure] = :present + expect(@manila_api_uwsgi_config[:ensure]).to eq(:present) + @manila_api_uwsgi_config[:ensure] = :absent + expect(@manila_api_uwsgi_config[:ensure]).to eq(:absent) + end + + it 'should not accept invalid ensure values' do + expect { + @manila_api_uwsgi_config[:ensure] = :latest + }.to raise_error(Puppet::Error, /Invalid value/) + end + + it 'should autorequire the package that install the file' do + catalog = Puppet::Resource::Catalog.new + anchor = Puppet::Type.type(:anchor).new(:name => 'manila::install::end') + catalog.add_resource anchor, @manila_api_uwsgi_config + dependency = @manila_api_uwsgi_config.autorequire + expect(dependency.size).to eq(1) + expect(dependency[0].target).to eq(@manila_api_uwsgi_config) + expect(dependency[0].source).to eq(anchor) + end + +end