Description

Installs the latest build of Mater, a lightweight web application that bridges Graphite and StatusBoard.

Includes an optional recipe to install Unicorn and proxy to it with Apache.

Requirements

• Chef 0.9.x+

Platforms

Supported on:

• CentOS, Red Hat, Fedora

Tested on:

• CentOS 6.3 - 6.4
• Chef 0.9.14, 10.14.2

Dependencies

The following cookbooks are dependencies:

• git

The follow cookbooks are optional dependencies:

• apache2
• unicorn

Recipes

• mater::apache
  • Installs the latest version of Mater
  • Installs Unicorn as a Rack server
  • Installs Apache as a proxy

Attributes

Required Attributes

• default['mater']['apache']['server_name]']
  • Name of the virtual host for Apache e.g. the FQDN for Mater.
• default['mater']['graphite']['url']
  • URL to the graphite server.
• default['mater']['unicorn']['bin']
  • Path to the unicorn binary. Only required if not using RVM.

Optional Attributes

• default['mater']['home']
  • Base directory for Mater.
  • Each deploy of Mater is installed within in a separate timestamped subdirectory.
  • Most recent deploy is symlinked to the curent folder.
• default['mater']['git']['url']
  • GitHub URL for installing Mater.
• default['mater']['git']['branch']
  • Git branch for installer Mater. Defaults to master.
• default['mater']['unicorn']['user']
  • System user for Unicorn.
  • Defaults to unicorn.
• default['mater']['unicorn']['pid']['directory']
  • Directory for unicorn pid file.
  • Defaults to /var/run/unicorn
• default['mater']['unicorn']['pid']['file']
  • Name of unicorn pid file.
  • Defaults to mater.pid
• default['mater']['unicorn']['worker_timeout']
  • Unicorn worker timeout in seconds.
  • Defaults to 60.
• default['mater']['unicorn']['preload_app']
  • Preload the Mater application in Unicorn before forking worker processes.
  • Defaults to true.
• default['mater']['unicorn']['before_fork']
  • Ruby proc to execute before forking each worker.
  • Defaults to sleep 1
• default['mater']['unicorn']['port']
  • Listening port for Unicorn.
  • Defaults to 9080.

Usage

Add something like the following to your recipe or role:

node["mater"]["apache"]["server_name"] = "mater.graphite.example.com"
node['mater']['graphite']['url'] = "https://graphite.example.com"
node['mater']['unicorn']['bin'] = "/usr/bin/unicorn"

include_recipe "mater::apache"

Note that you do not need to specify the path to Unicorn if you are running under RVM. The init script will automatically find Unicorn in that case.

License

• Author: Sean Laurent
• Copyright: 2013 StudyBlue, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.