cookbook 'varnishd', '= 0.1.2'
varnishd (3) Versions 0.1.2 Follow1
Builds, installs, and configures Varnish and VMODs.
cookbook 'varnishd', '= 0.1.2', :supermarket
knife supermarket install varnishd
knife supermarket download varnishd
A Chef cookbook for installing and configuring Varnish, with some specific design constraints.
- Varnish and VMODs are installed from source.
- Every tunable parameter is exposed in the attributes.
- Services are managed by Upstart to provide straight-forward resource limits, respawing, and control.
- Carefully triggered and idempotent build/dependency chains to insure Chef runs cleanly in the event of errors.
Using test kitchen, this cookbook is tested against the following platforms.
- Ubuntu 12.04, Ubuntu 12.10, Ubuntu 13.04
It'd be reasonable to assume that Ubuntu versions more recent than 13.04 will work as well as Debian and older Ubuntu distributions that have Upstart configured.
varnishd::default to your node's run-list. If you do not want to setup the
varnishd daemon as a service, you may include
varnishd::vmods seperately instead.
It's important to note that the
:checksum attributes must always be modified together and are in no way automatically generated.
|[:varnishd][:version]||Complete Varnish version you are installing||'3.0.5'|
|[:varnishd][:url]||URL for an source archive of that version||'http://repo.varnish-cache.org/source/varnish-3.0.5.tar.gz'|
|[:varnishd][:checksum]||Checksum for that archive||'302fd6afc7…'|
|[:varnishd][:vcl_source]||Template to use to render the VCL||'default.vcl.erb'|
|[:varnishd][:vcl_cookbook]||Cookbook in which to find that template||'varnishd'|
|[:varnishd][:storage]||Storage type and options||'malloc,128M'|
|[:varnishd][:pid]||Write the daemon's PID to file||'/var/run/varnishd.pid'|
The mechanism for specifying a VCL template in a wrapping cookbook is the same as in the varnish cookbook.
VMODs to build and install can be specified as part of the
[:varnishd][:vmods] attribute. For example, to include boltsort.
node.set[:varnishd][:vmods][:boltsort][:repository] = 'https://github.com/vimeo/libvmod-boltsort.git' node.set[:varnishd][:vmods][:boltsort][:reference] = 'master'
:reference is optional, and if it is missing
master will be used by default.
Varnish Runtime Options
A key feature of this cookbook is providing access to every Varnish runtime option as described in the documentation. These options are listed out in the default attribute file like so.
default[:varnishd][:runtime][:http_max_hdr] = nil #'64'
For most values the default is
nil and the value that Varnish will use when the value is not provided is listed in end of line comment. Any value not set to nil will be passed to
varnishd when run using the
Please do! We'll follow the git-flow method, so please submit pull requests as feature branches.
|apt >= 0.0.0|
|build-essential >= 0.0.0|
|git >= 0.0.0|
There are no cookbooks that are contingent upon this one.