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 the file should be in files/default/, 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.


:createCreates a BIND primary zone
:create_if_missingCreates a BIND primary zone, only if it's missing
:create_config_onlyCreates the BIND config entry only and does not try to manage the file at all


bind_configStringdefaultName of the bind_config resource to notify actions on
file_nameStringname propertyName of the file to store the zone in. Used when you wish to have the same zone with different content in different views.
optionsArray[]Array of option strings. Each option should be a valid BIND option minus the trailing semicolon.
viewStringDefaults to the value from the bind_config propertyName of the view to configure the zone in
zone_nameStringThe zone name of the zone. Used only if the name property does not match the zone name.
source_fileStringFilename to source the zonefile from. Passed to source property of cookbook_file


# to load zone from files/
bind_primary_zone ''
# or from custom file
bind_primary_zone '' do
  source_file ''
Was this helpful?