Refresh doc for buster

This commit is contained in:
Baptiste Jonglez 2020-07-25 11:23:16 +02:00
parent 3f225e7ec7
commit 215507e048
2 changed files with 23 additions and 20 deletions

View File

@ -1,6 +1,7 @@
# Ansible role for NSD # Ansible role for NSD
This Ansible role installs and configure NSD, an authoritative DNS server. This Ansible role installs and configure NSD, an authoritative DNS server.
It also allows to publish DNS zones into NSD.
## Features ## Features
@ -61,12 +62,10 @@ Note that in this setup, it is your responsibility to configure the master appro
## Requirements ## Requirements
This role has been tested on Debian (wheezy, jessie, stretch), but could be adapted This role has been tested on Debian (wheezy, jessie, stretch, buster), but could be adapted
to work on other systems. Notably, this role does not setup `nsd-control` because to work on other systems. Notably, this role does not setup `nsd-control` because
this is already done automatically by the Debian package. this is already done automatically by the Debian package.
By default, NSD4 is assumed, you will need additional configuration for NSD3 (wheezy).
## Role variables ## Role variables
This documents all role variables that you can set in your playbooks. See the end This documents all role variables that you can set in your playbooks. See the end
@ -180,21 +179,6 @@ Directory where the zone files will be copied by this role.
Directory where slave zone files will be placed by NSD after zone transfer. Directory where slave zone files will be placed by NSD after zone transfer.
### Configuration for NSD3
For NSD3 on Debian an appropriate configuration would be:
nsd_version: 3
nsd_service_name: "nsd3"
nsd_pkg_name: "nsd3"
nsd_control_program: "/usr/sbin/nsdc"
nsd_config_dir: "/etc/nsd3"
nsd_zones_config_file: "/etc/nsd3/zones.conf"
nsd_primary_zones_dir: "/etc/nsd3/primary"
nsd_secondary_zones_dir: "/etc/nsd3/secondary"
This could be placed in a `group_vars/wheezy.yml` file or equivalent.
## Example playbook ## Example playbook
This is a complete example playbook with several TSIG keys and several DNS zones: This is a complete example playbook with several TSIG keys and several DNS zones:
@ -252,6 +236,22 @@ the root of your ansible directory:
$TTL 3h $TTL 3h
@ IN SOA ns1 root.example.org. (2017090101 1d 2h 4w 1h) @ IN SOA ns1 root.example.org. (2017090101 1d 2h 4w 1h)
## Example advanced configuration
If you need more advanced customization, you can use the advanced
variables. For instance, to support NSD3 on Debian wheezy, the
appropriate configuration was:
nsd_version: 3
nsd_service_name: "nsd3"
nsd_pkg_name: "nsd3"
nsd_control_program: "/usr/sbin/nsdc"
nsd_config_dir: "/etc/nsd3"
nsd_zones_config_file: "/etc/nsd3/zones.conf"
nsd_primary_zones_dir: "/etc/nsd3/primary"
nsd_secondary_zones_dir: "/etc/nsd3/secondary"
This could be placed in a `group_vars/wheezy.yml` file or equivalent.
## Limitations ## Limitations

View File

@ -1,12 +1,15 @@
galaxy_info: galaxy_info:
author: Baptiste Jonglez author: Baptiste Jonglez
description: Ansible role to configure NSD on Debian description: Configure NSD and DNS zones on Debian
license: MIT license: MIT
min_ansible_version: 1.7 min_ansible_version: 1.7
platforms: platforms:
- name: Debian - name: Debian
versions: versions:
- all - wheezy
- jessie
- stretch
- buster
galaxy_tags: galaxy_tags:
- nsd - nsd
- dns - dns