lucab85.ansible_role_bind

Rola Ansible: BIND

CI

Instaluje i konfiguruje usługę DNS BIND9 na Fedora/Centos/RHEL7/8 oraz Debian/Ubuntu jako autorytatywną dla jednego lub więcej domen (master i/lub slave) z dostosowaną strefą i odwrotną.

Wymagania

Brak specjalnych wymagań; pamiętaj, że ta rola wymaga dostępu roota, więc możesz ją uruchomić w playbooku z globalnym become: yes, lub wywołać rolę w swoim playbooku w następujący sposób:

- hosts: dns
  roles:
    - role: lucab85.ansible_role_bind
      become: yes

Zmienne roli

Dostępne zmienne są wymienione razem z wartościami domyślnymi w pliku defaults/main.yml.

Główna konfiguracja

Wszystkie ustawienia w bind_main_config_settings są zastosowane w głównym pliku konfiguracyjnym /etc/named.conf dla Fedora/CentOS/RHEL lub /etc/bind/named.conf dla Debian/Ubuntu (specyficzne dla platformy). Wszystkie ustawienia w bind_main_options_settings są zastosowane w głównym pliku konfiguracyjnym wewnątrz tagu options { }.

Przykład:

bind_main_options_settings:
  - option: listen-on port
    value: '53 { 127.0.0.1; 10.0.1.1; };'
  - option: allow-query
    value: '{ trusted; };'
  - option: forwarders
    value: '{ 8.8.8.8; 8.8.4.4; };'
  - option: listen-on-v6
    value: '{ any; };'
  - option: dnssec-validation
    value: 'auto;'

Zauważ, że w tym przykładzie 10.0.1.1 to adres IPv4 docelowej maszyny, dostosuj go wg potrzeb.

bind_main_config_settings:
  - option: acl "trusted"
    value: '{ 10.0.1.1; 10.0.1.2; };'

W tym przykładzie zdefiniowałem listę ACL trusted z dwoma adresami IPv4, które możemy wykorzystać w naszej polityce (patrz później), dostosuj wg potrzeb.

Przykład wyjścia:

#
# Zarządzane przez Ansible: NIE edytuj tego pliku ręcznie!
#
options {
    directory "/var/named";
    listen-on port 53 { 127.0.0.1; 10.0.1.1; };
    allow-query { trusted; };
    forwarders { 8.8.8.8; 8.8.4.4; };
    listen-on-v6 { any; };
    dnssec-validation auto;
};
acl "trusted" { 10.0.1.1; 10.0.1.2; };
include "/etc/named/named.conf.local";

Konfiguracja strefy

Ustawienia strefy są definiowane w bind_zones_entries i stosowane za pomocą szablonu definicji strefy zone.j2. Ustawienia strefy są definiowane w pomocniczym pliku konfiguracyjnym /etc/named/named.conf.local dla Fedora/CentOS/RHEL oraz Debian/Ubuntu (specyficzne dla platformy). Rekordy strefy są przechowywane w /var/named/[[ example.com.zone ]] dla Fedora/CentOS/RHEL lub /var/lib/bind/[[ example.com.zone ]] dla Debian/Ubuntu (specyficzne dla platformy).

Przykład:

bind_zones_entries:
  - name: "example.com"
    file: "example.com.zone"
    type: "master"
    options: "allow-update { none; };"
    ttl: 86400
    records:
     - name: "@"
       type: "SOA"
       value: "dns1.example.com. hostmaster.example.com. (2001062501 21600 3600 604800 86400)"
     - name: "@"
       type: "NS"
       value: "dns1.example.com."
     - name: "@"
       type: "NS"
       value: "dns2.example.com."
     - name: "dns1"
       type: "A"
       value: "10.0.1.1"
     - name: "dns2"
     [...]

Przykład wyjścia lokalnego: /etc/named/named.conf.local

