Deprecate idle_timeout option

The idle_timeout parameter is deprecated, use connection_recycle_time
instead[1].

[1]https://review.opendev.org/#/c/334182/

Change-Id: I5d0f2f982daa0cb2d154620bfe122818eb8b72b4
Depends-On: https://review.opendev.org/656106/
Closes-Bug: #1826692
This commit is contained in:
ZhongShengping 2019-04-28 15:00:12 +08:00
parent 3a077381b0
commit 0e690501b3
3 changed files with 64 additions and 47 deletions

View File

@ -8,7 +8,7 @@
# Url used to connect to database. # Url used to connect to database.
# (Optional) Defaults to "sqlite:////var/lib/rally/rally.sqlite". # (Optional) Defaults to "sqlite:////var/lib/rally/rally.sqlite".
# #
# [*database_idle_timeout*] # [*database_connection_recycle_time*]
# Timeout when db connections should be reaped. # Timeout when db connections should be reaped.
# (Optional) Defaults to $::os_service_default # (Optional) Defaults to $::os_service_default
# #
@ -42,22 +42,35 @@
# before error is raised. Set to -1 to specify an infinite retry count. # before error is raised. Set to -1 to specify an infinite retry count.
# Defaults to $::os_service_default # Defaults to $::os_service_default
# #
# DEPRECATED PARAMETERS
#
# [*database_idle_timeout*]
# Timeout when db connections should be reaped.
# Defaults to undef.
#
class rally::db ( class rally::db (
$database_connection = 'sqlite:////var/lib/rally/rally.sqlite', $database_connection = 'sqlite:////var/lib/rally/rally.sqlite',
$database_idle_timeout = $::os_service_default, $database_connection_recycle_time = $::os_service_default,
$database_min_pool_size = $::os_service_default, $database_min_pool_size = $::os_service_default,
$database_max_pool_size = $::os_service_default, $database_max_pool_size = $::os_service_default,
$database_max_retries = $::os_service_default, $database_max_retries = $::os_service_default,
$database_retry_interval = $::os_service_default, $database_retry_interval = $::os_service_default,
$database_max_overflow = $::os_service_default, $database_max_overflow = $::os_service_default,
$database_pool_timeout = $::os_service_default, $database_pool_timeout = $::os_service_default,
$database_db_max_retries = $::os_service_default, $database_db_max_retries = $::os_service_default,
# DEPRECATED PARAMETERS
$database_idle_timeout = undef,
) { ) {
include ::rally::deps include ::rally::deps
if $database_idle_timeout {
warning('The database_idle_timeout parameter is deprecated. Please use \
database_connection_recycle_time instead.')
}
$database_connection_real = pick($::rally::database_connection, $database_connection) $database_connection_real = pick($::rally::database_connection, $database_connection)
$database_idle_timeout_real = pick($::rally::database_idle_timeout, $database_idle_timeout) $database_connection_recycle_time_real = pick($::rally::database_idle_timeout, $database_idle_timeout, $database_connection_recycle_time)
$database_min_pool_size_real = pick($::rally::database_min_pool_size, $database_min_pool_size) $database_min_pool_size_real = pick($::rally::database_min_pool_size, $database_min_pool_size)
$database_max_pool_size_real = pick($::rally::database_max_pool_size, $database_max_pool_size) $database_max_pool_size_real = pick($::rally::database_max_pool_size, $database_max_pool_size)
$database_max_retries_real = pick($::rally::database_max_retries, $database_max_retries) $database_max_retries_real = pick($::rally::database_max_retries, $database_max_retries)
@ -79,15 +92,15 @@ class rally::db (
} }
oslo::db { 'rally_config': oslo::db { 'rally_config':
connection => $database_connection_real, connection => $database_connection_real,
idle_timeout => $database_idle_timeout_real, connection_recycle_time => $database_connection_recycle_time_real,
min_pool_size => $database_min_pool_size_real, min_pool_size => $database_min_pool_size_real,
max_pool_size => $database_max_pool_size_real, max_pool_size => $database_max_pool_size_real,
max_retries => $database_max_retries_real, max_retries => $database_max_retries_real,
retry_interval => $database_retry_interval_real, retry_interval => $database_retry_interval_real,
max_overflow => $database_max_overflow_real, max_overflow => $database_max_overflow_real,
pool_timeout => $database_pool_timeout, pool_timeout => $database_pool_timeout,
db_max_retries => $database_db_max_retries, db_max_retries => $database_db_max_retries,
} }
} }

