2025.1 Series Release Notes

2025.1-eom

Upgrade Notes

• The oslo_service.wsgi module has been undeprecated. It contains many utilities besides the eventlet-based Server class. Instead, only the Server class itself is now deprecated.

4.1.0

New Features

• A new backend system has been introduced to modularize and improve the flexibility of the service implementation. This system allows developers to choose or implement alternative backends.

  By default, the eventlet backend is used, preserving the previous behavior. The backend is dynamically loaded through the new backend mechanism.

Deprecation Notes

• The following modules are now deprecated and will be removed in a future release:

  • oslo_service.wsgi: Users are advised to migrate to uwsgi for serving WSGI applications.

  • oslo_service.eventlet_backdoor: This module has been deprecated and will be removed in version 2026.2. It is no longer maintained.

  • oslo_service.fixtures: This module has been deprecated and will be removed in version 2026.2. It is no longer maintained.

  • oslo_service.sslutils: This module has been deprecated and will be removed in version 2026.2. It is no longer maintained.

  Users should remove any dependencies on these modules as soon as possible.

4.0.0

Upgrade Notes

• The following deprecated options have been removed. Use the [ssl] options instead.

  • [DEFAULT] ssl_ca_file

  • [DEFAULT] ssl_cert_file

  • [DEFAULT] ssl_key_file

3.6.0

Upgrade Notes

• Support for Python 3.8 has been removed. Now the minimum python version supported is 3.9 .

3.3.0

Bug Fixes

• Bug #1983949: Fixed eventlet native threads tpool on child process when parent process has used them before launching the service.

2.8.0

New Features

• A new config options, [DEFAULT] wsgi_server_debug, has been added. This allows admins to configure whether the server should send exception tracebacks to the clients on HTTP 500 errors. This defaults to False, preserving previous behavior.

2.7.0

Bug Fixes

• Fix the backdoor helper method fo() to also work when there are objects present in the current python instance that do not have a __class__ attribute.

2.0.0

Upgrade Notes

• Support for Python 2.7 has been dropped. The minimum version of Python now supported is Python 3.6.

1.40.2

Bug Fixes

• SIGHUP is now handled properly with restart_method='mutate', no longer restarting child processes. See bug 1794708 for details. In conjunction with the fix for bug 1715374 in oslo.privsep, the nova-compute service now behaves correctly when it receives SIGHUP.

1.40.0

New Features

• The config option backdoor_socket_path now is a format string that supports {pid}, which will be replaced with the PID of the current process. This makes the eventlet backdoor accessible when spawning multiple processes with the same backdoor_socket_path inside the configuration.

1.37.0

New Features

• Add support for profiling (capture function calltrace) service’s worker processes.

1.35.0

New Features

• The ThreadGroup class has new add_timer_args() and add_dynamic_timer_args() methods to create timers passing the positional and keyword arguments to the callback as a sequence and a mapping. This API provides more flexibility for the addition of timer control options in the future.

• The ThreadGroup add_timer_args() and add_dynamic_timer_args() methods now support passing a stop_on_exception=False argument to allow the timer to keep running even when an exception is raised by the callback function.

Deprecation Notes

• The ThreadGroup.cancel() method is deprecated and will be removed in a future major release.

• The API of the ThreadGroup add_timer() and add_dynamic_timer() methods has been identified as error-prone when passing arguments intended for the callback function. Passing callback arguments in this way is now deprecated. Callers should use the new add_timer_args() or add_dynamic_timer_args() methods (respectively) instead when it is necessary to pass arguments to the timer callback function.

1.19.0

New Features

• Add a new type of looping call: FixedIntervalWithTimeoutLoopingCall. It is a FixedIntervalLoopingCall with timeout checking.

1.17.0

Other Notes

• Switch to reno for managing release notes.