Contents

## Rumm: a tasty tool for hackers and pirates

[![Gem Version](https://badge.fury.io/rb/rumm.png)](http://badge.fury.io/rb/rumm)
[![Build Status](https://travis-ci.org/rackspace/rumm.png?branch=master)](https://travis-ci.org/rackspace/rumm)
[![Dependency Status](https://gemnasium.com/rackspace/rumm.png)](https://gemnasium.com/rackspace/rumm)


Rumm is a command line interface and API to rackspace. You can use it
to easily build and manage infrastructure for great good.


## Usage

Authenticate with rackspace using your cloud credentials as follows:
    
    rumm login
      username: joe
      password: ****
      Default Region (Enter for ord):

      logged in as joe, credentials written to ~/.rummrc
*(Note: The authentication will fail unless you have generated and bound an API Key to your account: https://mycloud.rackspace.com/account#settings).*    

Now we can see the list of servers we have available:

    $ rumm show servers
    you don't have any servers, but you can create one by running:
    rumm create server

Create the server:

    rumm create server
      created server divine-reef
        id: 52415800-8b69-11e0-9b19-734f565bc83b, hostId: e4d909c290d0fb1ca068ffaddf22cbd0, ip: 67.23.10.138, image: CentOS 5.2
        
For further help, including a full listing of commands, type:

    rumm help

To access servers outside of your default region, you can prefix your rumm command with `REGION=<region name>`.

For example to list servers in IAD you would execute the following:

    REGION=iad rumm show servers

## Further Reading

See the [official rumm website][1] for more information, including documentation.

[1]: http://rackerlabs.github.io/rumm

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
rumm-0.1.0	README.md