bind_config

Creates the configuration files for the name server.

Actions

Action	Description
`:create`	Create the default configuration files (including RFC1912 zones), configure an rndc key, and set any query logging parameters required.

Properties

The query_log properties are deprecated and will be removed in a future version. Migrate to using the bind_logging_channel and bind_logging_category resources.

Name	Type	Default	Description
`additional_config_files`	Array	`[]`	Array of additional config files to include in `named.conf`
`bind_service`	String	`default`	Name of the `bind_service` resource to notify actions on
`chroot_dir`	String	see `default_property_for`	Define the chrooted base directory
`chroot`	`true`, `false`	`false`	Configuring a chrooted nameserver
`conf_file`	String	see `default_property_for`	The desired full path to the main configuration file
`controls`	Array	`[]`	Array of control statements
`default_view`	String	`default`	The name of the default view to configure zones within when views are used
`ipv6_listen`	`true`, `false`	`true`	Enables listening on IPv6 instances
`options`	Array	`[]`	Array of option strings. Each option should be a valid BIND option minus the trailing semicolon.
`options_file`	String	see `default_property_for`	The desired full path to the configuration file containing options
`per_view_additional_config_file`	Array	`[]`	Array of additional per view config files to include in named.conf
`statistics_channel`	Hash, Array	`nil`	Presence turns on the statistics channel. Should be a hash containing `:address` and `:port` to configure the location where the statistics channel will listen on. This will likely move to a separate resource in the future.
`primaries`	Hash	`{}`	List of name servers for which the server is secondary to, in the format `name => %w(list of ips)`. Can be referred to abbreviate `primaries` or `also-notify` in zones.

The following properties are deprecated and will be removed in a future release of this cookbook:

Name	Type	Default	Description
`query_log_max_size`	String	`1m`	Maximum size of query log before rotation
`query_log_options`	Array	`[]`	Array of additional query log options
`query_log`	String	`nil`	If provided will turn on general query logging. Should be the path to the desired log file
`query_log_versions`	String, Integer	`2`	Number of rotated query logs to keep on the system

Examples

bind_config 'default'
 
bind_config 'default' do
  ipv6_listen false
 
  options [
    'recursion no',
    'allow-transfer { external-dns; }'
  ]
end
 
bind_config 'default' do
  statistics_channel address: 127.0.0.1, port: 8090
 
  query_log '/var/log/named/query.log'
  query_log_versions 5
  query_log_max_size '10m'
  query_log_options [
    'print-time yes'
  ]
end

Bind Acl Bind Forward Zone