Files
designate/doc/source/admin/backends/bind9.rst
Omer 7ac4889a04 Add pools.yaml attributes docs section
This patch adds a pools.yaml file attributes docs section.

The attributes section should extend the comments that appear on the
pools.yaml draft.

Closes-Bug: #2063842
Change-Id: I4a38c24147eb396a91577e662d3016698fd8289d
2025-01-28 16:58:34 +00:00

1.9 KiB

Bind9 Backend

This page documents using the Bind 9 backend. The backend uses the rndc utility to create and delete zones remotely.

The traffic between rndc and Bind is authenticated with a key.

Designate Configuration

Example configuration required for Bind9 operation. One section for each pool target

sample_yaml_snippets/bind.yaml

The key and config files are relative to the host running Designate (and can be different from the hosts running Bind)

Then update the pools in designate - see designate_manage_pool for further details on the designate-manage pool command

$ designate-manage pool update

Bind9 Configuration

Ensure Bind can access the /etc/bind/rndc.conf and /etc/bind/rndc.key files and receive rndc traffic from Designate.

Enable rndc addzone/delzone functionality by editing named.conf.options or named.conf and add this line under options

allow-new-zones yes;

Example configuration of /etc/bind/rndc.key

key "rndc-key" {
    algorithm hmac-md5;
    secret "<b64-encoded string>";
};