Skip to content

Capistrano plugin for deploying to Amazon EC2 instances by security groups

License

Notifications You must be signed in to change notification settings

logandk/capistrano-ec2group

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

capistrano-ec2group

Capistrano plugin for deploying to Amazon EC2 instances by security groups.

Introduction

This plugin supports the deployment strategy of using the security groups feature of Amazon EC2. If you are using auto-scaling of instances, new hostnames will be added and removed regularly, causing problems when you have to specify your servers hostnames in your Capistrano recipes.

By using security groups to organize your instances by roles, you have created a simple database of instances that is automatically updated as auto-scaling happens. By using a provisioning tool like Sprinkle, Moonshine, Chef, Puppet, Rubber (etc.) to automatically configure instances upon launch (through EC2 user-data), you have a completely automated workflow for configuring and deploying auto-scaling instances.

Installation

capistrano-ec2group is provided as a Ruby gem, with the following dependencies:

  • Capistrano 2 gem
  • RightAWS gem

You can install it with RubyGems, through RubyForge or GitHub.

RubyForge

$ gem install capistrano-ec2group

GitHub

$ gem sources -a http://gems.github.com (you only have to do this once)
$ gem install logandk-capistrano-ec2group

Usage

In order to use the capistrano-ec2group plugin, you must require it in your deploy.rb:

require 'capistrano/ec2group'

Then you must specify your Amazon EC2 credentials:

set :aws_access_key_id, '???'
set :aws_secret_access_key, '???'

If you are running capistrano from ec2 and would like to use private dns names

set :aws_pvt_dns, true

Optionally setting additional parameters, such as the region:

set :aws_params, :region => 'eu-west-1'

In order to define your instance groups, you must specify the security group name, the roles and params:

group :webserver, :web
group :app_myappname, :app
group :lamp, :web, :app
group "MySQL Servers", :db, :port => 22000

Then just sit back, relax and cap deploy!

Documentation

Additional RDoc documentation is available at: http://rdoc.info/projects/logandk/capistrano-ec2group

Credits

###Thanks to###

Copyright (c) 2009 Logan Raarup, released under the MIT license

About

Capistrano plugin for deploying to Amazon EC2 instances by security groups

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages