heat/doc/source/man/heat-cfn.rst
Steve Baker c4777794e7 A new documention structure, ready for contributions
Here are some skeletons for the documentation which will need to be written.

doc/source
	A Sphinx based document which will be aimed at heat developers.
    	This also contains .rst files which generate the man files
doc/docbkx/api-ref
	Docbook and WADL for the REST API, with the intent of moving this
	to api-site to publish to api.openstack.org
doc/docbkx/heat-admin
	Docbook manual targeted at Heat admins, with the intent of moving this
        to openstack-manuals to publish to docs.openstack.org
doc/docbkx/heat-cli
	Docbook manual targeted at users of the Heat CLI, with the intent of
	moving this to openstack-manuals to publish to docs.openstack.org

Dude, wheres my man pages?
docs/man
	is deleted, now generated into doc/build/man

Packaging will need to be updated to generate the man pages

Change-Id: Idf2f37086b6f97df18ed57172de2f9e3d4c7706a
2012-12-19 10:22:35 +13:00

3.7 KiB

heat-cfn

heat-cfn

SYNOPSIS

heat-cfn [OPTIONS] COMMAND [COMMAND_OPTIONS]

DESCRIPTION

heat-cfn is a command-line utility for heat. It is simply an interface for adding, modifying, and retrieving information about the stacks belonging to a user. It is a convenience application that talks to the heat CloudFormation API compatable server.

CONFIGURATION

heat-cfn uses keystone authentication, and expects some variables to be set in your environment, without these heat will not be able to establish an authenticated connection with the heat API server.

Example:

export ADMIN_TOKEN=<keystone admin token>

export OS_USERNAME=admin

export OS_PASSWORD=verybadpass

export OS_TENANT_NAME=admin

export OS_AUTH_URL=http://127.0.0.1:5000/v2.0/

export OS_AUTH_STRATEGY=keystone

COMMANDS

create

Create stack as defined in template file

delete

Delete specified stack

describe

Provide detailed information about the specified stack, or if no arguments are given all stacks

estimate-template-cost

Currently not implemented

event-list

List events related to specified stacks, or if no arguments are given all stacks

gettemplate

Get the template for a running stack

help

Provide help/usage information

list

List summary information for all stacks

resource

List information about a specific resource

resource-list

List all resources for a specified stack

resource-list-details

List details of all resources for a specified stack or physical resource ID, optionally filtered by a logical resource ID

update

Update a running stack with a modified template or template parameters - currently not implemented

validate

Validate a template file syntax

OPTIONS

-S, --auth_strategy

Authentication strategy

-A, --auth_token

Authentication token to use to identify the client to the heat server

-N, --auth_url

Authentication URL for keystone authentication

-d, --debug

Enable verbose debug level output

-H, --host

Specify the hostname running the heat API service

-k, --insecure

Use plain HTTP instead of HTTPS

-P, --parameters

Stack input parameters

-K, --password

Password used to acquire an authentication token

-p, --port

Specify the port to connect to for the heat API service

-R, --region

Region name. When using keystone authentication "version 2.0 or later this identifies the region

-f, --template-file

Path to file containing the stack template

-u, --template-url

URL to stack template

-T, --tenant

Tenant name used for Keystone authentication

-t, --timeout

Stack creation timeout (default is 60 minutes)

-U, --url

URL of heat service

-I, --username

User name used to acquire an authentication token

-v, --verbose

Enable verbose output

-y, --yes

Do not prompt for confirmation, assume yes

EXAMPLES

heat-cfn -d create wordpress --template-file=templates/WordPress_Single_Instance.template --parameters="InstanceType=m1.xlarge;DBUsername=${USER};DBPassword=verybadpass;KeyName=${USER}_key"

heat-cfn list

heat-cfn describe wordpress

heat-cfn resource-list wordpress

heat-cfn resource-list-details wordpress

heat-cfn resource-list-details wordpress WikiDatabase

heat-cfn resource wordpress WikiDatabase

heat-cfn event-list

heat-cfn delete wordpress

BUGS

Heat bugs are managed through Launchpad <https://launchpad.net/heat>