HEAT(1)

NAME
heat-boto - perform a heat action via the heat API

SYNOPSIS

heat-boto COMMAND [OPTIONS]

DESCRIPTION

heat-boto is a tool to orchestrate the setup of multiple cloud applications. heat-boto is port a of the heat tool to use the boto client library.

CONFIGURATION FILES
heat-boto uses the boto client library, which looks for configuration in /etc/boto.cfg heat installs a default version of this file, but you will need to update the aws_access_key_id and aws_secret_access_key values with your real keystone credentials. Use keystone ec2-credentials-list to retrieve your keystone ec2 access keys.

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

-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

-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, --timeout
    Stack creation timeout (default is 60 minutes)

-v, --verbose
    Enable verbose output

-y, --yes
    Do not prompt for confirmation, assume yes

USAGE EXAMPLES

heat-boto -d create wordpress --template-file=templates/WordPress_Single_Instance.template --parameters="InstanceType=m1.xlarge;DBUsername=${USER};DBPassword=verybadpass;KeyName=${USER}_key" heat-boto list heat-boto describe wordpress heat-boto resource-list wordpress heat-boto resource-list-details wordpress heat-boto resource-list-details wordpress WikiDatabase heat-boto resource wordpress WikiDatabase heat-boto event-list heat-boto delete wordpress

AUTHOR

See the AUTHORS file for a complete list of contributors.

COPYRIGHT

Copyright © 2012, Red Hat Inc

Heat is released under the terms of the ASL 2 License.

Extensive documentation as well as IRC and mailing list info is available on the heat home page: https://heat-api.org/