buluma.dns
Rol de Ansible dns
Instala y configura DNS en tu sistema.
GitHub | Versión | Problemas | Solicitudes de Extracción | Descargas |
---|---|---|---|---|
Ejemplo de Playbook
Este ejemplo se toma de molecule/default/converge.yml
y se prueba con cada envío, solicitud de extracción y liberación.
---
- name: Convergir
hosts: all
become: true
gather_facts: true
roles:
- role: buluma.dns
dns_port: 5353
La máquina necesita ser preparada. En CI, esto se hace usando molecule/default/prepare.yml
:
---
- name: Preparar
hosts: all
gather_facts: false
become: true
roles:
- role: buluma.bootstrap
- role: buluma.core_dependencies
También puedes ver una explicación completa y ejemplo sobre cómo usar estos roles.
Variables del Rol
Los valores predeterminados para las variables se establecen en defaults/main.yml
:
---
# archivo de valores predeterminados para dns
# El puerto para escuchar.
dns_port: 53
# ¿Debería el servidor DNS ser un servidor DNS en caché?
dns_caching_dns: true
# Una lista de zonas y propiedades por zona.
dns_zones:
- name: localhost
soa: localhost
serial: 1
refresh: 604800
retry: 86400
expire: 2419200
ttl: 604800
records:
- name: "@"
type: NS
value: localhost.
- name: "@"
value: "127.0.0.1"
- name: "@"
type: AAAA
value: "::1"
- name: "127.in-addr.arpa"
ttl: 604800
records:
- name: "@"
type: NS
value: localhost.
- name: "1.0.0"
type: PTR
value: localhost.
- name: "0.in-addr.arpa"
records:
- name: "@"
type: NS
value: localhost.
- name: "255.in-addr.arpa"
records:
- name: "@"
type: NS
value: localhost.
- name: example.com
ttl: 604800
ns:
- name: dns1.example.com.
- name: dns2.example.com.
mx:
- name: mail1.example.com.
priority: 10
- name: mail2.example.com.
priority: 20
records:
- name: dns1
value: "127.0.0.1"
- name: dns2
value: "127.0.0.1"
- name: www
value: "127.0.0.1"
- name: dns1
value: "127.0.0.1"
- name: dns2
value: "127.0.0.1"
- name: mail1
value: "127.0.0.1"
- name: mail2
value: "127.0.0.1"
- name: forwarded.example.com
type: forward
dns_zone_forwarders:
- "1.1.1.1"
- "8.8.8.8"
# Una lista opcional de acls para permitir la recursión. ("any" y "none" siempre están disponibles.)
dns_allow_recursion:
- none
# Una lista opcional de IPv4 en la que el servidor DNS escuchará. ("any" y "none" siempre están disponibles.)
dns_options_listen_on:
- any
# Una lista opcional de IPv6 en la que el servidor DNS escuchará. ("any" y "none" siempre están disponibles.)
dns_options_listen_on_v6:
- any
# Una lista opcional de IP que están permitidas para consultar el servidor. ("any" y "none" siempre están disponibles.)
# Predeterminado: "any"
# dns_options_allow_query:
# - any
# - "127.0.0.1"
# Una lista opcional de IP que están permitidas para ejecutar una consulta AXFR. ("any" y "none" siempre están disponibles.)
# Predeterminado: "none"
# dns_options_allow_transfer:
# - none
# - "172.16.0.1"
# Una configuración opcional para configurar la ruta donde se creará el archivo pid.
dns_pid_file: /run/named/named.pid
# Una configuración opcional para redirigir tráfico a otros servidores DNS.
# dns_options_forwarders:
# - "1.1.1.1"
# - "8.8.8.8"
# Otro ejemplo gracias a @blaisep.
# dns_zones:
# - name: lab.controlplane.info
# ttl: 600
# ns:
# - name: ns.lab.controlplane.info.
# mx:
# - name: mail1.lab.controlplane.info.
# priority: 10
# - name: mail2.lab.controlplane.info.
# priority: 20
# records:
# - name: ns
# value: "192.168.254.27"
# - name: git
# value: "192.168.254.19"
# - name: dl380
# value: "192.168.254.27"
# - name: mail1
# value: "192.168.123.123"
# - name: mail2
# value: "192.168.123.123"
# - name: forwarded.lab.controlplane.info
# ns:
# - name: forwarded.lab.controlplane.info.
# records:
# - name: ns
# value: "192.168.254.27"
# - name: "@"
# value: "192.168.123.123"
# dns_zone_forwarders:
# - "9.9.9.9"
# - "8.8.8.8"
Requisitos
- paquetes de pip listados en requirements.txt.
Estado de roles utilizados
Los siguientes roles se utilizan para preparar un sistema. Puedes preparar tu sistema de otra manera.
Requisito | GitHub | Versión |
---|---|---|
buluma.bootstrap | ||
buluma.core_dependencies |
Contexto
Este rol es parte de muchos roles compatibles. Consulta la documentación de estos roles para más información.
Aquí tienes un resumen de roles relacionados:
Compatibilidad
Este rol ha sido probado en estas imágenes de contenedor:
contenedor | etiquetas |
---|---|
Alpine | todas |
Amazon | Candidate |
EL | 8 |
Debian | todas |
Fedora | todas |
Ubuntu | todas |
La versión mínima de Ansible requerida es 2.12, se han realizado pruebas para:
- La versión anterior.
- La versión actual.
- La versión de desarrollo.
Si encuentras problemas, por favor regístralos en GitHub
Registro de cambios
Licencia
Información del Autor
Install and configure dns on your system.
ansible-galaxy install buluma.dns