0.01
No commit activity in last 3 years
No release in over 3 years
Provision and deploy to an Ubuntu/God/Apache/Passenger stack using Capistrano
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

= 0.4.5
 Project Readme

Ubistrano

Provision and deploy to an Ubuntu/God/Apache/Passenger stack using Capistrano and EC2.

Goals

  • Create an Ubuntu Hardy EC2 instance in one command (cap ec2)
  • Provision a solid Ubuntu Hardy application server in one command (cap ubuntu)
  • Deploy PHP, Rails, and Sinatra apps
  • Be descriptive about what is going on and allow the user to opt out
  • Simplify the deploy.rb file

The stack

  • Apache
  • EC2 (optional)
  • Git
  • MySQL
  • MySQLTuner
  • Perl
  • PHP
  • Postfix (relay)
  • Ruby
  • RubyGems
  • Passenger (mod_rails)
  • God
  • Rails
  • Sinatra
  • Sphinx

Getting started

Install gem

gem install winton-ubistrano

Ubify your project

cd your_project
ubify .
  • Runs capify
  • Creates config/deploy.example.rb
  • Adds config/deploy.rb to your project's .gitignore

Copy config/deploy.example.rb to config/deploy.rb

It should look like this:

set :ubistrano, {
  :application => :my_app,
  :platform    => :rails,  # :php, :rails, :sinatra
  :repository  => 'git@github.com:user/my-app.git',

  :ec2 => {
    :access_key => '',
    :secret_key => ''
  },

  :mysql => {
    :root_password => '',
    :app_password  => ''
    # Ubistrano creates a mysql user for each app
  },

  :production => {
    :domains => [ 'myapp.com', 'www.myapp.com' ],
    :ssl     => [ 'myapp.com' ],
    :host    => '127.0.0.1'
  },

  :staging => {
    :domains => [ 'staging.myapp.com' ],
    :host    => '127.0.0.1'
  }
}

require 'ubistrano'

Ubistrano uses the same Capistrano options you've come to love, but provides defaults and a few extra options as well.

Edit deploy.rb to the best of your ability. If setting up an EC2 instance, be sure to provide your AWS keys. Your IP address will be provided later. Provide passwords even if they haven't been created yet.

Feel free to move any options into or out of the stage groups.

Create your EC2 instance

From your app directory

cap ec2

Example output

================================================================================
Press enter for Ubuntu Hardy or enter an AMI image id:

Set up your Ubuntu Hardy server

From your app directory

cap ubuntu

Example output

================================================================================
Let's set up an Ubuntu server! (Tested with 8.04 LTS Hardy)

With each task, Ubistrano will describe what it is doing, and wait for a yes/no.

================================================================================
Please ssh into your server (use -i only for EC2):
  ssh root@174.129.232.34 -i ~/.ssh/id_rsa-studicious

Edit your sudoers file:
  visudo

Add the following line:
  deploy ALL=NOPASSWD: ALL

Continue? (y/n)

Deploy your app

All apps should have a public directory.

First deploy

cap deploy:first

Subsequent deploys

cap deploy

Deploy to staging

Use any capistrano task, but replace cap with cap staging.

Example

cap staging deploy:first