blob: b9058f1cd5bc7d4e5acf38e4bd1c091b1dc2b3a3 [file] [log] [blame]
Filip Pytloun923d8692015-10-06 16:28:32 +02001
2====
3Heat
4====
5
6Heat is the main project in the OpenStack Orchestration program. It implements an orchestration engine to launch multiple composite cloud applications based on templates in the form of text files that can be treated like code. A native Heat template format is evolving, but Heat also endeavours to provide compatibility with the AWS CloudFormation template format, so that many existing CloudFormation templates can be launched on OpenStack. Heat provides both an OpenStack-native ReST API and a CloudFormation-compatible Query API.
7
8Sample pillars
9==============
10
11Single Heat services on the controller node
12
13.. code-block:: yaml
14
15 heat:
16 server:
17 enabled: true
18 version: icehouse
Jakub Pavlik51e15e02016-03-12 13:32:26 +010019 region: RegionOne
Filip Pytloun923d8692015-10-06 16:28:32 +020020 bind:
21 metadata:
22 address: 10.0.106.10
23 port: 8000
24 waitcondition:
25 address: 10.0.106.10
26 port: 8000
27 watch:
28 address: 10.0.106.10
29 port: 8003
30 cloudwatch:
31 host: 10.0.106.20
32 api:
33 host: 10.0.106.20
34 api_cfn:
35 host: 10.0.106.20
36 database:
37 engine: mysql
38 host: 10.0.106.20
39 port: 3306
40 name: heat
41 user: heat
42 password: password
43 identity:
44 engine: keystone
45 host: 10.0.106.20
46 port: 35357
47 tenant: service
48 user: heat
49 password: password
50 message_queue:
51 engine: rabbitmq
52 host: 10.0.106.20
53 port: 5672
54 user: openstack
55 password: password
56 virtual_host: '/openstack'
57 ha_queues: True
58
59Heat client with specified git templates
60
61.. code-block:: yaml
62
63 heat:
64 client:
65 enabled: true
66 source:
67 engine: git
68 address: git@repo.domain.com/heat-templates.git
69 revision: master
70
71Heat system definition of several stacks/systems
72
73.. code-block:: yaml
74
75 heat:
76 control:
77 enabled: true
78 system:
79 web_production:
80 format: hot
81 template_file: /srv/heat/template/web_cluster.hot
82 environment: /srv/heat/env/web_cluster/prd.env
83 web_staging:
84 format: hot
85 template_file: /srv/heat/template/web_cluster.hot
86 environment: /srv/heat/env/web_cluster/stg.env
87
88Ceilometer notification
89
90.. code-block:: yaml
91
92 heat:
93 server:
94 enabled: true
95 version: icehouse
96 notification: true
97
98Usage
99=====
100
101Install Contrail Heat plugin for additional resources
102
103.. code-block:: bash
104
105 pip install git+https://github.com/Juniper/contrail-heat.git@R1.30
106
107Read more
108=========
109
110* http://docs.openstack.org/developer/heat/man/heat-keystone-setup.html
111* http://docwiki.cisco.com/wiki/OpenStack_Havana_Release:_High-Availability_Manual_Deployment_Guide
112
113
114Things to improve
115=================
116
117* IBM UrbanCode Deploy - has resources for AWS and VMWare
118 http://www.ibm.com/developerworks/rational/library/multi-platform-application-deployment-urbancode-deploy/
119