..
      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`_ - 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: https://git.openstack.org/cgit/stackforge/murano/
.. _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.


**Installation**

.. toctree::
   :maxdepth: 1

   install/index

**Background Concepts for Murano**

.. toctree::
   :maxdepth: 1

   murano_pl/murano_pl_index
   articles/dynamic_ui
   articles/workflow
   articles/policy_enf_index


**Tutorials**

.. toctree::
   :maxdepth: 1

   articles/app_pkg
   articles/heat_support
   image_builders/index
   articles/test_docs

**Guidelines**

.. toctree::
   :maxdepth: 2

   contributing
   guidelines
   articles/debug_tips
   articles/app_migrating


**API specification**

.. toctree::
   :maxdepth: 1

   specification/index

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`