gistfile1.txt

Syntax For Rack Commands
======================

rack (https://github.com/rackspace/rack) is the shiny new cli to talk to rackspace public cloud. The cli is meant to be used primarily by customers and hence should be intuitive and easy to use.

Here is the syntax I propose for the rack commands related to orchestration:
The shortened service name I'm using is "orch". We can use "heat" or anything else also.

Stacks:
    Create Stack                             rack orch stack create  --name StackName -e [File | URL]
    Adopt Stack:                              rack orch stack adopt  [--name StackName| --id StackID]
    List Stack Data:                         rack orch stack list  [--name StackName| --id StackID]
    Find Stack:                                (included in rack orch stack get)
    Show Stack Details:                  rack orch stack get  [--name StackName| --id StackID]
    Update Stack:                           rack orch stack update  [--name StackName| --id StackID]
    Delete Stack:                            rack orch stack delete  [--name StackName| --id StackID]
    Preview Stack:                          rack orch stack preview  [--name StackName| --id StackID]
    Abandon Stack:                        rack orch stack abandon   [--name StackName| --id StackID]

Stack Resources:
    Find Stack Resources:               (included in rack orch resource get )
    List Resources                            rack orch resource list  [--name StackName| --id StackID]
    Show Resource Data                  rack orch resource get  [--name StackName| --id StackID] --resource Resource
    Show Resource Metadata          rack orch resource get-metadata  [--name StackName | --id StackID] --resource Resource
    List Resource Types                   rack orch resource list-types
    Show Resource Schema            rack orch resource get-type --name  Resource
    Show Resource Template          rack orch resource get-template --name Resource

Stack Events:
    Find Stack Events                      (included in rack orch event list-stack)
    List Stack Events                        rack orch event list-stack [--name StackName| --id StackID] 
    List Resource Events                  rack orch event list-resource --name Resource
    Show Event Details                    rack orch event get  [--name StackName| --id StackID] --resource Resource --event Event

Templates:
    Get Stack Template                   rack orch template get  [--name StackName| --id StackID] 
    Validate Template                      rack orch template validate  [--template-file TemplateFile| --template-url TemplateURL]

Build Info:
    Show Build Information             rack orch buildinfo list