casecommons / sentry-cookbook

Chef cookbook for setnry

Description

Cookbook for setup and configure sentry application.

Requirements

python

Attributes

The sentry.conf.py file are dynamically generated from attributes.

All default values of attributes you can see in attributes/default.rb

Usage

To use the cookbook we recommend creating a cookbook named after the application, e.g. my_app. In metadata.rb you should declare a dependency on this cookbook:

depends "sentry"

Include recipe[sentry] to you runlist.

Replace you own node['sentry']['key'] random key.

For create new superusers you need overrider node['sentry']['superusers'] attribute:

"superusers" => [{
                 "username" => "alex",
                 "password" => "tmppassword",
                 "email" => "[email protected]"}]

We recommend change temporary passwords after from web interface.

To configure database override node['sentry']['databases']['default'] keys:

 "databases" => {
    "default" => {
      "NAME" => "/var/www/sentry/sentry.db"
    },
 }

Add "recipe[sentry::instance]" to you runlist.

Or make you own custom configuration via resouces and definitions.

Create sentry config

sentry_conf "sentry" do
    user "sentry"
    group "sentry"
    virtualenv node["sentry"]["virtualenv"]
    # Settings file variables hash
    settings {}
end

Create launch instance:

# Running sentry instance
sentry_instance "sentry" do
    virtualenv node["sentry"]["virtualenv"]
    user node["sentry"]["user"]
    group node["sentry"]["group"]
    pidfile "/var/run/sentry-1.pid"
    config node["sentry"]["config"]
end

Definitions

You can create config for sentry need use definition sentry_conf:

sentry_conf "sentry" do
    user "sentry"
    group "sentry"
    virtualenv node["sentry"]["virtualenv"]
    # Settings file variables hash
    settings {}
end

Attributes

• name name or path to config file (if config attr not used)
• template config template file name
• user user that own application
• group gtoup that own application
• config path to config file
• settings hash of config variables

Resources

sentry_instance

To run sentry instance you can user sentry_instance resouce

Attribute parameters

• name instance name
• group launch by group
• user launch by user
• virtualenv: path to virtualenv
• config: path to config file
• pidfile: path to instance pidfile
• host: host for binding
• port: port for binging
• workers: number of workers
• provider: instance porvider (default: Chef::Provider::SentryBase)

Providers

sentry cookbook support 3 instance providers:

• Chef::Provider::SentryBase - simple provider, that create init.d script and spawn instance

• Chef::Provider::SentryRunit - provider, that spawn instance via runit

• Chef::Provider::SentrySupervisor - provider, that spawn instance via supervisord

Recipes

default

Base recipe to configure sentry user and group

instance

Recipe to install simple sentry instance.

See also

• Exceptional error aggregation