Automatic Heat template generation

Go to file

Monty Taylor 706ce53d02 Change ignore-errors to ignore_errors Needed for coverage 4.0 Change-Id: Ic2703f09ec96f78ca260e78fd32256206c8596fa		2015-09-21 14:58:32 +00:00
doc/source	Added option generate-stack-data to usage	2014-09-01 10:14:03 +02:00
flameclient	Add new option to exclude key pairs from template	2015-08-27 15:41:23 +02:00
.coveragerc	Change ignore-errors to ignore_errors	2015-09-21 14:58:32 +00:00
.gitignore	Refactor the code to match the openstack code structure.	2014-08-25 20:58:42 -04:00
.gitreview	Add .gitreview file.	2014-12-22 09:00:54 +00:00
.testr.conf	Refactor the code to match the openstack code structure.	2014-08-25 20:58:42 -04:00
LICENSE	Add documentation on how to use flame	2014-08-29 16:47:52 -04:00
MANIFEST.in	Refactor the code to match the openstack code structure.	2014-08-25 20:58:42 -04:00
README.rst	Add new option to exclude key pairs from template	2015-08-27 15:41:23 +02:00
babel.cfg	Refactor the code to match the openstack code structure.	2014-08-25 20:58:42 -04:00
requirements.txt	Respect flake8/pep8 rules	2014-11-08 18:45:06 +01:00
setup.cfg	Refactor the TemplateGenerator class	2014-09-11 15:48:24 -04:00
setup.py	Refactor the code to match the openstack code structure.	2014-08-25 20:58:42 -04:00
test-requirements.txt	Refactor the TemplateGenerator class	2014-09-17 15:30:56 -04:00
tox.ini	Refactor the code to match the openstack code structure.	2014-08-25 20:58:42 -04:00

README.rst

Flame: Automatic Heat template generation

OpenStack Orchestration project Heat implements an orchestration engine to launch multiple composite cloud applications based on templates. A Heat template describes infrastructure resources (servers, networks, floating ips, etc) and the relationships between these resources, allowing Heat to deploy the resources in a correct order and to manage whole infrastructure lifecycle.

flame is a standalone tool that generates HOT Heat template from already existing infrastructure. It provides support for Nova (key pairs and servers), Cinder (volumes) and Neutron (router, networks, subnets, security groups and floating IPs) resources.

flame works as follows: using provided credentials (user name, project name, password, authentication url), the tool will list supported resources deployed in the project and will generate corresponding, highly customized HOT template.

Installation

First of all, clone the repository and go to the repository directory:

git clone https://github.com/stackforge/flame.git cd flame

Then just run:

python setup.py install

Usage

usage: flame [-h] [--username USERNAME] [--password PASSWORD]

[--project PROJECT] [--region REGION] [--auth_url AUTH_URL] [--insecure] [--exclude-servers] [--exclude-volumes] [--generate-stack-data]

Heat template and data file generator

optional arguments:

-h, --help show this help message and exit --username USERNAME A user name with access to the project. Defaults to env[OS_USERNAME] --password PASSWORD The user's password. Defaults to env[OS_PASSWORD] --project PROJECT Name of project. Defaults to env[OS_TENANT_NAME] --region REGION Name of region. Defaults to env[OS_REGION_NAME] --auth_url AUTH_URL Authentication URL. Defaults to env[OS_AUTH_URL]. --insecure Explicitly allow clients to perform"insecure" SSL (https) requests. The server's certificate will not be verified against any certificate authorities. This option should be used with caution. --exclude-servers Do not export in template server resources --exclude-volumes Do not export in template volume resources --exclude-keypairs Do not export in template key pair resources --generate-stack-data In addition to template, generate Heat stack data file.

Usage example

To use Flame you can provide yours OpenStack credentials as arguments :

$ flame --username user --password password --project project --auth_url http://<Keystone_host>:5000/v2.0

Or you can source your OpenStack RC file and use Flame without arguments.