Virtualmonkey is a project mainly written in ..., based on the MIT license.
= QuickStart == Install === from rubyforge (soon) "gem install virtualmonkey"
=== from source "git clone http://github.com/jeremyd/virtualmonkey" "gem install jeweler rspec" "rake check_dependencies" <- Install any gems listed. "rake install"
== Configuration You need to setup ~/.fog and ~/.rest_connection with configuration options to match your RightScale account (for using the RightScale API) and your AWS credentials (for SimpleDB and S3). Just run the monkey, and it will tell you how to setup your missing credentials.
== Usage The command line client is "monkey". It lives in your gem binary path. See the help pages for usage: "monkey create --help" "monkey run --help" "monkey destroy --help"
= Virtual Monkey Architecture
== RightScale API access Uses rest_connection library from http://github.com/jeremyd/rest_connection.git
== S3 and SimpleDB access Uses Fog library from http://github.com/geemus/fog.git
== Virtual Monkey command line client "monkey"
== Cruise Control Hooks (todo)
== Shared Resource Tracking (Amazon SimpleDB) Shared Resources like DNS_IDs and EIPs will be shared among clients using conditional PUT operations to SimpleDB. SharedDns
== Management Classes
=== DeploymentMonk - handles create/load/delete of DeploymentSets Using the RS API we create a set of all the 'basic variations' a deployment can have. Basic variations currently are generated using permutations of Images, Clouds, and Instance Types. === GrinderMonk handles running grinder tests and collecting and posting results to S3 === VirtualMonkey::DeploymentRunner
These are a set of specialty mixins per Deployment type for cluster management of a single deployment.
This keeps our grinder features from getting cluttered. Each step definition needs an equivalent DeploymentRunner method.
'One-off' variations are setup by the DeploymentRunner(s) and will be applied during a test run. ex: OPT_PHP_VHOST_PORT, SLAVE_DNS_ID
VirtualMonkey::MysqlRunner, VirtualMonkey::FeAppRunner, VirtualMonkey::EBSRunner, VirtualMonkey::Mysql, VirtualMonkey::EBS
=== Grinder feature tests
== Note on Patches/Pull Requests
== Copyright
Copyright (c) 2010 Jeremy Deininger. See LICENSE for details.