#
# Zarządzane przez Ansible: NIE edytuj tego pliku ręcznie!
#
zone "example.com" IN {
    type master;
    file "example.com.zone";
    allow-update { none; };
};
zone "1.0.10.in-addr.arpa" IN {
    type master;
    file "example.com.rr.zone";
    allow-update { none; };
};

Przykład wyjścia: /var/named/example.com.zone

$ORIGIN example.com.
$TTL 86400;
@  IN  SOA dns1.example.com. hostmaster.example.com. (2001062501 21600 3600 604800 86400)
@  IN  NS dns1.example.com.
@  IN  NS dns2.example.com.
dns1  IN  A 10.0.1.1
dns2  IN  A 10.0.1.2
@  IN  MX 10 mail1.example.com.
@  IN  MX 20 mail2.example.com.
mail1  IN  A 10.0.1.5
mail2  IN  A 10.0.1.6
services  IN  A 10.0.1.10
services  IN  A 10.0.1.11
ftp  IN  CNAME services.example.com.
wwww  IN  CNAME services.example.com.

Konfiguracja strefy odwrotnej

W ten sam sposób, w jaki konfigurujesz "strefę", możesz również skonfigurować strefę odwrotną.

Przykład:

- name: "1.0.10.in-addr.arpa"
  file: "example.com.rr.zone"
  type: "master"
  options: "allow-update { none; };"
  ttl: 86400
  records:
   - name: "@"
     type: "SOA"
     value: "dns1.example.com. hostmaster.example.com. (2001062501 21600 3600 604800 86400)"
   - name: "@"
     type: "NS"
     value: "dns1.example.com."
   - name: "@"
     type: "NS"
     value: "dns2.example.com."
   - name: "1"
     type: "PTR"
     value: "dns1.example.com."
     [...]

Przykład wyjścia: /var/named/example.com.rr.zone

$ORIGIN 1.0.10.in-addr.arpa.
$TTL 86400;
@  IN  SOA dns1.example.com. hostmaster.example.com. (2001062501 21600 3600 604800 86400)
@  IN  NS dns1.example.com.
@  IN  NS dns2.example.com.
@  IN  NS dns1.example.com.
1  IN  PTR dns1.example.com.
2  IN  PTR dns2.example.com.
5  IN  PTR mail1.example.com.
6  IN  PTR mail2.example.com.
10  IN  PTR services.example.com.
11  IN  PTR services.example.com.

Zapoznaj się z dokumentacją BIND w celu uzyskania szczegółowych definicji rekordów.

Zależności

Brak.

Przykładowy Playbook

- hosts: dns
  become: yes
  vars_files:
    - vars/main.yml
  roles:
    - lucab85.ansible_role_bind

Dostosuj zmienne w vars/main.yml:

bind_zones_entries:
  - name: "example.com"
    file: "example.com.zone"
    type: "master"
    options: "allow-update { none; };"
    ttl: 86400
    records:
     - name: "@"
       type: "SOA"
       value: "dns1.example.com. hostmaster.example.com. (2001062501 21600 3600 604800 86400)"
     - name: "@"
       type: "NS"
       value: "dns1.example.com."
     - name: "@"
       type: "NS"
       value: "dns2.example.com."
     - name: "dns1"
       type: "A"
       value: "10.0.1.1"
     - name: "dns2"
     [...]

Licencja

MIT / BSD

Informacje o autorze

Ta rola została stworzona w 2021 roku przez Luca Berton, autora Ansible Pilot.

Ansible Pilot

Więcej informacji:

Wsparcie

Dziękuję za wsparcie:

O projekcie

Setup a BIND9 DNS service on Fedora/Centos/RHEL7/8 and Debian/Ubuntu target as authoritative for one or more domains (master and/or slave) with customized zone and reverse.

Zainstaluj
ansible-galaxy install lucab85.ansible_role_bind
Licencja
mit
Pobrania
311
Właściciel
Ansible Automation Engineer with Open Source passion: (Ansible, Progressive Web Applications, Cloud Computing, IoT, GNU/Linux)