Add release note and documentation for config validator

Change-Id: Id23d7bbb38c6780621f09b2e24c0cc88831bdb1a
This commit is contained in:
Ben Nemec 2018-09-12 21:16:22 +00:00
parent e3cd230c06
commit 1f17b823e0
3 changed files with 73 additions and 0 deletions

View File

@ -6,4 +6,5 @@
:maxdepth: 2
generator
validator

View File

@ -0,0 +1,63 @@
=====================
oslo-config-validator
=====================
`oslo-config-validator` is a utility for verifying that the entries in a
config file are correct. It will report an error for any options found that
are not defined by the service, and a warning for any deprecated options found.
.. versionadded:: 6.5.0
Usage
-----
There are two primary ways to use the config validator. It can use the sample
config generator configuration file found in each service to determine the list
of available options, or it can consume a machine-readable sample config that
provides the same information.
Sample Config Generator Configuration
-------------------------------------
.. note:: When using this method, all dependencies of the service must be
installed in the environment where the validator is run.
There are two parameters that must be passed to the validator in this case:
``--config-file`` and ``--input-file``. ``--config-file`` should point at the
location of the sample config generator configuration file, while
``--input-file`` should point at the location of the configuration file to be
validated.
Here's an example of using the validator on Nova as installed by Devstack::
$ oslo-config-validator --config-file /opt/stack/nova/etc/nova/nova-config-generator.conf --input-file /etc/nova/nova.conf
ERROR:root:keystone_authtoken/user_domain_name not found
ERROR:root:keystone_authtoken/password not found
ERROR:root:keystone_authtoken/project_domain_name not found
ERROR:root:keystone_authtoken/project_name not found
ERROR:root:keystone_authtoken/username not found
ERROR:root:keystone_authtoken/auth_url not found
Machine-Readable Sample Config
------------------------------
.. note:: For most accurate results, the machine-readable sample config should
be generated from the same version of the code as is running on
the system whose config file is being validated.
In this case, a machine-readable sample config must first be generated, as
described in :doc:`generator`.
This file is then passed to the validator with ``--opt-data``, along with the
config file to validated in ``--input-file`` as above.
Here's an example of using the validator on Nova as installed by Devstack, with
a sample config file ``config-data.yaml`` created by the config generator::
$ oslo-config-validator --opt-data config-data.yaml --input-file /etc/nova/nova.conf
ERROR:root:keystone_authtoken/username not found
ERROR:root:keystone_authtoken/project_domain_name not found
ERROR:root:keystone_authtoken/user_domain_name not found
ERROR:root:keystone_authtoken/project_name not found
ERROR:root:keystone_authtoken/password not found
ERROR:root:keystone_authtoken/auth_url not found

View File

@ -0,0 +1,9 @@
---
features:
- |
A validator for config files is now available. When run against a config
file, it will report an error for any options present that aren't defined
in the service and will report a warning for any deprecated options in
the file. In order to discover the available options for a service, it
can either use the sample config generator configuration file or a
machine-readable sample config generated elsewhere.