Cirrus

A command-line tool to launch and provision EC2 instances. Cirrus is an experimental work-in-progress and should not be considered production-ready.

Installation

Add this line to your application's Gemfile:

gem 'cirrus'

And then execute:

$ bundle

Or install it yourself as:

$ gem install cirrus

Usage

The CLI ships with two commands: launch and teardown.

Launching an instance

Usage: cirrus launch IMAGE_ID AWS_ACCESS_KEY AWS_SECRET_KEY REGION

This will automatically create a default Cirrus key pair and security group (authorizing inbound SSH and HTTP traffic), and launch an instance

For example, cirrus launch ami-ee4f77ab <access_key> <secret_key> us-west-1 will launch an instance running Ubuntu 14.04 in us-west-1 (N. California).

Tearing down an instance

Usage: cirrus teardown INSTANCE_ID AWS_ACCESS_KEY AWS_SECRET_KEY REGION

Example: cirrus teardown i-bdc5b377 <access_key> <secret_key> us-west-1

This will terminate the specified instance and destroy its associated security groups and keypairs.

That's it!

Contributing

  1. Fork it ( https://github.com/andrewberls/cirrus/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request