bertvv.bind

Ansible角色 BIND

Actions 状态

这是一个用于设置 ISC BIND 的 Ansible 角色,作为多个域的权威仅 DNS 服务器。具体而言,此角色的职责是:

  • 安装 BIND
  • 设置主配置文件(主/辅助/转发服务器)
  • 设置前向和反向查找区域文件

该角色支持多个前向和反向区域,包括 IPv6。尽管启用递归查询是支持的(但强烈不建议),如果您想要设置缓存或转发名称服务器,请考虑使用其他角色。

如果您喜欢/使用此角色,请考虑在角色的 Ansible Galaxy 页面 上给它一个星标和评分。谢谢!

有关各版本之间显著更改的信息,请查看 变更日志

警告: 如果您自v5.0.0 之前开始使用此角色,请查看变更日志以获取关于重大更改的重要信息。如果您升级到 v5.0.0,旧的剧本将会失败。

支持的平台

此角色可以在多个平台上使用,请参见 meta/main.yml 以获取更新的列表。我们努力为每个支持的平台设置自动化测试(请参见 .ci.yml),但这并不总是可行的。

关于不包含在自动化测试中的支持角色的几点说明:

  • Arch LinuxFreeBSD 应该可以正常工作,但目前无法在这些发行版上测试该角色,因为没有合适的 Docker 镜像可用。
  • CentOS 6 应该可以正常工作,但即使 BIND 安装成功,幂等性测试也会失败,接受测试成功。

需求

在管理节点上应安装软件包 python-netaddr(用于 ipaddr 过滤器)和 dnspython

角色变量

变量 默认值 注释(类型)
bind_acls [] ACL 定义的列表,包含 name:match_list: 键的映射。请参见下文示例。
bind_allow_query ['localhost'] 可以查询此 DNS 服务器的主机列表。设置为 ['any'] 以允许所有主机查询。
bind_allow_recursion ['any'] 类似于 bind_allow_query,此选项适用于递归查询。
bind_check_names [] 检查主机名是否符合 RFC 952 和 RFC 1123,并采取定义的动作(例如 warnignorefail)。
bind_dns_keys [] 绑定密钥的列表,包含 name:algorithm:secret: 键的映射。请参见下文示例。
bind_dns64 false 如果为 true,则启用 DNS64
bind_dns64_clients ['any'] DNS64 功能适用的客户端列表(可以是任何 ACL)。
bind_dnssec_enable true 如果为 true,则启用 DNSSEC。
bind_dnssec_validation true 如果为 true,则启用 DNSSEC 验证。
bind_extra_include_files [] 从主配置文件中包含的自定义配置文件列表。
bind_forward_only false 如果为 true,则将 BIND 设置为缓存名称服务器。
bind_forwarders [] 转发 DNS 请求的名称服务器列表。
bind_listen_ipv4 ['127.0.0.1'] 监听的网络接口的 IPv4 地址列表。设置为 ['any'] 以在所有接口上监听。
bind_listen_ipv4_port [53] 监听 IPv4 地址的端口号列表。
bind_listen_ipv6 ['::1'] 监听的网络接口的 IPv6 地址列表。
bind_listen_ipv6_port [53] 监听 IPv6 地址的端口号列表。
bind_log data/named.run 日志文件路径。
bind_other_logs - 配置日志频道的列表,每个区域一个单独的映射,包含相关细节。
bind_query_log - 包含 file:(例如 data/query.log)、versions:size: 的映射。当定义时,这将启用查询日志。
bind_recursion false 决定是否将 DNS 服务器非权威的请求转发。
bind_rrset_order random 定义 DNS 轮询的顺序(randomcyclic)。
bind_statistics_channels false 如果为 true,则 BIND 配置为具有 statistics-channels 语句(当前仅支持在单接口上监听)。
bind_statistics_allow ['127.0.0.1'] 可以访问服务器统计信息的主机列表。
bind_statistics_host 127.0.0.1 统计服务应监听的网络接口的 IP 地址。
bind_statistics_port 8053 统计服务应监听的网络端口。
bind_zone_dir - 当定义时,设置一个自定义的绝对路径到服务器目录(用于区域文件等),而不是默认路径。
bind_key_mapping [] Primary: Keyname - 用于特定主机的 TSIG 密钥的映射。
bind_zones n/a 包含区域定义的映射列表。请参见此表下方的示例。

(后续内容略)

关于项目

Sets up ISC BIND as an authoritative DNS server for one or more domains (primary and/or secondary).

安装
ansible-galaxy install bertvv.bind
许可证
other
下载
406.9k
拥有者
Hi! My contribs are often related to my job (teaching Linux), but are mostly done in my free time. I can't always respond quickly to PRs and Issues. Sorry!