cookbook 'unicorn-ng', '= 0.1.0'
unicorn-ng (10) Versions 0.1.0 Follow2
Installs/Configures unicorn
cookbook 'unicorn-ng', '= 0.1.0', :supermarket
knife supermarket install unicorn-ng
knife supermarket download unicorn-ng
unicorn-ng Cookbook
Manage your unicorn application server with this cookbook.
This cookbook provides a decent initscript for Debian/Ubuntu, as well as takes care of the unicorn configuration.
Features
- Provides a decent initscript for Debian/Ubuntu
- Automatically takes care of ActiveRecord connections (if ActiveRecord is used)
- Hightly configureable for your needs
- Use either a system-wide installed unicorn, or one that gets deployed with your application
Requirements
An installed unicorn. Alterantively you can use the install recipe to install it using rubygems.
Furthermore you need to add the following line to your metadata.rb
depends 'unicorn-ng'
Attributes
Configuration
Everything in your unicorn.rb can be maintained using attributes.
Consider using the provides LWRPs (see below)
Most importantly, you need to specify the path to your unicorn.rb.
If this is not specified, the default recipe will do nothing.
default['unicorn-ng']['config']['config_file'] = '/var/www/examples.com/config/unicorn.rb'
This section describes the supported attributes, as well as their default settings.
default['unicorn-ng']['config']['worker_processes'] = 1 default['unicorn-ng']['config']['listen'] = 8080 default['unicorn-ng']['config']['backlog'] = nil default['unicorn-ng']['config']['pid'] = 'tmp/pids/unicorn.pid' default['unicorn-ng']['config']['timeout'] = 60 default['unicorn-ng']['config']['stderr_path'] = 'log/unicorn.stderr.log' default['unicorn-ng']['config']['stdout_path'] = 'log/unicorn.stdout.log' default['unicorn-ng']['config']['preload_app'] = true # When sent a USR2, Unicorn will suffix its pidfile with .oldbin and # immediately start loading up a new version of itself (loaded with a new # version of our app). When this new Unicorn is completely loaded # it will begin spawning workers. The first worker spawned will check to # see if an .oldbin pidfile exists. If so, this means we've just booted up # a new Unicorn and need to tell the old one that it can now die. To do so # we send it a QUIT. # # Using this method we get 0 downtime deploys. # # Stolen from: https://github.com/blog/517-unicorn default['unicorn-ng']['config']['before_fork'] = <<-EOS old_pid = '#{node['unicorn-ng']['config']['pid']}.oldbin' if File.exists?(old_pid) and server.pid != old_pid begin Process.kill('QUIT', File.read(old_pid).to_i) rescue Errno::ENOENT, Errno::ESRCH # someone else did our job for us end end if defined?(ActiveRecord::Base) ActiveRecord::Base.connection_handler.clear_all_connections! end EOS default['unicorn-ng']['config']['after_fork'] = <<-EOS if defined?(ActiveRecord::Base) ActiveRecord::Base.connection_handler.verify_active_connections! end EOS
Furthermore, you can define more advanced settings, if needed
default['unicorn-ng']['config']['owner'] = 'root' default['unicorn-ng']['config']['group'] = 'root' default['unicorn-ng']['config']['mode'] = 00644 default['unicorn-ng']['config']['cookbook'] = 'unicorn-ng' default['unicorn-ng']['config']['source'] = 'unicorn.rb.erb' default['unicorn-ng']['config']['variables'] = {}
Service
This cookbook can set up unicorn so it gets properly started at boot time.
Analogue to the configuration, you need to specify the path to your rails application.
If this is not specified, the default recipe will do nothing.
default['unicorn-ng']['service']['rails_root'] = '/var/www/example.com'
The following attributes will be set automatically relative to the rails_root, if not specified.
default['unicorn-ng']['service']['unicorn_config'] = nil default['unicorn-ng']['service']['bundle_gemfile'] = nil default['unicorn-ng']['service']['pidfile'] = nil
If you need a different bundler (e.g. a wrapper from rvm), you can specify it here
default['unicorn-ng']['service']['bundle'] = '/usr/local/bin/bundle'
The RAILS_ENV. Set this to 'production' in your production environment
default['unicorn-ng']['service']['environment'] = 'development'
The user unicorn runs at. NOTE: THIS SHOULD BE CHANGED TO AN UNPRIVILEDGED USER
default['unicorn-ng']['service']['user'] = 'root' # CHANGE ME! (e.g. 'www-data')
The locale (set by the initscript)
default['unicorn-ng']['service']['locale'] = 'en_US.UTF-8'
The path where the initscript will be deployed
default['unicorn-ng']['service']['path'] = '/etc/init.d/unicorn'
Additional options for the initscript (if required)
default['unicorn-ng']['service']['owner'] = 'root' default['unicorn-ng']['service']['group'] = 'root' default['unicorn-ng']['service']['mode'] = 00755 default['unicorn-ng']['service']['cookbook'] = 'unicorn-ng' default['unicorn-ng']['service']['source'] = 'unicorn.init.erb' default['unicorn-ng']['service']['variables'] = {}
Recipes
default
Configures unicorn.rb configuration, as well as the unicorn initscript according to the attributes above.
Unless you specify at least one of the following attributes, this recipe will do nothing.
default['unicorn-ng']['config']['config_file'] # path to your unicorn.rb (will configure unicorn.rb) default['unicorn-ng']['service']['rails_root'] # path to your rails_root (will configure the unicorn service)
install
Installs bundler and unicorn using the systems "rubygems".
Consider installing a more recent environment using tools like rvm.
Provider
unicorn_ng_config
Configures unicorn.rb.
This LWRP uses the given attributes (see above) as defaults, if not specified otherwise.
Example:
unicorn_ng_config '/var/www/example.com/shared/config/unicorn.rb'
Or, a more complex setup:
unicorn_ng_config '/var/www/example.com/shared/config/unicorn.rb' do worker_processes 16 if node.chef_environment == 'production' worker_processes 6 if node.chef_environment == 'staging' worker_processes 2 if node.chef_environment == 'development' case node.chef_environment when 'production', 'staging' # We may be started by root, thus dropping privileges user 'deploy' working_directory '/var/www/example.com/current' # Listen on UNIX domain socket only # Shorter backlog for quicker failover when busy listen 'unix:tmp/sockets/unicorn.sock' backlog 1024 when 'development' listen 8080 end # Kill workers after 30 seconds on production timeout (node.chef_environment == 'production' ? 30 : 60) end
unicorn_ng_service
Deploys and configures unicorn initscript.
This LWRP uses the given attributes (see above) as defaults, if not specified otherwise.
Example:
unicorn_ng_service '/var/www/example.com/current'
In case you e.g. want to use the unicorn bundled with your configuration, you may set up a rvm wrapper for bundler
Using fnichol-rvm:
rvm_wrapper 'init' do binary 'bundle' ruby_string 'ruby-2.0.0@myapp' end
Or do it manually
rvm wrapper ruby-2.0.0@myapp init bundler
The initscript then uses this bundler to call unicorn with
bundle exec unicorn [ARGS]
Then tell the service to use your custom bundler:
unicorn_ng_service '/var/www/example.com/current' do environment node.chef_environment user 'deploy' # use a custom bundle-environment bundle '/usr/local/rvm/bin/init_bundle' end
Contributing
Contributions are very welcome!
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write you change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
License and Authors
Authors: Chris Aumann me@chr4.org
License: GPLv3
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.