This commit makes the following changes to install/ubuntu-dev.rst:
- removes copying of all *.sample files since we end up overwriting
contents of several files anyway
- removes a number of inline comments to give clear separation between
information and commands
- adds a simple pools.yaml sample which should work out of the box on
most development deploys
- this file uses a name of "default", which means it will not
create a new pool but rather use the existing one (helpful as
designate.conf already references the existing pool's ID)
- uses a target of type "bind9", which matches the
backend in designate.conf
- uses an rncd_key_file that exists in /etc/bind
- adds the necessary section on how to import it into Designate
- adds some additional information about activating virtualenv before
attempting to start services in the virtualenv
- prefixes any command that requires root privileges with "sudo"
- updates examples/basic-config-sample.conf by removing reference to
defunct 'Pool Configuration' section
Please note that I am inexperienced with Designate so some of my
assumptions here may be incorrect.
Change-Id: I8e92a9c65e68a811696f2c77820a6d00ce576bb2
45 lines
1.3 KiB
YAML
45 lines
1.3 KiB
YAML
- name: default
|
|
# The name is immutable. There will be no option to change the name after
|
|
# creation and the only way will to change it will be to delete it
|
|
# (and all zones associated with it) and recreate it.
|
|
description: Default BIND9 Pool
|
|
|
|
attributes: {}
|
|
|
|
# List out the NS records for zones hosted within this pool
|
|
ns_records:
|
|
- hostname: ns1-1.example.org.
|
|
priority: 1
|
|
|
|
# List out the nameservers for this pool. These are the actual BIND servers.
|
|
# We use these to verify changes have propagated to all nameservers.
|
|
nameservers:
|
|
- host: 127.0.0.1
|
|
port: 53
|
|
|
|
# List out the targets for this pool. For BIND, most often, there will be one
|
|
# entry for each BIND server.
|
|
targets:
|
|
- type: bind9
|
|
description: BIND9 Server 1
|
|
|
|
# List out the designate-mdns servers from which BIND servers should
|
|
# request zone transfers (AXFRs) from.
|
|
masters:
|
|
- host: 127.0.0.1
|
|
port: 5354
|
|
|
|
# BIND Configuration options
|
|
options:
|
|
host: 127.0.0.1
|
|
port: 53
|
|
rndc_host: 127.0.0.1
|
|
rndc_port: 953
|
|
rndc_key_file: /etc/bind/rndc.key
|
|
|
|
# Optional list of additional IP/Port's for which designate-mdns will send
|
|
# DNS NOTIFY packets to
|
|
# also_notifies:
|
|
# - host: 192.0.2.4
|
|
# port: 53
|