Dnsmasq Local Cookbook

Installs Dnsmasq with an opinionated default configuration geared toward
localhost-only improved DNS reliability.

Requirements

This cookbook currently supports both Debian-based and RHEL-based platforms.

It now requires Chef 12.10+, or Chef 12.1+ and the compat_resource cookbook.

Usage

Set the attributes you wish and add the default recipe to your run list, or
create a recipe of your own that implements the included Chef resources.

Recipes

default

Installs and configures Dnsmasq in an attribute-driven fashion.

Attributes

default

The config attribute hash defaults to empty and can be overridden with settings
to be rendered out to Dnsmasq's .conf file:

default['dnsmasq_local']['config'] = {}

Any option that contains a hyphen should be set as an attribute with an
underscore:

default['dnsmasq_local']['config']['cache_size'] = 300

Any option that is a boolean with no value can be set to true or false to be
enabled or disabled:

default['dnsmasq_local']['config']['proxy_dnssec'] = true

Any option that can have multiple entries can be set as either an array
(where all entries will be rendered in the config) or a hash (where entries
set to false will not be rendered):

default['dnsmasq_local']['config']['server'] = %w(8.8.8.8)

default['dnsmasq_local']['config']['server']['8.8.8.8'] = true

The options attribute hash defaults to empty and can be overridden with
command line options to run Dnsmasq with. The longform versions of switches
must be used, with the same underscore and boolean rules as for the config:

default['dnsmasq_local']['options']['bind_dynamic'] = true
default['dnsmasq_local']['options']['enable_dbus'] = 'com.example'

The environment attribute hash can be used for setting any other environment
variables that should populate the /etc/default/dnsmasq file:

default['dnsmasq_local']['environment']['IGNORE_RESOLVCONF'] = 'yes'

Resources

dnsmasq_local

A parent resource that combines an app + config + service resource.

Syntax:

dnsmasq_local 'default' do
  config(cache_size: 0)
  options(bind_dynamic: true)
  environment(IGNORE_RESOLVCONF: 'yes')
  action :create
end

Actions:

Properties:

dnsmasq_local_app

A resource for installation and removal of the Dnsmasq app packages.

Syntax:

dnsmasq_local_app 'default' do
  action :install
end

Actions:

Properties:

dnsmasq_local_config

A resource for generating Dnsmasq configurations.

Syntax:

dnsmasq_local_config 'default' do
  filename 'dns'
  config(cache_size: 100)
  no_hosts false
  server %w(8.8.8.8 8.8.4.4)
  interface(eth0: false, eth1: true)
  action :create
end

Actions:

Properties:

* A config property that is passed in will override the entirety of the
default config, whereas individual properties passed in will be merged with
it.

** Any unrecognized property that is passed in will be assumed to be a
correct Dnsmasq setting and rendered out to its config. These properties'
values can be true, false, integers, strings, arrays, or hashes.

dnsmasq_local_service

A resource for the managing the Dnsmasq service.

Syntax:

dnsmasq_local_service 'default' do
  options(bind_dynamic: true)
  enable_dbus 'com.example'
  environment(IGNORE_RESOLVCONF: 'yes')
  action [:create, :enable, :start]
end

Actions:

Properties:

* Command line options can be passed in either as one complete options hash,
or as individual property calls for each option.

Maintainers

• Jonathan Hartman jonathan.hartman@socrata.com