Automatically generate neutron core configuration files

This adds a new tox environment, genconfig, which generates sample
neutron core configuration file using oslo-config-generator.

Updates to some configuration option help messages to reflect useful
details that were missing in the code but were present in config files.

It also adds details to devref on how to update config files.

Partially-Implements: blueprint autogen-neutron-conf-file

DocImpact

Change-Id: I1c6dc4e7d479f1b7c755597caded24a0f018c712
Closes-bug: #1199963
Co-Authored-By: Louis Taylor <louis@kragniz.eu>

10 files changed, 74 insertions, 0 deletions

diff --git a/etc/oslo-config-generator/dhcp_agent.ini b/etc/oslo-config-generator/dhcp_agent.ini
new file mode 100644
index 0000000000..13a0de1823
--- /dev/null
+++ b/etc/oslo-config-generator/dhcp_agent.ini
@@ -0,0 +1,7 @@
+[DEFAULT]
+output_file = etc/dhcp_agent.ini.sample
+wrap_width = 79
+
+namespace = neutron.base.agent
+namespace = neutron.dhcp.agent
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/l3_agent.ini b/etc/oslo-config-generator/l3_agent.ini
new file mode 100644
index 0000000000..82bf2ca683
--- /dev/null
+++ b/etc/oslo-config-generator/l3_agent.ini
@@ -0,0 +1,7 @@
+[DEFAULT]
+output_file = etc/l3_agent.ini.sample
+wrap_width = 79
+
+namespace = neutron.base.agent
+namespace = neutron.l3.agent
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/linuxbridge_agent.ini b/etc/oslo-config-generator/linuxbridge_agent.ini
new file mode 100644
index 0000000000..060346b682
--- /dev/null
+++ b/etc/oslo-config-generator/linuxbridge_agent.ini
@@ -0,0 +1,6 @@
+[DEFAULT]
+output_file = etc/neutron/plugins/ml2/linuxbridge_agent.ini.sample
+wrap_width = 79
+
+namespace = neutron.ml2.linuxbridge.agent
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/metadata_agent.ini b/etc/oslo-config-generator/metadata_agent.ini
new file mode 100644
index 0000000000..5c27309a6c
--- /dev/null
+++ b/etc/oslo-config-generator/metadata_agent.ini
@@ -0,0 +1,6 @@
+[DEFAULT]
+output_file = etc/metadata_agent.ini.sample
+wrap_width = 79
+
+namespace = neutron.metadata.agent
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/metering_agent.ini b/etc/oslo-config-generator/metering_agent.ini
new file mode 100644
index 0000000000..9c00d30efe
--- /dev/null
+++ b/etc/oslo-config-generator/metering_agent.ini
@@ -0,0 +1,6 @@
+[DEFAULT]
+output_file = etc/metering_agent.ini.sample
+wrap_width = 79
+
+namespace = neutron.metering.agent
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/ml2_conf.ini b/etc/oslo-config-generator/ml2_conf.ini
new file mode 100644
index 0000000000..ab97bd486b
--- /dev/null
+++ b/etc/oslo-config-generator/ml2_conf.ini
@@ -0,0 +1,6 @@
+[DEFAULT]
+output_file = etc/neutron/plugins/ml2/ml2_conf.ini.sample
+wrap_width = 79
+
+namespace = neutron.ml2
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/ml2_conf_sriov.ini b/etc/oslo-config-generator/ml2_conf_sriov.ini
new file mode 100644
index 0000000000..ed03c789e6
--- /dev/null
+++ b/etc/oslo-config-generator/ml2_conf_sriov.ini
@@ -0,0 +1,6 @@
+[DEFAULT]
+output_file = etc/neutron/plugins/ml2/ml2_conf_sriov.ini.sample
+wrap_width = 79
+
+namespace = neutron.ml2.sriov
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/neutron.conf b/etc/oslo-config-generator/neutron.conf
new file mode 100644
index 0000000000..f55a562ecc
--- /dev/null
+++ b/etc/oslo-config-generator/neutron.conf
@@ -0,0 +1,18 @@
+[DEFAULT]
+output_file = etc/neutron.conf.sample
+wrap_width = 79
+
+namespace = neutron
+namespace = neutron.agent
+namespace = neutron.db
+namespace = neutron.extensions
+namespace = neutron.qos
+namespace = nova.auth
+namespace = oslo.log
+namespace = oslo.db
+namespace = oslo.policy
+namespace = oslo.concurrency
+namespace = oslo.messaging
+namespace = oslo.service.sslutils
+namespace = oslo.service.wsgi
+namespace = keystonemiddleware.auth_token
diff --git a/etc/oslo-config-generator/openvswitch_agent.ini b/etc/oslo-config-generator/openvswitch_agent.ini
new file mode 100644
index 0000000000..3fab70d392
--- /dev/null
+++ b/etc/oslo-config-generator/openvswitch_agent.ini
@@ -0,0 +1,6 @@
+[DEFAULT]
+output_file = etc/neutron/plugins/ml2/openvswitch_agent.ini.sample
+wrap_width = 79
+
+namespace = neutron.ml2.ovs.agent
+namespace = oslo.log
diff --git a/etc/oslo-config-generator/sriov_agent.ini b/etc/oslo-config-generator/sriov_agent.ini
new file mode 100644
index 0000000000..29864f5781
--- /dev/null
+++ b/etc/oslo-config-generator/sriov_agent.ini
@@ -0,0 +1,6 @@
+[DEFAULT]
+output_file = etc/neutron/plugins/ml2/sriov_agent.ini.sample
+wrap_width = 79
+
+namespace = neutron.ml2.sriov.agent
+namespace = oslo.log