Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

dnsmasq-local (9) Versions 0.5.0

Configures a local-only dnsmasq

Berkshelf/Librarian
Policyfile
Knife
cookbook 'dnsmasq-local', '= 0.5.0'
cookbook 'dnsmasq-local', '= 0.5.0', :supermarket
knife cookbook site install dnsmasq-local
knife cookbook site download dnsmasq-local
README
Dependencies
Changelog
Quality 50%

Dnsmasq Local Cookbook

Cookbook Version Build Status Code Climate Coverage Status

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

Requirements

This cookbook currently supports Ubuntu only.

At least for the time being, it supports Chef 11+, at the expense of some additional complexity to maintain backwards compatibility.

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

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

Any key+value can be set under this namespace and it will be merged into the default Dnsmasq config.

Any config key that contains a hyphen (e.g. cache-size) should be set in attributes with an underscore (e.g. cache_size).

Any Dnsmasq setting that is a boolean key with no value (e.g. proxy_dnssec) can be set to true or false to be enabled or disabled, respectively.

Any setting 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'] = {}

Any key+value can be set under this namespace and it will be merged into the default Dnsmasq environment variables. Keys will be automatically upcased before being rendered into the final service config.

Resources

dnsmasq_local

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

Syntax:

dnsmasq_local 'default' do
  config(cache_size: 0)
  environment(dnsmasq_opts: '--bind-dynamic')
  action :create
end

Actions:

Action Description
:create Install, configure, and enable+start Dnsmasq
:remove Stop+disable and remove Dnsmasq

Attributes:

Attribute Default Description
config nil A Dnsmasq configuration hash
environment nil A Dnsmasq environment variable hash
action :create Action(s) to perform

dnsmasq_local_app

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

Syntax:

dnsmasq_local_app 'default' do
  action :install
end

Actions:

Action Description
:install Install the Dnsmasq package
:remove Uninstall the Dnsmasq package

Attributes:

Attribute Default Description
action :install Action(s) to perform

dnsmasq_local_config

A resource for generating Dnsmasq configurations.

Syntax:

dnsmasq_local_config 'default' do
  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:

Action Description
:create Write out the Dnsmasq config file
:remove Delete the Dnsmasq config file

Attributes:

Attribute Default Description
config See below A complete config hash *
interface '' Listen only on the loopback interface
cache_size 0 Disable caching
no_hosts true Do not DNSify /etc/hosts
bind_interfaces true Bind only to listening interfaces
proxy_dnssec true Proxy DNSSEC, when available
query_port 0 Use a static, ephemeral return port
** nil Varies
action :create Action(s) to perform

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

** Any unrecognized attribute that is passed in will be assumed to be a correct Dnsmasq setting and rendered out to its config. These attributes' 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
  environment(config_dir: '/tmp/dnsmasq')
  dnsmasq_opts '--bind-dynamic'
  action [:enable, :start]
end

Actions:

Action Description
:enable Enable the service
:disable Disable the service
:start Start the service
:stop Stop the service
:restart Restart the service

Attributes:

Attribute Default Description
environment See below A complete environment hash *
config_dir '/etc/dnsmasq.d...' Point at Dnsmasq's .d dir
enabled 1 Enable Dnsmasq
** nil Varies
action [:enable, :start] Action(s) to perform

* An environment attribute that is passed in will override the entirety of the default environment, whereas individual attributes passed in will be merged with it.

** Any unrecognized attribute that is passed in will be assumed to be a valid Dnsmasq environment variable and rendered out to its service definition.

Providers

Chef::Provider::DnsmasqLocal

Provider that wraps each of the Dnsmasq component resources.

Chef::Provider::DnsmasqLocalApp

Provider for managing the Dnsmasq app packages.

Chef::Provider::DnsmasqLocalService

Provider for managing Dnsmasq config files.

Chef::Provider::DnsmasqLocalService

Provider for managing the Dnsmasq service.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Add tests for the new feature; ensure they pass (rake)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request

License & Authors

Copyright 2016, Socrata, 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.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

bastion Applicable Versions

Dnsmasq Local Cookbook CHANGELOG

v0.5.0 (2016-07-26)

  • Support hashes as config properties

v0.4.0 (2016-06-24)

  • Take over management of the Dnsmasq environment variables
  • Add a warning comment to all Chef-managed config files

v0.3.0 (2016-05-26)

  • Fix custom config properties/attributes under Chef 11
  • Support arrays for config attributes with >1 value (e.g. "server")

v0.2.0 (2016-05-18)

  • Ensure the APT cache is up to date before installing
  • Refactor config merging to avoid attribute collision warnings

v0.1.0 (2016-05-06)

  • Initial release!

v0.0.1 (2016-04-25)

  • Development started

Collaborator Number Metric
            

0.5.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Foodcritic Metric
            

0.5.0 passed this metric