Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

103 lines (70 sloc) 4.306 kB

Rudy - v0.6 ALPHA

*Rudy is a command-line development and deployment tool for Amazon Web Services.*

It helps you build and manage machines in EC2 by organizing them into groups of environments and roles. These are called machine groups. stage is the default environment and app is the default role. You can run multiple machines with the same role. These are called positions. Rudy also supports running machine groups across availability zones.

When you put all this together, you have a unique name for every machine. The default machine is:

        zone     env  role
         v        v    v   
   m-us-east-1b-stage-app-01
   ^                       ^
"machine"                position

All configuration is organized into the zones, environments, and roles that you specify (Rudy assumes positions are identical which is important for backups and scaling). And as you'd expect, the defaults can be changed too (in ~/.rudy/config).

NOTE: This is an ALPHA release. That means Rudy's not ready for production use! See Alpha Notice.

Features

  • Create complex environments with a single command

    • Launch multiple instances

    • Assign elastic IP addresses

    • Create EBS volumes, attach to instances, format, and mount

    • Run scripts locally and remotely automatically

  • Supports any Amazon machine image (AMI)

  • Complete command-line interface for EC2. See bin/rudy-ec2.

Installation

Via Rubygems, one of:

$ sudo gem install rudy
$ sudo gem install solutious-rudy --source http://gems.github.com/

or via download:

NOTE: If you are not installing via RubyGems, you need to make sure the dependencies are in your LOAD_PATH ($:). Ryan Tomayko wrote a gist about it.

See Getting-Started for more info.

Pre-Requisites

Alpha Notice

Rudy has been well tested and is currently being used in production in a private beta, but it's not ready for general production use. There are a few things to keep in mind while Rudy is in alpha status.

  • If you already have private SSH keys, back them up. Rudy is quite safe but hasn't been audited so backup your keys as a precaution.

  • If you're running EC2 instances in production, create a new set of AWS credentials (access key and secret key) to use with Rudy. This will ensure that Rudy has no access to your production instances.

  • Rudy commands and APIs may change in later releases. This means that if you create an environment with an alpha release and later upgrade Rudy, some things may not work as expected.

More Info

Thanks

  • The Rilli.com team

    • Adam Bognar

    • Andrew Simpson

    • Caleb Buxton

    • Colin Brumelle

  • Sam Aaron

  • Everyone at Utrecht.rb

  • Jamis Buck for Net::SSH and friends

  • Keshia Knight Pulliam

Contributions

I'm very open to contributions! For bigger features please fork the git repo and send me a pull request. For small or single file changes, send me an email with the details delano@solutious.com

Credits

  • Delano Mandelbaum (delano@solutious.com)

  • Rudy::AWS::SDB adapted from aws_sdb by Tim Dysinger (dysinger.net)

  • Escape, Copyright (C) 2006,2007 Tanaka Akira <akr@fsij.org>

License

See: LICENSE.txt

Jump to Line
Something went wrong with that request. Please try again.