Capistrano 3.x recipes
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
img
lib
.gitignore
Gemfile
LICENSE
README.md
Rakefile
mascherano.gemspec

README.md

Logo

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