..
      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 the Heat documentation!
==================================
Heat is a service to orchestrate composite cloud applications
using a declarative template format through an OpenStack-native REST API.

Heat's purpose and vision
=========================

* Heat provides a template based orchestration for describing a cloud
  application by executing appropriate :term:`OpenStack` API calls to generate
  running cloud applications.
* A Heat template describes the infrastructure for a cloud application in text
  files which are readable and writable by humans, and can be managed by version
  control tools.
* Templates specify the relationships between resources (e.g. this
  volume is connected to this server). This enables Heat to call out to the
  OpenStack APIs to create all of your infrastructure in the correct order to
  completely launch your application.
* The software integrates other components of OpenStack. The templates allow
  creation of most OpenStack resource types (such as instances, floating ips,
  volumes, security groups, users, etc), as well as some more advanced
  functionality such as instance high availability, instance autoscaling, and
  nested stacks.
* Heat primarily manages infrastructure, but the templates
  integrate well with software configuration management tools such as Puppet and
  Ansible.
* Operators can customise the capabilities of Heat by installing plugins.

This documentation offers information aimed at end-users, operators and
developers of Heat.


Installing Heat
===============

.. toctree::
    :maxdepth: 1

    install/index

Configuring Heat
================

.. toctree::
    :maxdepth: 1

    configuration/index

Administering Heat
==================

.. toctree::
    :maxdepth: 1

    admin/index

Using Heat
==========

.. toctree::
    :maxdepth: 1

    getting_started/create_a_stack
    template_guide/index
    templates/index
    glossary

Operating Heat
==============

.. toctree::
    :maxdepth: 1

    getting_started/on_fedora
    getting_started/on_ubuntu
    operating_guides/scale_deployment
    operating_guides/httpd
    operating_guides/upgrades_guide
    man/index

Developing Heat
===============
.. toctree::
    :maxdepth: 1

    contributing/index
    getting_started/on_devstack
    developing_guides/architecture
    developing_guides/pluginguide
    developing_guides/schedulerhints
    developing_guides/gmr
    developing_guides/supportstatus
    developing_guides/rally_on_gates

API Documentation
========================

-  `Heat REST API Reference (OpenStack API Complete Reference - Orchestration)`_

   .. _`Heat REST API Reference (OpenStack API Complete Reference - Orchestration)`: http://developer.openstack.org/api-ref/orchestration/v1/

Code Documentation
==================
.. toctree::
   :maxdepth: 1

   api/autoindex

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

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