Merge "Enable glance-api show_image_direct_url for COW"
[apex-tripleo-heat-templates.git] / README.rst
1 ======================
2 tripleo-heat-templates
3 ======================
4
5 Heat templates to deploy OpenStack using OpenStack.
6
7 * Free software: Apache license
8 * Documentation: http://docs.openstack.org/developer/tripleo-docs
9 * Source: http://git.openstack.org/cgit/openstack/tripleo-heat-templates
10 * Bugs: http://bugs.launchpad.net/tripleo
11
12 Features
13 --------
14
15 The ability to deploy a multi-node, role based OpenStack deployment using
16 OpenStack Heat. Notable features include:
17
18  * Choice of deployment/configuration tooling: puppet, os-apply-config, and
19    (soon) docker
20
21  * Role based deployment: roles for the controller, compute, ceph, swift,
22    and cinder storage
23
24  * physical network configuration: support for isolated networks, bonding,
25    and standard ctlplane networking
26
27 Directories
28 -----------
29
30 A description of the directory layout in TripleO Heat Templates.
31
32  * deprecated: contains templates that have been deprecated
33
34  * environments: contains heat environment files that can be used with -e
35                  on the command like to enable features, etc.
36
37  * extraconfig: templates used to enable 'extra' functionality. Includes
38                 functionality for distro specific registration and upgrades.
39
40  * firstboot: example first_boot scripts that can be used when initially
41               creating instances.
42
43  * network: heat templates to help create isolated networks and ports
44
45  * puppet: templates mostly driven by configuration with puppet. To use these
46            templates you can use the overcloud-resource-registry-puppet.yaml.
47
48  * os-apply-config: templates mostly driven by configuration w/
49                     os-collect-config and bash based
50                     elements (which use the Heat os-apply-config group).
51                     These will soon be deprecated and are no longer part
52                     of the upstream CI testing efforts.
53
54  * validation-scripts: validation scripts useful to all deployment
55                        configurations