lucab85.ansible_role_bind
Rola Ansible: BIND
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:
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.
ansible-galaxy install lucab85.ansible_role_bind