deb-murano/doc/source/index.rst
Ruslan Kamaldinov 3b1cec10be Added developer documentation
* Updated README file
* Updated contrib/devstack/README
* Added documentation for Devstack installation
* Added documentation for manual installation of the API and Engine services
* Added basic contributing guide
* Added extended contributing guide
* Added HACKING.rst to the root of the project
* Added development guidelines
* Sets simple Sphinx theme

Partially implements blueprint: murano-dev-doc-05

Change-Id: Ib7d7b416ccc61667ed96297555db2ef5dca9ae67
2014-04-21 16:32:28 +04:00

68 lines
2.1 KiB
ReStructuredText

..
Copyright 2014 Mirantis, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
==================
Welcome to Murano!
==================
Introduction
============
Murano Project introduces an application catalog, which allows application
developers and cloud administrators to publish various cloud-ready applications
in a browsable categorised catalog. It may be used by the cloud users
(including the unexperienced ones) to pick-up the needed applications and
services and composes the reliable environments out of them in a
"push-the-button" manner.
Key goal is to provide UI and API which allows to compose and deploy composite
environments on the Application abstraction level and then manage their
lifecycle.
Murano consists of three source code repositories:
* `murano-api`_ - is the main repository. It contains code for Murano API
server, Murano engine and MuranoPL
* `murano-agent`_ - agent which runs on guest VMs and executes deployment
plan
* `murano-dashboard`_ - Murano UI implemented as a plugin for OpenStack
Dashboard
.. _murano-api: https://git.openstack.org/cgit/stackforge/murano-api/
.. _murano-agent: https://git.openstack.org/cgit/stackforge/murano-agent/
.. _murano-dashboard: https://git.openstack.org/cgit/stackforge/murano-dashboard/
This documentation offers information on how Murano works and how to
contribute to the project.
Table of contents
=================
.. toctree::
:maxdepth: 2
contributing
guidelines
install/index
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`