Caching

Install and manage different caching applications. By now, the following backends are supported:

• memcached

• Varnish

memcached

To install memcached, add memcached to the caching::backend hash.

Memory Ratio

By default, a memory_ratio of 8 is used, which means memcached will take up to 1/8 of this servers total memory.

address

By default, memcached will listen on the localhost interface. If memcached has to bind to another address, use the address parameter to specify it.

port

By default, memcached will listen on port 11211. If memcached has to bind to another port, use the port parameter to specify it.

Full example

{
  "caching::backend": {
    "memcached": {
      "ensure": "present",
      "memory_ratio": "8",
      "address": "127.0.0.1",
      "port": "11211"
    }
  }
}

Varnish

To install Varnish, add varnish to the caching::backend hash.

address/address6

By default, Varnish will listen on the eth1 interface. If Varnish has to bind to other addresses, use the address and address6 parameter to specify them.

port/port6

By default, Varnish will listen on port 80. If Varnish has to bind to another port, use the port and port6 parameter to specify them.

vcl_type

With vcl_type, you choose a tempalte which is used by Varnish as default VCL configuration. By now, the following types are available:

• default: Varnish default configuration which does not very much but is perfetly suitable for your own, custom configuration trough vcl_include

• typo3: Varnish configuration for the varnish TYPO3 extension

vcl_include

With vcl_include, you can define a full path to a additional configuration file. This file gets included into the Varnish default configuration.

Hint

keep in mind to issue a puppet-agent run after changing the local Varnish configuration. Puppet will copy your local configuration file to a global location and ensure that Varnish is able to read it

Memory Ratio

By default, a memory_ratio of 2 is used, which means Varnish will take up to 50% of this servers total memory.

daemon_options

Add one or more startup options to the Varnish daemon with daemon_options.

Warning

changing this value can led to unintended consequences. Please make sure to plan any changes carefully and ask us for advice if you’re in doubt

Full example

{
  "caching::backend": {
    "varnish": {
      "ensure": "present",
      "address": "185.17.68.153",
      "port": "80",
      "address6": "2a04:503:0:1003::153",
      "port6": "80",
      "vcl_type": "default",
      "vcl_include": "/home/user/cnf/varnish.vcl",
      "memory_ratio": "4"
    }
  },
  "caching::wrapper::varnish::daemon_options": "-p vcc_allow_inline_c=on"
}