system-config/doc/source/dns.rst
James E. Blair 06f322b629 Update DNS documentation
This reflects the new ansible-only opendev dns servers.

Change-Id: I26bda9f6618f8af49a7dfb61981af8640582b7cf
2019-01-28 09:58:02 -08:00

1.1 KiB

title

DNS

DNS

The project runs authoritative DNS servers for any constituent projects that wish to use them. The servers run Bind on a hidden master which handles automatic DNSSEC zone signing while the public authoritative servers run NSD.

At a Glance

Hosts
  • ns1.opendev.org
  • ns2.opendev.org
Ansible
Projects

Adding a Zone

To add a new zone, identify an existing git repository or create a new one to hold the contents of the zone, then update :cgit_file:`playbooks/group_vars/dns.yaml`.

Run:

dnssec-keygen -a RSASHA256 -b 2048 -3 example.net
dnssec-keygen -a RSASHA256 -b 2048 -3 -fk example.net

And add the resulting files to the dnssec_keys key in the group/adns.yaml private hostvars file on puppetmaster.

If you need to generate DS records for the registrar, identify which of the just-created key files is the key-signing key by examining the contents of the files and reading the comments therein, then run:

dnssec-dsfromkey -2 $KEYFILE