Mascherano

Capistrano 3.x recipes

Installation

Add this line to your application's Gemfile:

gem 'mascherano'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mascherano

Recipes

Mascherano currently have several recipes:

recipe	description
env	Manage application configuration on .env file
foreman	Manage Procfile application for Foreman
figaro	Manage configuration, usually application.yml for Figaro
go	Manage and ability to deploy go application
upstart	Manage application management using Upstart
token	Manage and generate random secret token
passenger	Manage Pushion Passenger based application
auth_basic	Manage and generate HTTP basic authentication .htpasswd
supervisor	Manage applications through supervisor process manager
more to come	pull request are welcome ;)

This package also provides a noscm recipe for when you don't need source code on your deployment box (usually application already compiled).

# deploy.rb
set :scm, :noscm

Usage

Make sure you have Capfile in the root of your project, so you can add these lines (choose which one you're using):

require 'mascherano/env'
require 'mascherano/foreman'
require 'mascherano/figaro'
require 'mascherano/go'
require 'mascherano/upstart'
require 'mascherano/token'
require 'mascherano/passenger'
require 'mascherano/auth_basic'
require 'mascherano/supervisor'

Then on config/deploy/{env}.rb you can customize the options:

set :env_file, '.staging.env'
set :foreman_procfile, -> { release_path.join('procfiles', 'staging') }
set :foreman_pids, -> { shared_path.join('pids') }

See the lib/mascherano/task/*.cap for more options.

Contributing

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