No commit activity in last 3 years
No release in over 3 years
A Ruby library for capturing deployment configuration info from ec2 and future cloud services
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

>= 0.9.9
>= 0.11.6
>= 0.10.0
>= 2.1.2

Runtime

 Project Readme

Capistrano::Clouddeploy

Use Capistrano Cloud Deploy Gem to deploy your Amazon EC2 instances. Tag your instances with the the roles they get then on deployment Capistrano Cloud Deploy can figure out the roles and load into the capistrano configuration.

Installation

Add this line to your application's Gemfile:

gem 'capistrano-clouddeploy'

And then execute:

$ bundle

Or install it yourself as:

$ gem install capistrano-clouddeploy

Usage

Within deploy.rb or whatever multistage cap config file place:

require 'capistrano-clouddeploy'
cloud_config_roles = []
cloud_required_roles = [ :app, :db, :web ]
stage = <STAGE> 
configuration = YAML.load(File.open(File.dirname(__FILE__) + "/amazon_ec2.yml"))[stage]
set :deploy_manager, CapistranoCloudDeploy::AWSManager.new(self, application, stage, configuration)
deploy_manager.set_cap_roles cloud_required_roles, cloud_config_roles

To List Roles: bundle exec cap deploy:list_roles

You'll see output similar to the following:

 * executing `deploy:list_roles'
** ROLES:
** 
** role: web
** ec2-23-**-27-232.compute-1.amazonaws.com
** 
** role: db
** ec2-23-**-27-232.compute-1.amazonaws.com
** 
** role: app
** ec2-23-**-27-232.compute-1.amazonaws.com

or if you're using multistage-ext you can type

bundle exec cap <STAGE> deploy:list_roles

Cloud deploy will use either the public dns or fall back to elastic ip address of an ec2 instance

To get last deployed tag: bundle exec cap deploy:last_deploy_tag

You'll see output similar to the following:

 * executing `production_ec2'
 triggering start callbacks for `deploy:last_deploy_tag'
* executing `multistage:ensure'
* executing `deploy:last_deploy_tag'
** last deploy tag: 1.0

or if you're using multistage-ext you can type

bundle exec cap <STAGE> deploy:last_deploy_tag

Tag Machines in Amazon with the following: (Name and Value)

<APP_NAME_AS_DEFINED_IN_CAPISTRANO>/enabled (true | false)
If set to false capistrano will ignore


<APP_NAME_AS_DEFINED_IN_CAPISTRANO>/multistage/environment (<STAGE_NAME>)
Stage is the stage that this instance applies to


<APP_NAME_AS_DEFINED_IN_CAPISTRANO>/capistrano/roles (web,db,app, ROLE, ...)
<APP_NAME_AS_DEFINED_IN_CAPISTRANO>/capistrano/roles  is a comma separated list of roles that the machine has

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request