No commit activity in last 3 years
No release in over 3 years
Foreman support for Capistrano 3.x
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0

Runtime

>= 1.2.0
 Project Readme

Capistrano::Foreman

Gem Version

Capistrano V3 for foreman

WIP

There be dragons, proceed at your own risk.

Installation

Add this line to your application's Gemfile:

gem 'capistrano3-foreman-precogs'

And then execute:

$ bundle

Or install it yourself as:

$ gem install capistrano3-foreman-precogs

Usage

Require in Capfile to use the default task:

require 'capistrano/foreman'

###Export Procfile to upstart###

This task will be run before deploy:restart as part of Capistrano's default deploy, or can be run in isolation with:

cap production foreman:export

NOTE

In order for foreman to export to upstart your deploy user must have sudoer privileges

###Options###

Custom ENVIRONMENT variables for foreman (see here).

set :foreman_env,  '/remote/path/to/your.env'         # Default none 

##The Twelve Factor App##

(Treat backing services as attached resources) by using ENV variables for your configuration.

database.yml

default: &default
  adapter: mysql2
  host: <%= ENV['DATABASE_HOST'] %>
  username: <%= ENV['DATABASE_USERNAME'] %>
  password: <%= ENV['DATABASE_PASSWORD'] %>
  encoding: utf8
  reconnect: true

staging:
  <<: *default
  database: app_web_staging

production:
  <<: *default
  database: app_web_production

deploy.rb

set :foreman_env,     '/home/deploy/.pam_environment'

.pam_environment

DATABASE_HOST=database.example.com
DATABASE_USERNAME=user
DATABASE_PASSWORD=password
RAILS_ENV=staging

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