public
Description: Run a self-healing, auto-scaled and monitored cloud simply, in the clouds, on nearly any hardware, such as EC2, eucalyptus and vmware
Homepage: http://www.poolpartyrb.com
Clone URL: git://github.com/auser/poolparty.git
Click here to lend your support to: poolparty and make a donation at www.pledgie.com !
name age message
file .gitignore Tue Aug 18 11:58:11 -0700 2009 Added debug flag to wait_for_port as well as up... [auser]
file .gitmodules Fri Aug 07 13:33:50 -0700 2009 Removed dslfiy and parenting as submodules [auser]
file .rdebugrc Thu May 28 21:02:44 -0700 2009 Move base_packages/* files to plugins/* Elimina... [fairchild]
file License.txt Wed Apr 01 11:50:54 -0700 2009 merge deps_remoter_merge branch. This brings in... [fairchild]
file Makefile Fri Jul 10 23:27:36 -0700 2009 Adding more tests to chef [auser]
file README.rdoc Loading commit data...
file Rakefile Tue Oct 27 15:22:03 -0700 2009 Fixed tests [auser]
file VERSION.yml
directory bin/ Tue Oct 27 14:07:31 -0700 2009 Updated security group check only if the securi... [auser]
directory config/ Fri Sep 04 17:28:18 -0700 2009 Updated gemspec for github [auser]
directory examples/ Wed Oct 28 17:22:35 -0700 2009 Fixed waiting bug as well as printing error [auser]
directory lib/ Wed Oct 28 17:22:35 -0700 2009 Fixed waiting bug as well as printing error [auser]
file poolparty.gemspec Wed Oct 28 16:42:00 -0700 2009 Merged in fairchild's changes [auser]
file setup.rb Sun Oct 19 15:47:21 -0700 2008 Updating resourcing DSL [Ari Lerner]
directory test/ Tue Oct 27 15:22:03 -0700 2009 Fixed tests [auser]
directory vendor/ Tue Oct 27 15:12:27 -0700 2009 Updating tests and test directory [auser]
README.rdoc

PoolParty

poolpartyrb.com

DESCRIPTION:

PoolParty makes cloud provisioning and management easy. PoolParty provides a unified interface for provisioning, management and cloud life-cycle on many different cloud providers, such as EC2 and vmware.

Code your cloud!

SYNOPSIS:

PoolParty is written with the intention of being as application-agnostic as possible. It installs only the basic required software to glue the cloud together on the instances as listed below.

Quickstart

For instance, to start a basic cloud, let’s write one:

  pool "demo" do
    cloud "app" do
      using :ec2
      instances 1
      keypair "cloud_demo"
    end
  end

Simply by issuing the command:

  cloud start

The app cloud in the demo pool will be started, bootstrapped and provisioned to your liking. If the platform is not specified, then it’s assumed to be ubuntu. However, if a node is running, then PoolParty will introspect the node and determine the operating system. This can be specified in the clouds.rb.

There are a number of commands PoolParty offers to interact with your cloud. They include:

  • cloud start
  • cloud terminate
  • cloud bootstrap
  • cloud configure
  • cloud compile
  • cloud console
  • cloud expand
  • cloud contract
  • cloud list
  • cloud show
  • cloud ssh

There is also a helper installer script. This is an easy way to get started bootstrapping your environment:

  • install-poolparty

We can change the cloud provider simply by changing the using line. For instance:

  pool "demo" do
    cloud "app" do
      #...
      using :rackspace # coming soon
      #...

Clouds are distinguished by keypairs, so to create multiple clouds, create a new keypair. For instance:

  pool "demo" do
    cloud "app" do
      keypair "demo_app"
      #...
    end
    cloud "db" do
      keypair "demo_db"
      #...
    end
  end

Extending

To add a cloud_provider, there are four methods that need to be implemented. Simply sublcass the CloudProviders module and require it in your clouds.rb (or commit it back to PoolParty). Those four methods are:

  • run_instance
  • terminate_instance
  • describe_instances
  • describe_instance

That’s it!

Each resource is documented in the code and more documentation can be found at the site: <a href="http://poolpartyrb.comhttp://poolpartyrb.com>.

REQUIREMENTS:

  • Ruby

INSTALL:

sudo gem install auser-poolparty

LICENSE:

(The MIT License)

Copyright © 2009 Ari Lerner, CloudTeam

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘Software’), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.