Add config sample to compute-hyperv docs
This change adds an automatically generated config sample to the compute-hyperv docs. The config sample is generated each time the docs are built, using the oslo.config sphinxconfiggen extension. Change-Id: Id8fa0311d653a438b143018f032e32d3eb6bbaa8 Related-Bug: #1731511
This commit is contained in:
parent
7575b76d5b
commit
fbb330caa2
|
@ -42,6 +42,8 @@ output/*/index.html
|
||||||
|
|
||||||
# Sphinx
|
# Sphinx
|
||||||
doc/build
|
doc/build
|
||||||
|
doc/source/_static/compute-hyperv.conf.sample
|
||||||
|
etc/compute-hyperv.conf.sample
|
||||||
|
|
||||||
# pbr generates these
|
# pbr generates these
|
||||||
AUTHORS
|
AUTHORS
|
||||||
|
|
|
@ -22,6 +22,7 @@ sys.path.insert(0, os.path.abspath('../..'))
|
||||||
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
|
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
|
||||||
extensions = [
|
extensions = [
|
||||||
'sphinx.ext.autodoc',
|
'sphinx.ext.autodoc',
|
||||||
|
'oslo_config.sphinxconfiggen',
|
||||||
#'sphinx.ext.intersphinx',
|
#'sphinx.ext.intersphinx',
|
||||||
'oslosphinx'
|
'oslosphinx'
|
||||||
]
|
]
|
||||||
|
@ -33,6 +34,9 @@ extensions = [
|
||||||
# The suffix of source filenames.
|
# The suffix of source filenames.
|
||||||
source_suffix = '.rst'
|
source_suffix = '.rst'
|
||||||
|
|
||||||
|
config_generator_config_file = '../../etc/compute-hyperv-config-generator.conf'
|
||||||
|
sample_config_basename = '_static/compute-hyperv'
|
||||||
|
|
||||||
# The master toctree document.
|
# The master toctree document.
|
||||||
master_doc = 'index'
|
master_doc = 'index'
|
||||||
|
|
||||||
|
@ -56,7 +60,7 @@ pygments_style = 'sphinx'
|
||||||
# Sphinx are currently 'default' and 'sphinxdoc'.
|
# Sphinx are currently 'default' and 'sphinxdoc'.
|
||||||
# html_theme_path = ["."]
|
# html_theme_path = ["."]
|
||||||
# html_theme = '_theme'
|
# html_theme = '_theme'
|
||||||
# html_static_path = ['static']
|
html_static_path = ['_static']
|
||||||
|
|
||||||
# Output file base name for HTML help builder.
|
# Output file base name for HTML help builder.
|
||||||
htmlhelp_basename = '%sdoc' % project
|
htmlhelp_basename = '%sdoc' % project
|
||||||
|
|
|
@ -16,10 +16,10 @@ Contents:
|
||||||
usage
|
usage
|
||||||
contributing
|
contributing
|
||||||
|
|
||||||
Indices and tables
|
Sample Configuration File
|
||||||
==================
|
-------------------------
|
||||||
|
|
||||||
* :ref:`genindex`
|
.. toctree::
|
||||||
* :ref:`modindex`
|
:maxdepth: 1
|
||||||
* :ref:`search`
|
|
||||||
|
|
||||||
|
sample_config
|
||||||
|
|
|
@ -0,0 +1,20 @@
|
||||||
|
====================================
|
||||||
|
Compute-hyperv Configuration Options
|
||||||
|
====================================
|
||||||
|
|
||||||
|
The following is a sample compute-hyperv configuration for adaptation and
|
||||||
|
use.
|
||||||
|
|
||||||
|
The sample configuration can also be viewed in :download:`file from
|
||||||
|
</_static/compute-hyperv.conf.sample>`.
|
||||||
|
|
||||||
|
Config options that are specific to the Hyper-V Nova driver can be found in
|
||||||
|
the '[hyperv]' config group section.
|
||||||
|
|
||||||
|
.. important::
|
||||||
|
|
||||||
|
The sample configuration file is auto-generated from compute-hyperv when
|
||||||
|
this documentation is built. You must ensure your version of
|
||||||
|
compute-hyperv matches the version of this documentation.
|
||||||
|
|
||||||
|
.. literalinclude:: /_static/compute-hyperv.conf.sample
|
|
@ -0,0 +1,10 @@
|
||||||
|
[DEFAULT]
|
||||||
|
output_file = etc/compute-hyperv.conf.sample
|
||||||
|
wrap_width = 80
|
||||||
|
|
||||||
|
namespace = compute_hyperv
|
||||||
|
namespace = os_win
|
||||||
|
namespace = nova.conf
|
||||||
|
namespace = oslo.log
|
||||||
|
namespace = oslo.messaging
|
||||||
|
namespace = oslo.concurrency
|
|
@ -8,6 +8,7 @@ coverage!=4.4,>=4.0 # Apache-2.0
|
||||||
ddt>=1.0.1 # MIT
|
ddt>=1.0.1 # MIT
|
||||||
python-subunit>=0.0.18 # Apache-2.0/BSD
|
python-subunit>=0.0.18 # Apache-2.0/BSD
|
||||||
sphinx>=1.6.2 # BSD
|
sphinx>=1.6.2 # BSD
|
||||||
|
oslo.config>=4.6.0 # Apache-2.0
|
||||||
oslosphinx>=4.7.0 # Apache-2.0
|
oslosphinx>=4.7.0 # Apache-2.0
|
||||||
oslotest>=1.10.0 # Apache-2.0
|
oslotest>=1.10.0 # Apache-2.0
|
||||||
testrepository>=0.0.18 # Apache-2.0/BSD
|
testrepository>=0.0.18 # Apache-2.0/BSD
|
||||||
|
|
Loading…
Reference in New Issue