c9e0dfd3f5
Watcher sample configuration file groups parameters from various projects and the watcher project ones. This makes it tricky to review updates on configuration parameters. It is inconvenient for developer if the add/remove/change some configuration options cause they need to take care about the config.sample file. The sample configuration file should be available into HTML doc. This patchset: . removes the file /etc/watcher/watcher.conf.sample . adds an admin script tool to be able to built it, by using tox . includes a new section 'Watcher sample configuration files' into the doc source files . uses sphinx extension oslo_config.sphinxgenconfig Change-Id: If2180de3614663f9cbc5396961a8d2175e28e315 Closes-Bug: #1541734
119 lines
2.7 KiB
ReStructuredText
119 lines
2.7 KiB
ReStructuredText
..
|
|
Except where otherwise noted, this document is licensed under Creative
|
|
Commons Attribution 3.0 License. You can view the license at:
|
|
|
|
https://creativecommons.org/licenses/by/3.0/
|
|
|
|
================================
|
|
Welcome to Watcher documentation
|
|
================================
|
|
|
|
OpenStack Watcher provides a flexible and scalable resource optimization
|
|
service for multi-tenant OpenStack-based clouds.
|
|
Watcher provides a complete optimization loop—including everything from a
|
|
metrics receiver, complex event processor and profiler, optimization processor
|
|
and an action plan applier. This provides a robust framework to realize a wide
|
|
range of cloud optimization goals, including the reduction of data center
|
|
operating costs, increased system performance via intelligent virtual machine
|
|
migration, increased energy efficiency—and more!
|
|
|
|
Watcher project consists of several source code repositories:
|
|
|
|
* `watcher`_ - is the main repository. It contains code for Watcher API server,
|
|
Watcher Decision Engine and Watcher Applier.
|
|
* `python-watcherclient`_ - Client library and CLI client for Watcher.
|
|
* `watcher-dashboard`_ - Watcher Horizon plugin.
|
|
|
|
The documentation provided here is continually kept up-to-date based
|
|
on the latest code, and may not represent the state of the project at any
|
|
specific prior release.
|
|
|
|
.. _watcher: https://git.openstack.org/cgit/openstack/watcher/
|
|
.. _python-watcherclient: https://git.openstack.org/cgit/openstack/python-watcherclient/
|
|
.. _watcher-dashboard: https://git.openstack.org/cgit/openstack/watcher-dashboard/
|
|
|
|
Developer Guide
|
|
===============
|
|
|
|
Introduction
|
|
------------
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
glossary
|
|
architecture
|
|
dev/contributing
|
|
|
|
|
|
Getting Started
|
|
---------------
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
dev/environment
|
|
dev/devstack
|
|
deploy/configuration
|
|
deploy/conf-files
|
|
dev/testing
|
|
|
|
API References
|
|
--------------
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
webapi/v1
|
|
|
|
Plugins
|
|
-------
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
dev/plugin/base-setup
|
|
dev/plugin/strategy-plugin
|
|
dev/plugin/action-plugin
|
|
dev/plugin/planner-plugin
|
|
dev/plugins
|
|
|
|
|
|
Admin Guide
|
|
===========
|
|
|
|
Introduction
|
|
------------
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
deploy/installation
|
|
deploy/user-guide
|
|
|
|
Watcher Manual Pages
|
|
====================
|
|
|
|
.. toctree::
|
|
:glob:
|
|
:maxdepth: 1
|
|
|
|
man/*
|
|
|
|
.. # NOTE(mriedem): This is the section where we hide things that we don't
|
|
# actually want in the table of contents but sphinx build would fail if
|
|
# they aren't in the toctree somewhere. For example, we hide api/autoindex
|
|
# since that's already covered with modindex below.
|
|
.. toctree::
|
|
:hidden:
|
|
|
|
api/autoindex
|
|
|
|
|
|
Indices and tables
|
|
==================
|
|
|
|
* :ref:`genindex`
|
|
* :ref:`modindex`
|
|
* :ref:`search`
|