cookbook 'unicorn', '= 2.1.1'
The unicorn cookbook has been deprecated
Author provided reason for deprecation:
The unicorn cookbook has been deprecated and is no longer being maintained by its authors. Use of the unicorn cookbook is no longer recommended.
unicorn (12) Versions 2.1.1 Follow42
Installs and configures unicorn
cookbook 'unicorn', '= 2.1.1', :supermarket
knife supermarket install unicorn
knife supermarket download unicorn
unicorn Cookbook
Installs and configures unicorn, and provides a definition to manage configuration file for Rack apps running under unicorn.
Requirements
Platforms
- Any platform the supports the unicorn gem
Chef
- Chef 11+
Cookbooks
- none
Definitions
unicorn_config
The unicorn_config definition manages the configuration template for an application running under unicorn.
Parameters:
-
listen- Default is nil. -
working_directory- Default is nil. -
worker_timeout- Default is 60. -
preload_app- Default is false. -
worker_processes- Number of worker processes to spawn. Default is - 4.
-
unicorn_command_line- If set, specifies the unicorn commandline to set - in the config file. Usefull when sandboxing your unicorn installation.
-
forked_user- User to run children as. Default is nil. -
forked_group- Group to run children as. You must specify aforked_user - as well to use this attribute. Default is nil.
-
before_exec- Default is nil. -
before_fork- Default is nil. -
after_fork- Default is nil. -
pid- Pidfile location. Default is nil. -
stderr_path- Where stderr gets logged. Default is nil. -
stdout_path- Where stdout gets logged. Default is nil. -
notifies- How to notify another service if specified. Default is nil. -
owner- Owner of the template. Default is nil. -
group- group of the template. Default is nil. -
mode- mode of the template. Default is nil. -
unicorn_command_line- Specify the command-line for the unicorn - binary as a string. Populates
Unicorn::HttpServer::START_CTX[0]. - Default is nil.
-
copy_on_write- Whether the app should take advantage of REE Copy - On Write feature. Default is false.
-
enable_stats- Whether the app should have GC profiling enabled - for instrumentation. Default is false.
For more information on copy_on_write and enable_stats, see:
- http://www.rubyenterpriseedition.com/faq.html#adapt_apps_for_cow
- https://newrelic.com/docs/ruby/ruby-gc-instrumentation
Respectively.
Examples:
Setting some custom attributes in a recipe (this is from Chef's application::unicorn.
node.default[:unicorn][:worker_timeout] = 60 node.default[:unicorn][:preload_app] = false node.default[:unicorn][:worker_processes] = [node[:cpu][:total].to_i * 4, 8].min node.default[:unicorn][:preload_app] = false node.default[:unicorn][:before_fork] = 'sleep 1' node.default[:unicorn][:port] = '8080' node.set[:unicorn][:options] = { :tcp_nodelay => true, :backlog => 100 } unicorn_config "/etc/unicorn/#{app['id']}.rb" do listen({ node[:unicorn][:port] => node[:unicorn][:options] }) working_directory ::File.join(app['deploy_to'], 'current') worker_timeout node[:unicorn][:worker_timeout] preload_app node[:unicorn][:preload_app] worker_processes node[:unicorn][:worker_processes] before_fork node[:unicorn][:before_fork] end
License & Authors
Author: Cookbook Engineering Team (cookbooks@chef.io)
Copyright: 2008-2015, Chef Software, 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.
unicorn Cookbook CHANGELOG
This file is used to list changes made in each version of the unicorn cookbook.
v2.1.1 (12-14-2015):
- Added a Rakefile for simplified testing
- Added the standard chef .rubocop.yml file and a rubocop_todo.yml file
- Updated the development dependencies in the Gemfile
- Updated contributing and testing docs
- Updated the URLs in the readme for the chef-cookbooks org
- Added maintainers.md and rake task for generating the file from maintainer.toml
- Updated Travis to test using chef-dk
v2.1.0 (09-08-2015):
- Include build-essential in the default recipe to that the necessary build tools will be in place to compile native gem deps for the unicorn gem
- Add testing with Kitchen CI config, basic convergence Chefspec, Travis CI config
- Add rubocop config and resolve warnings
- Add a gitignore, chefignore, Berksfile, and Gemfile to the repo
- Add source_url and issues_url to the metadata
- Better define chef / platform requirements in the readme and add common platforms to the metadata file
- Add testing and cookbook version badges to the readme
- Update all Opscode references to Chef Software
v2.0.0:
- #9 Removes transform to allow for using node attributes for params.
v1.3.0:
Improvement
- [COOK-2470]: Add "user" directive support to Unicorn cookbook
v1.2.2:
- [COOK-2442] - Template uses an ActiveSupport method
v1.2.0:
- [COOK-2229] - Allow specification of unicorn command line in config file
- [COOK-2349] - Add option to include cow and GC stats
- [COOK-2354] - if no listen options are provided for a port, a
- trailing comma is left which causes unicorn to crash
v1.1.0:
- [COOK-857] - Unicorn not quoting listener ports/sockets
- [COOK-1273] - add ability to specify before_exec block
v1.0.0:
- Current public release.
Foodcritic Metric
2.1.1 failed this metric
FC015: Consider converting definition to a LWRP: /tmp/cook/8b86900c6ab6122592ae0cd5/unicorn/definitions/unicorn_config.rb:1
2.1.1 failed this metric
