dubzland.openstack.openstack_designate role – Install and configure the OpenStack Designate DNSaaS component.

Note

This role is part of the dubzland.openstack collection (version 1.1.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install dubzland.openstack.

To use it in a playbook, specify: dubzland.openstack.openstack_designate.

Entry point main – Install and configure the OpenStack Designate DNSaaS component.

Synopsis

  • Creates databases and configures users

  • Creates OpenStack services and associated users

  • Creates OpenStack endpoints within OpenStack Keystone

  • Installs required operating system packages

  • Applies desired configuration using templates

Parameters

Parameter

Comments

openstack_designate_db_name

string

Name of the MySQL database created.

Default: "designate"

openstack_designate_db_password

string / required

Database password created for the openstack_designate_db_user.

openstack_designate_db_user

string

Database user created for the OpenStack Designate component.

Default: "designate"

openstack_designate_packages

list / elements=string

List of packages installed on the controller node for the Designate component.

Default: ["bind9utils", "bind9-doc", "designate", "python3-designate-dashboard", "designate-mdns", "designate-producer", "designate-worker"]

openstack_designate_pools

list / elements=dictionary / required

List of backend Bind9 server pools to handle actual DNS services.

attributes

dictionary

Free-form attributes to associate with this pool. Can be specified when creating a zone to control which pool to serve a given zone.

Default: {}

description

string / required

Human-readable description for this pool.

name

string / required

Name for this pool within the OpenStack cloud.

nameservers

list / elements=dictionary / required

List of nameservers to be checked when zone updates are applied.

host

string / required

IP address of the server running the Bind9 DNS service.

port

integer

Port the Bind9 server is listening on.

Default: 53

ns_records

list / elements=dictionary

NS record to create in Designate managed zones.

hostname

string / required

Hostname to assign to the NS record.

priority

integer

Priority to assign to the NS record.

Default: 1

targets

list / elements=dictionary

designate-mdns to Bind9 pairings for this pool.

description

string / required

Human readable description for this Bind9 target.

masters

list / elements=dictionary

List of designate-mdns servers that Bind9 masters should request updates from.

host

string / required

Address (IP/Hostname) of the actual designate-mdns server.

port

integer

Port the (designate-mdns) server is listening on for zone transfers.

Default: 5354

options

dictionary

Options to apply to servers within this target pool.

host

string / required

Hostname/IP address of the actual Bind9 master server.

port

integer / required

Port the master server is listing on for queries.

rndc_host

string / required

Hostname/IP address the Bind9 server is bound to for rndc updates.

rndc_key_file

string / required

File containing the rndc key used to secure communications with the Bind9 server.

rndc_port

integer / required

Port the Bind9 server is listening on for rndc updates.

type

string / required

Type of DNS backend being configured. Currently only bind9 is supported.

Choices:

  • "bind9"

openstack_designate_rndc_keys

list / elements=dictionary / required

RNDC keys used to communicate with the backend Bind9 servers.

algorithm

string / required

TSIG algorithm used to generate the rndc key.

name

string / required

Name to associate with this rndc key.

secret

string / required

Actual rndc key value.

openstack_designate_service_description

string

Human-readable description for the OpenStack Designate service within Keystone.

Default: "OpenStack DNS"

openstack_designate_service_password

string / required

Service password assigned to the openstack_designate_service_user.

openstack_designate_service_user

string

User created in OpenStack Keystone for the Designate component.

Default: "designate"

openstack_designate_services

list / elements=string

Services to be restarted during install (and/or configuration changes) on the controller node.

Default: ["designate-central", "designate-api", "designate-worker", "designate-producer", "designate-mdns", "apache2"]