View File

@ -0,0 +1,4 @@
---
deprecations:
- database_idle_timeout is deprecated and will be removed in a future
release. Please use database_connection_recycle_time instead.

View File

@ -6,15 +6,15 @@ describe 'rally::db' do
it { should contain_class('rally::deps') } it { should contain_class('rally::deps') }
it { should contain_oslo__db('rally_config').with( it { should contain_oslo__db('rally_config').with(
:db_max_retries => '<SERVICE DEFAULT>', :db_max_retries => '<SERVICE DEFAULT>',
:connection => 'sqlite:////var/lib/rally/rally.sqlite', :connection => 'sqlite:////var/lib/rally/rally.sqlite',
:idle_timeout => '<SERVICE DEFAULT>', :connection_recycle_time => '<SERVICE DEFAULT>',
:min_pool_size => '<SERVICE DEFAULT>', :min_pool_size => '<SERVICE DEFAULT>',
:max_pool_size => '<SERVICE DEFAULT>', :max_pool_size => '<SERVICE DEFAULT>',
:max_retries => '<SERVICE DEFAULT>', :max_retries => '<SERVICE DEFAULT>',
:retry_interval => '<SERVICE DEFAULT>', :retry_interval => '<SERVICE DEFAULT>',
:max_overflow => '<SERVICE DEFAULT>', :max_overflow => '<SERVICE DEFAULT>',
:pool_timeout => '<SERVICE DEFAULT>', :pool_timeout => '<SERVICE DEFAULT>',
)} )}
it { should contain_file('/var/lib/rally').with( it { should contain_file('/var/lib/rally').with(
@ -29,30 +29,30 @@ describe 'rally::db' do
context 'with specific parameters' do context 'with specific parameters' do
let :params do let :params do
{ {
:database_connection => 'mysql://rally:rally@localhost/rally', :database_connection => 'mysql://rally:rally@localhost/rally',
:database_idle_timeout => '3601', :database_connection_recycle_time => '3601',
:database_min_pool_size => '2', :database_min_pool_size => '2',
:database_max_retries => '11', :database_max_retries => '11',
:database_retry_interval => '11', :database_retry_interval => '11',
:database_max_pool_size => '11', :database_max_pool_size => '11',
:database_max_overflow => '21', :database_max_overflow => '21',
:database_pool_timeout => '21', :database_pool_timeout => '21',
:database_db_max_retries => '-1', :database_db_max_retries => '-1',
} }
end end
it { should contain_class('rally::deps') } it { should contain_class('rally::deps') }
it { should contain_oslo__db('rally_config').with( it { should contain_oslo__db('rally_config').with(
:db_max_retries => '-1', :db_max_retries => '-1',
:connection => 'mysql://rally:rally@localhost/rally', :connection => 'mysql://rally:rally@localhost/rally',
:idle_timeout => '3601', :connection_recycle_time => '3601',
:min_pool_size => '2', :min_pool_size => '2',
:max_pool_size => '11', :max_pool_size => '11',
:max_retries => '11', :max_retries => '11',
:retry_interval => '11', :retry_interval => '11',
:max_overflow => '21', :max_overflow => '21',
:pool_timeout => '21', :pool_timeout => '21',
)} )}
it { should_not contain_file('create_sqlite_directory') } it { should_not contain_file('create_sqlite_directory') }