Configuration documentation migrated

Documentation layout aligned with the OS standards.

The admin page cleaned up - unrelated references moved
elsewhere linking merely admin pages.

The configuration page refactored, ironic.conf
and policy.conf documentation and samples
automatically generated by oslo_config.sphinxext.

Change-Id: I9075e2688f59ecd8ab5c489679f2c53d6294f28d
This commit is contained in:
Ilya Etingof 2017-08-08 19:02:36 +02:00
parent 60aec73848
commit af8f46b7f4
10 changed files with 96 additions and 67 deletions

View File

@ -1,48 +1,31 @@
Administrator's Guide
=====================
Installation & Operations
-------------------------
If you are a system administrator running Ironic, this section contains
information that should help you understand how to deploy, operate, and upgrade
information that may help you understand how to operate and upgrade
the services.
.. toctree::
:maxdepth: 1
Installation Guide </install/index>
gmr
Upgrade Guide <upgrade-guide>
upgrade-to-hardware-types
Release Notes <http://docs.openstack.org/releasenotes/ironic/>
Troubleshooting FAQ <troubleshooting>
Configuration
-------------
There are many aspects of the Bare Metal service which are environment
specific. The following pages will be helpful in configuring specific aspects
of ironic that may or may not be suitable to every situation.
.. toctree::
:maxdepth: 1
Guide to Node Cleaning <cleaning>
Configuring Node Inspection <inspection>
Configuring RAID during deployment <raid>
Configuring to boot from volume <boot-from-volume>
Security considerations for your Bare Metal installation <security>
Adopting Nodes in an ACTIVE state <adoption>
Configuring for Multi-tenant Networking <multitenancy>
Configuring for port groups <portgroups>
Configuring node web or serial console <console>
Emitting software metrics <metrics>
Auditing API Traffic <api-audit-support>
Notifications <notifications>
Ceph Object Gateway support <radosgw>
/configuration/sample-config
/configuration/sample-policy
Enabling Drivers <drivers>
Ironic Python Agent <drivers/ipa>
Node Hardware Inspection <inspection>
Node Cleaning <cleaning>
Node Adoption <adoption>
RAID Configuration <raid>
Configuring to boot from volume <boot-from-volume>
Multi-tenant Networking <multitenancy>
Port Groups <portgroups>
Configuring Web or Serial Console <console>
Enabling Notifications <notifications>
Ceph Object Gateway <radosgw>
Emitting Software Metrics <metrics>
Auditing API Traffic <api-audit-support>
Service State Reporting <gmr>
Upgrade Guide <upgrade-guide>
Security <security>
Troubleshooting FAQ <troubleshooting>
Dashboard Integration
---------------------

View File

@ -321,6 +321,11 @@ Upgrading from Ocata to Pike
Other upgrade instructions are in the `Pike release notes
<https://docs.openstack.org/releasenotes/ironic/pike.html>`_.
.. toctree::
:maxdepth: 1
upgrade-to-hardware-types.rst
Upgrading from Newton to Ocata
==============================

View File

@ -21,7 +21,9 @@ extensions = ['sphinx.ext.autodoc',
'sphinxcontrib.pecanwsme.rest',
'sphinxcontrib.seqdiag',
'wsmeext.sphinxext',
'oslo_config.sphinxext',
'oslo_config.sphinxconfiggen',
'oslo_policy.sphinxext',
'oslo_policy.sphinxpolicygen',
]

View File

@ -0,0 +1,10 @@
=====================
Configuration Options
=====================
The following is an overview of all available configuration options in
Ironic. For a sample configuration file, refer to
:doc:`sample-config`.
.. show-options::
:config-file: tools/config/ironic-config-generator.conf

View File

@ -1,10 +1,16 @@
Configuration Guide
-------------------
=======================
Configuration Reference
=======================
Here are sample configuration files generated automatically for Ironic.
Many aspects of the Bare Metal service are specific to the environment
it is deployed in. The following pages describe configuration
options that can be used to adjust the service to your particular
situation.
.. toctree::
:maxdepth: 1
sample-config
sample-policy
Configuration Options <config>
Sample Config File <sample-config>
Policies <policy>
Sample Policy File <sample-policy>

View File

@ -0,0 +1,9 @@
========
Policies
========
The following is an overview of all available policies in Ironic. For
a sample configuration file, refer to :doc:`sample-policy`.
.. show-policy::
:config-file: tools/policy/ironic-policy-generator.conf

View File

@ -1,13 +1,18 @@
============================
Ironic Configuration Options
============================
=========================
Sample Configuration File
=========================
The following is a sample Ironic configuration for adaptation and use. It is
auto-generated from Ironic when this documentation is built, so
if you find issues with an option, please compare your version of
Ironic with the version of this documentation.
The following is a sample Ironic configuration for adaptation and use. For a
detailed overview of all available configuration options, refer to
:doc:`config`.
The sample configuration can also be downloaded as a :download:`file
The sample configuration can also be viewed in :download:`file form
</_static/ironic.conf.sample>`.
.. important::
The sample configuration file is auto-generated from Ironic when this
documentation is built. You must ensure your version of Ironic matches the
version of this documentation.
.. literalinclude:: /_static/ironic.conf.sample

View File

@ -22,6 +22,22 @@ previous release of ironic, append the OpenStack release name to the URL; for
example, the ``ocata`` release is available at
http://docs.openstack.org/ironic/ocata/.
Installation Guide
==================
.. toctree::
:maxdepth: 2
install/index
Upgrade Guide
=============
.. toctree::
:maxdepth: 2
admin/upgrade-guide
User Guide
==========
@ -38,26 +54,14 @@ Administrator Guide
admin/index
Configuration Reference
=======================
Configuration Guide
===================
.. toctree::
:maxdepth: 2
configuration/index
Driver References
=================
Every driver author is expected to document the use and configuration of their
driver. These pages are linked below.
.. toctree::
:maxdepth: 1
Driver Documentation pages <admin/drivers>
Further Considerations for the Agent Drivers <admin/drivers/ipa>
Bare Metal API References
=========================
@ -90,6 +94,11 @@ Contributor Guide
contributor/index
Release Notes
=============
`Release Notes <http://docs.openstack.org/releasenotes/ironic/>`_
Indices and tables
==================

View File

@ -1,5 +1,5 @@
=====================================
Bare Metal service installation guide
Bare Metal Service Installation Guide
=====================================
The Bare Metal service is a collection of components that provides support to

View File

@ -1,8 +1,8 @@
.. _user-guide:
======================
Introduction to Ironic
======================
=============================
Bare Metal Service User Guide
=============================
Ironic is an OpenStack project which provisions bare metal (as opposed to
virtual) machines. It may be used independently or as part of an OpenStack