From 215507e048ed52a971189c913111dca6bb072e74 Mon Sep 17 00:00:00 2001 From: Baptiste Jonglez Date: Sat, 25 Jul 2020 11:23:16 +0200 Subject: [PATCH] Refresh doc for buster --- README.md | 36 ++++++++++++++++++------------------ meta/main.yml | 7 +++++-- 2 files changed, 23 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index bcd4e13..6d091ad 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ # Ansible role for NSD This Ansible role installs and configure NSD, an authoritative DNS server. +It also allows to publish DNS zones into NSD. ## Features @@ -61,12 +62,10 @@ Note that in this setup, it is your responsibility to configure the master appro ## 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 this is already done automatically by the Debian package. -By default, NSD4 is assumed, you will need additional configuration for NSD3 (wheezy). - ## Role variables 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. -### 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 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 @ 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 diff --git a/meta/main.yml b/meta/main.yml index cd0e806..bdb1f79 100644 --- a/meta/main.yml +++ b/meta/main.yml @@ -1,12 +1,15 @@ galaxy_info: author: Baptiste Jonglez - description: Ansible role to configure NSD on Debian + description: Configure NSD and DNS zones on Debian license: MIT min_ansible_version: 1.7 platforms: - name: Debian versions: - - all + - wheezy + - jessie + - stretch + - buster galaxy_tags: - nsd - dns