Varnish

Table of Contents

1. Overview
2. Setup - The basics of getting started with varnish
   • What varnish affects
   • Setup requirements
   • Beginning with varnish
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Overview

Installs, configures and runs the Varnish and VarnishNCSA services.

Setup

This module installs varnish from whatever repository you have configured on your system already. To be clear: this module does not attempt to install a package repository for you.

To install, simply run:

puppet module install finalsite-varnish

What varnish affects

• Varnish Package
• Varnish & Varnishncsa services
• /etc/varnish/default.vcl
• /etc/varnish/varnish.params
• /etc/varnish/secret
• /etc/systemd/system/varnishncsa.service
• /etc/sysconfig/varnishncsa

Setup Requirements

Required Puppet Modules:

• ripienaar/module_data
• puppetlabs/stdlib

Beginning with Varnish

As puppet classes

  class { 'varnish::config':
    package_ensure  => '4.1.3-1.el7',
    service_manage  => false,
    vcl_template    => 'mymodule/my_default_vcl.erb',
    vcl_config_file => '/etc/varnish/myconfig.vcl',
    listen_address  => $::ipaddress_eth0,
    listen_port     => 8080,
    storage_spec    => malloc,80%,
    parameters      => { min_threads => 50, max_threads => 1000, thread_timeout => 300 },
    runtime_options => [
      '-j unix:varnish',
      '-t 120'
    ]
  }

or using hiera yaml files:

---
classes:
  - varnish

varnish::config::package_ensure: '4.1.3-1.el7'
varnish::config::service_manage: false
varnish::config::vcl_template: 'mymodule/my_default_vcl.erb'
varnish::config::vcl_config_file: '/etc/varnish/myconfig.vcl'
varnish::config::listen_address: '%{::ipaddress_eth0}'
varnish::config::listen_port: 8080
varnish::config::storage_spec: 'malloc,80%'
varnish::config::parameters:
  min_threads: 50
  max_threads: 1000
  thread_timeout: 300
varnish::config::runtime_options:
  - '-j unix:varnish'
  - '-t 120'

Storage Specifications

The storage_spec parameter is normalized prior to being included in the final configuration, with percentage based sizes converted for malloc, file and persistent storage backend types.

This varnish modules provides additional facter facts to facilitate this for file based storage backends. These facts are based on the existing mount points on your system for filesystem types including ext[234], btrfs, xfs, reiser4, and zfs. If the filesystem you're backing varnish with isn't included in that list, then this won't work for you.

If you are using malloc, percentages will be based on the total available capacity of the server as reported by the memorysize_mb fact. If you are using file, or persistent storage backends and you provide a size, then the facts provided by this module will be used to determine the capacity of the path, and whether or not there is sufficient space for the requested size you provided.

Usage

All parameters are optional, but at minimum it is suggested you set a secret.

Limitations

Tested and verified working on CentOS 7 only.

Development

• Always run bundle install and bundle exec rake spec

• Always create tests for functionality changes or additions

• Squash all commits prior to submitting Pull Requests

• Install rabbitt-githooks and attach them to your fork.

  # if you've run bundle install, then this is unnecessary
  gem install rabbitt-githooks
  
  # run this from the root of the varnish module directory
  githooks attach -p .githooks