simpleweb/puppet-unicorn

Name: puppet-unicorn

Owner: Simpleweb

Description: Install and manage Unicorn: Rack HTTP server for fast clients and Unix

Created: 2014-01-27 14:03:28.0

Updated: 2014-04-02 10:27:15.0

Pushed: 2014-04-02 10:27:14.0

Homepage: null

Size: 268

Language: Puppet

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

puppet-unicorn

A puppet module that creates unicorn services for Rack apps.

Installation

Not yet available on Puppet Forge.

To include it as a git submodule, do something like:

$ git submodule add git@github.com:simpleweb/puppet-unicorn.git modules/unicorn
Usage

Declare a new unicorn service like so:

orn::app { "acme":
proot     => "/home/acme/rackapp",
dfile     => "/home/acme/rackapp/tmp/pids/unicorn.pid",
cket      => "/home/acme/rackapp/tmp/sockets/unicorn.sock",
nfig_file => "/home/acme/rackapp/config/unicorn.rb",
er        => "acme",
oup       => "acme",
ck_env    => "production",

This will create a corresponding init.d service as follows:

$ service unicorn_acme
Usage: /etc/init.d/unicorn_acme {start|stop|restart|status}

Puppet will ensure this service is running as part of the run.

Parameters

Below is the full list of options, with defaults where appropriate:

proot*]            - Path to the Rack application root. Your config.ru
                     file should be in this directory
dfile*]            - Filepath to read / write the PID to
cket*]             - Filepath to create the socket file
nfig_file*]        - Path to your app's unicorn config file
er*]               - User to run the unicorn process as (root)
oup*]              - Group to run the unicorn process as (root)
ck_env*]           - Environment to run your Rack app under (production)
ndler_executable*] - Path to bundler executable (bundle)
icorn_options*]    - Unicorn start options (--daemonize --env \
                     ${rack_env} --config-file ${config_file})
Limitations & assumptions

This module does not

This is because there are so many different ways of installing Ruby and gems

The module assumes

Requirements

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.