buluma.dns

Rol de Ansible dns

Instala y configura DNS en tu sistema.

GitHub Versión Problemas Solicitudes de Extracción Descargas
github Versión Problemas Solicitudes de Extracción Rol de Ansible

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

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 Ansible Molecule Versión
buluma.core_dependencies Ansible Molecule Versión

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:

dependencias

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

Historial del Rol

Licencia

Apache-2.0

Información del Autor

Shadow Walker

Acerca del proyecto

Install and configure dns on your system.

Instalar
ansible-galaxy install buluma.dns
Licencia
apache-2.0
Descargas
8.9k
Propietario
DevOps Engineer