bind_primary_zone.md

bind_primary_zone

Back to resource list

This resource will copy a zone file from your current cookbook into the correct directory and add the zone as a master zone to your BIND configuration. The file should be named for the zone you wish to configure. For example to configure example.com the file should be in files/default/example.com, or set manually with source_file.

This resource also supports setting the action to :create_if_missing. In this event the cookbook will only copy a zone file in place if it does not already exist. Once copied the cookbook will not touch the file again allowing it to be used for dynamic updates. However, please be aware that in the event of the server being rebuilt or the file being removed that the data has not been persisted anywhere.

If the zone file is managed completely externally, :create_config_only will not manage the file at all and only create the zone entry in the BIND config.

Actions

Action	Description
:create	Creates a BIND primary zone
:create_if_missing	Creates a BIND primary zone, only if it's missing
:create_config_only	Creates the BIND config entry only and does not try to manage the file at all

Properties

Name	Type	Default	Description
bind_config	String	default	Name of the bind_config resource to notify actions on
file_name	String	name property	Name of the file to store the zone in. Used when you wish to have the same zone with different content in different views.
options	Array	[]	Array of option strings. Each option should be a valid BIND option minus the trailing semicolon.
view	String	Defaults to the value from the bind_config property	Name of the view to configure the zone in
zone_name	String		The zone name of the zone. Used only if the name property does not match the zone name.
source_file	String		Filename to source the zonefile from. Passed to source property of cookbook_file

Examples

# to load zone from files/db.example.org
bind_primary_zone 'example.org'

# or from custom file
bind_primary_zone 'example.org' do
  source_file 'other-example.org'
end