trove/doc/source/index.rst
Amrith Kumar 20d51467c7 enable trove-api behind mod-wsgi
This change enables behind mod-wsgi as part of the community pike goal
goal-deploy-api-in-wsgi.

The change includes:

    - the wsgi script files to run trove api under apache
    - updates to the devstack plugin
    - a basic deploy doc which explains this change

Change-Id: Icdd39b47a1be426e87a5d09f9e9d567af1974a9c
Depends-On: I3d6f6649430ee40879de15fee0b215dc32e8b666
Closes-Bug: #1681478
2017-04-25 06:54:29 -04:00

87 lines
2.4 KiB
ReStructuredText

===========================================
Welcome to Trove's developer documentation!
===========================================
Introduction
============
Trove is Database as a Service for OpenStack. It's designed to run
entirely on OpenStack, with the goal of allowing users to quickly and
easily utilize the features of a relational database without the
burden of handling complex administrative tasks. Cloud users and
database administrators can provision and manage multiple database
instances as needed.
Initially, the service will focus on providing resource isolation at
high performance while automating complex administrative tasks
including deployment, configuration, patching, backups, restores, and
monitoring.
For an in-depth look at the project's design and structure, see the
:doc:`dev/design` page.
Installation And Deployment
===========================
Trove is constantly under development. The easiest way to install
Trove is using the Trove integration scripts that can be found in
git in the `Trove`_ Repository.
For further details on how to install Trove using the integration
scripts please refer to the :doc:`dev/install` page.
For further details on how to install Trove to work with existing
OpenStack environment please refer to the :doc:`dev/manual_install` page.
Developer Resources
===================
For those wishing to develop Trove itself, or to extend Trove's
functionality, the following resources are provided.
.. toctree::
:maxdepth: 1
dev/design
dev/testing
dev/install
dev/manual_install.rst
dev/building_guest_images.rst
dev/guest_cloud_init.rst
dev/notifier.rst
dev/trove_api_extensions.rst
dev/secure_oslo_messaging.rst
deploy/apache-mod-wsgi
* Source Code Repositories
- `Trove`_
- `Trove Client`_
* `Trove Wiki`_ on OpenStack
* `Trove API Documentation`_ on docs.openstack.org
Guest Images
============
In order to use Trove, you need to have Guest Images for each
datastore and version. These images are loaded into Glance and
registered with Trove.
For those wishing to develop guest images, please refer to the
:ref:`build_guest_images` page.
Search Trove Documentation
==========================
* :ref:`search`
.. _Trove Wiki: https://wiki.openstack.org/wiki/Trove
.. _Trove: https://git.openstack.org/cgit/openstack/trove
.. _Trove Client: https://git.openstack.org/cgit/openstack/python-troveclient
.. _Trove API Documentation: http://developer.openstack.org/api-ref-databases-v1.html