Files
governance/goals/completed/rocky/enable-mutable-configuration.rst
Ghanshyam Mann ac29ea216f Move completed goals into the completed directory
As per the new structure of community-wide goal[1],
we will keep all the completed goals into separate
directory 'goals/completed/' which will help to
track the goals and a clear view on what all goals
still need more work.

Keeping 'Migrate from oslo.rootwrap to oslo.privsep'
goal in the selected directory only as this still need to
finish the work. Rest all previous cycle goals are moved
to 'goals/completed/' directory

[1] https://governance.openstack.org/tc/goals/#completing-goals

Change-Id: I6c0d979038f65abb091db646ddb4c0d09c43735a
2021-11-29 16:12:54 +00:00

65 lines
2.1 KiB
ReStructuredText

.. -*- mode: rst -*-
============================
Enable mutable configuration
============================
There is a strong desire from operators to be able to change configuration
options without a service restart. For example, to selectively enable DEBUG
logging in response to observed issues. As of OpenStack Newton, config
options can be marked as 'mutable'. This means they can be reloaded (usually
via SIGHUP) at runtime, without a service restart. However, each project has
to be enabled before this will work and some care needs to be taken over how
each option is used before it can safely be marked mutable. For more details
please refer to `Enabling your project for mutable config`_
Champion
========
Goals need a main driver to project-manage them to completion. Project teams
need assistance, reminders and sometimes direct help in order for them to
complete the goals.
ChangBo Guo (gcb) has volunteered to drive this goal.
Gerrit Topic
============
To facilitate tracking, commits related to this goal should use the
gerrit topic::
mutable-config
Storyboard
==========
Progress on this goal is tracked via
https://storyboard.openstack.org/#!/story/2001545
Completion Criteria
===================
Each project service could be turned on/off debug logging without restart
#. Support reloading configuration options at runtime, without a service
restart
#. Toggle the debug option for each service at runtime
References
==========
* `Original Discussion`_
* `Enabling your project for mutable config`_
* `Example of enabling projects`_
.. _Original Discussion: https://etherpad.openstack.org/p/mitaka-cross-project-dynamic-config-services
.. _Enabling your project for mutable config: https://docs.openstack.org/oslo.config/latest/reference/mutable.html
.. _Example of enabling projects: https://review.opendev.org/#/q/topic:bp/mutable-config+(status:open+OR+status:merged)
Current State / Anticipated Impact
==================================
oslo.config and oslo.service have implemented basic functions and we have
enabled Nova to support mutable configuration and mark some configuration
option like CONF.libvirt.live_migration_progress_timeout as 'mutable'.