Community.Dns 版本说明 

v3.1.0 

次要更改 

所有控制器代码 - 现代化 Python 代码 (https://github.com/ansible-collections/community.dns/pull/231).

新的插件 

过滤器 

community.dns.reverse_pointer - 将 IP 地址转换为用于反向查找的 DNS 名称。

查找 

community.dns.reverse_lookup - 反向查找 IP 地址。

v3.0.0 

主要更改 

community.dns 集合现在依赖于 community.library_inventory_filtering_v1 集合。此实用程序集合为清单插件提供了主机过滤功能。如果您使用 Ansible 社区软件包，则包含这两个集合，您无需执行任何特殊操作。如果您使用 ansible-galaxy collection install 安装集合，它将自动安装。如果您通过将集合的文件复制到 ansible-core 可以找到的位置来安装集合（例如克隆 git 仓库），则如果使用清单插件，则需要确保也安装依赖项 (https://github.com/ansible-collections/community.dns/pull/196).

次要更改 

清单插件 - 添加 filter 选项，允许基于 Jinja2 条件包含和排除主机 (https://github.com/ansible-collections/community.dns/pull/196).
lookup, lookup_as_dict - 现在可以配置是否应将输入视为绝对域名 (search=false)，或可能视为相对域名 (search=true) (https://github.com/ansible-collections/community.dns/issues/200, https://github.com/ansible-collections/community.dns/pull/201).

重大变更/移植指南 

各个模块和插件中txt_character_encoding选项的默认值已从octal更改为decimal (https://github.com/ansible-collections/community.dns/pull/196).
资源清单插件 - filters不再是simple_filters的别名，而是一个新的、不同的选项 (https://github.com/ansible-collections/community.dns/pull/196).
资源清单插件 - plugin选项现在是必需的 (https://github.com/ansible-collections/community.dns/pull/196).
lookup，lookup_as_dict - search的默认值已从false（community.dns 2.x.y 的隐式默认值）更改为true (https://github.com/ansible-collections/community.dns/issues/200, https://github.com/ansible-collections/community.dns/pull/201).

已移除的功能（先前已弃用）

该集合不再支持在 3.0.0 版本发布时已结束生命周期的 Ansible、ansible-base 和 ansible-core 版本。这意味着 Ansible 2.9、ansible-base 2.10、ansible-core 2.11、ansible-core 2.12 和 ansible-core 2.13 不再受支持。该集合可能仍然可以与这些版本一起使用，但随时可能停止工作而无需事先通知，这将不被视为错误 (https://github.com/ansible-collections/community.dns/pull/196).
hetzner_dns_record_set, hetzner_dns_record - 已移除前缀选项的弃用别名name (https://github.com/ansible-collections/community.dns/pull/196).
hosttech_dns_records - 已移除到hosttech_dns_record_sets模块的重定向 (https://github.com/ansible-collections/community.dns/pull/196).

v2.9.0 

错误修复 

更新公共后缀列表。
资源清单插件 - 添加了不安全包装器，以避免将不包含{或}的字符串标记为不安全，以解决 AWX 中的错误 (https://github.com/ansible-collections/community.dns/pull/197).

新的插件 

过滤器 

community.dns.quote_txt - 将字符串用引号括起来，用作 TXT 记录条目
community.dns.unquote_txt - 将 TXT 记录条目取消引号，转换为字符串

v2.8.3 

错误修复 

DNS 记录模块，资源清单插件 - 修复 TXT 条目编码器，以避免将引号和反斜杠的转义序列拆分为多个 TXT 字符串 (https://github.com/ansible-collections/community.dns/issues/190, https://github.com/ansible-collections/community.dns/pull/191).
更新公共后缀列表。

v2.8.2 

安全修复 

hosttech_dns_records 和 hetzner_dns_records 资源清单插件 - 确保从远程服务器接收到的所有数据都被标记为不安全，因此无法通过获取可以作为模板评估的文本进行远程代码执行 (https://www.die-welt.net/2024/03/remote-code-execution-in-ansible-dynamic-inventory-plugins/, https://github.com/ansible-collections/community.dns/pull/189).

v2.8.0 

次要更改 

hetzner_dns_records 和 hosttech_dns_records 资源清单插件 - filters选项已重命名为simple_filters。旧名称在 community.hrobot 2.0.0 之前仍然有效。然后它将更改为允许使用community.library_inventory_filtering_v1集合的功能进行更复杂的过滤 (https://github.com/ansible-collections/community.dns/pull/181).

已弃用的功能 

hetzner_dns_records 和 hosttech_dns_records 资源清单插件 - filters选项已重命名为simple_filters。旧名称将在 community.hrobot 2.0.0 中停止工作 (https://github.com/ansible-collections/community.dns/pull/181).

v2.7.0 

次要更改 

nameserver_info 和 nameserver_record_info - 添加server参数以指定自定义 DNS 服务器 (https://github.com/ansible-collections/community.dns/pull/168, https://github.com/ansible-collections/community.dns/pull/178).
wait_for_txt - 添加server参数以指定自定义 DNS 服务器 (https://github.com/ansible-collections/community.dns/pull/178).

错误修复 

更新公共后缀列表。
wait_for_txt、nameserver_info、nameserver_record_info - 在查找域的 nameserver 时，不要将NXDOMAIN视为致命错误 (https://github.com/ansible-collections/community.dns/pull/177).

v2.6.4 

错误修复 

更新公共后缀列表。
nameserver_record_info - 修复检索多个记录时崩溃的问题 (https://github.com/ansible-collections/community.dns/pull/172).

v2.6.3 

错误修复 

HTTP 模块实用程序 - 使其与 ansible-core 2.17 兼容 (https://github.com/ansible-collections/community.dns/pull/165).
更新公共后缀列表。

v2.6.0 

次要更改 

wait_for_txt - 添加servfail_retries参数，允许在 SERVFAIL 错误后重试 (https://github.com/ansible-collections/community.dns/pull/159).
wait_for_txt，解析器模块实用程序 - 使用EDNS (https://github.com/ansible-collections/community.dns/pull/158).

错误修复 

更新公共后缀列表。
wait_for_txt，解析器模块实用程序 - 改进了错误处理 (https://github.com/ansible-collections/community.dns/pull/158).

新的插件 

查找 

community.dns.lookup - 查找 DNS 记录
community.dns.lookup_as_dict - 将 DNS 记录查找为字典

新的模块 

community.dns.nameserver_info - 查找 DNS 名称的 nameserver
community.dns.nameserver_record_info - 查找 DNS 名称所有 nameserver 的特定类型的全部记录

从这个版本开始，community.dns 在其文档中使用新的 Ansible 语义标记。如果您使用 ansible-core 2.15 之前的 ansible-doc CLI 工具查看文档，请注意它无法正确渲染标记。在大多数情况下，您仍然可以阅读它，但您需要 ansible-core 2.15 或更高版本才能按预期查看它。或者，您可以查看 devel 文档站点以获取最新版本文档的已渲染 HTML 版本。

已知问题 

对于 ansible-core 2.15 之前的版本，Ansible 标记将以原始形式显示在 ansible-doc 文本输出中。如果您难以解读文档标记，请升级到 ansible-core 2.15（或更高版本），或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/dns/ 上的 HTML 文档。

v2.5.5 

发行概要 

具有更新 PSL 的维护版本。

错误修复 

更新公共后缀列表。

v2.5.4 

发行概要 

具有更新 PSL 的维护版本。

错误修复 

更新公共后缀列表。

v2.5.3 

发行概要 

具有更新 PSL 的维护版本。

错误修复 

更新公共后缀列表。

v2.5.2 

发行概要 

维护版本，改进了文档并更新了 PSL。

错误修复 

更新公共后缀列表。

v2.5.1 

发行概要 

维护版本（更新了 PSL）。

错误修复 

更新公共后缀列表。

v2.5.0 

发行概要 

功能和错误修复版本，更新了 PSL。

次要更改 

hosttech 清单插件 - 允许分别使用 ANSIBLE_HOSTTECH_DNS_TOKEN、ANSIBLE_HOSTTECH_API_USERNAME 和 ANSIBLE_HOSTTECH_API_PASSWORD 环境变量配置令牌、用户名和密码 (https://github.com/ansible-collections/community.dns/pull/131)。
各种模块和清单插件 - 添加了新选项 txt_character_encoding，用于控制当 txt_transformation=quoted 时是否将数字转义序列解释为八进制或十进制 (https://github.com/ansible-collections/community.dns/pull/134)。

已弃用的功能 

新添加的选项 txt_character_encoding 的默认值将在 community.dns 3.0.0 中从 octal 更改为 decimal。新的默认值将与 RFC 1035 兼容 (https://github.com/ansible-collections/community.dns/pull/134)。

错误修复 

更新公共后缀列表。
清单插件 - 文档说明了 ansible.builtin.auto 清单插件使用的 plugin 选项，并在文档中提到了所需的文件结尾 (https://github.com/ansible-collections/community.dns/issues/130，https://github.com/ansible-collections/community.dns/pull/131)。

v2.4.2 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.4.1 

发行概要 

定期维护版本。

错误修复 

更新公共后缀列表。
wait_for_txt - 还检索名称服务器的 IPv6 地址。防止仅使用 IPv6 名称服务器时出现故障 (https://github.com/ansible-collections/community.dns/issues/120，https://github.com/ansible-collections/community.dns/pull/121)。

v2.4.0 

发行概要 

功能和维护版本。

次要更改 

添加了一个 community.dns.hetzner 模块默认组/操作组。与 group/community.dns.hetzner 一起使用，为所有 Hetzner DNS 模块提供选项 (https://github.com/ansible-collections/community.dns/pull/119)。
添加了一个 community.dns.hosttech 模块默认组/操作组。与 group/community.dns.hosttech 一起使用，为所有 Hosttech DNS 模块提供选项 (https://github.com/ansible-collections/community.dns/pull/119)。
wait_for_txt - 该模块现在支持检查模式。行为上唯一实际的更改是，在检查模式下，现在执行模块而不是跳过。由于模块不会更改任何内容，因此自最初添加以来，它应该被标记为支持检查模式 (https://github.com/ansible-collections/community.dns/pull/119)。

错误修复 

更新公共后缀列表。

v2.3.4 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.3.3 

发行概要 

维护版本，包含更新的公共后缀列表。

错误修复 

更新公共后缀列表。

v2.3.2 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.3.1 

发行概要 

维护版本，包含更新的公共后缀列表。

次要更改 

集合存储库符合 REUSE 规范，但变更日志片段除外 (https://github.com/ansible-collections/community.dns/pull/112)。

错误修复 

更新公共后缀列表。

v2.3.0 

发行概要 

维护版本，包含更新的公共后缀列表。

次要更改 

所有软件许可证现在都位于集合根目录的 LICENSES/ 目录中。此外，SPDX-License-Identifier: 用于声明每个未自动生成的适用的许可证文件 (https://github.com/ansible-collections/community.dns/pull/109)。

错误修复 

更新公共后缀列表。

v2.2.1 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.2.0 

发行概要 

功能版本。

次要更改 

hetzner_dns_records 和 hosttech_dns_records 清单插件 - 允许模板化特定于提供程序的凭据以及 zone_name、zone_id 选项 (https://github.com/ansible-collections/community.dns/pull/106)。
wait_for_txt - 改进错误消息，以便在出现 SERVFAIL 或其他 DNS 错误时，可以清楚地知道从哪个 DNS 服务器查询了哪个记录 (https://github.com/ansible-collections/community.dns/pull/105)。

错误修复 

更新公共后缀列表。

v2.1.1 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.1.0 

发行概要 

包含更新的 PSL 的功能和维护版本。

次要更改 

通过声明其依赖项来准备可在执行环境中包含的集合（https://github.com/ansible-collections/community.dns/pull/93）。

错误修复 

更新公共后缀列表。

v2.0.9 

发行概要 

维护版本，更新了公共后缀列表并添加了集合链接文件。

错误修复 

更新公共后缀列表。

v2.0.8 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.0.7 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.0.6 

发行概要 

错误修复版本。

错误修复 

更新公共后缀列表。
wait_for_txt - 如果返回NXDOMAIN结果，则不会失败。如果找不到任何名称服务器，也不会成功（https://github.com/ansible-collections/community.dns/issues/81，https://github.com/ansible-collections/community.dns/pull/82）。

v2.0.5 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.0.4 

发行概要 

维护版本，更新了公共后缀列表。

错误修复 

更新公共后缀列表。

v2.0.3 

发行概要 

错误修复版本。

次要更改 

HTTP API 模块实用程序 - 使用最新 ansible-core devel 分支中的更改修复 fetch_url 的用法（https://github.com/ansible-collections/community.dns/pull/73）。

v2.0.2 

发行概要 

定期维护版本。

错误修复 

更新公共后缀列表。

v2.0.1 

发行概要 

维护版本，包含公共后缀列表更新。

错误修复 

更新公共后缀列表。

v2.0.0 

发行概要 

此版本包含许多新功能、模块和插件，但也对 1.x.y 版本进行了一些重大更改。如果您使用的是此集合的早期版本，请仔细阅读更改日志以确定需要更改的内容。

次要更改 

添加对 Hetzner DNS 的支持（https://github.com/ansible-collections/community.dns/pull/27）。
向所有使用 DNS 记录的模块和插件添加了txt_transformation选项（https://github.com/ansible-collections/community.dns/issues/48，https://github.com/ansible-collections/community.dns/pull/57，https://github.com/ansible-collections/community.dns/pull/60）。
hosttech_dns_records 模块已重命名为 hosttech_dns_record_sets（https://github.com/ansible-collections/community.dns/pull/31）。
如果 API 支持，内部 API 现在支持批量 DNS 记录更改（https://github.com/ansible-collections/community.dns/pull/39）。
内部记录 API 允许管理额外数据（https://github.com/ansible-collections/community.dns/pull/63）。
使用 HTTP 辅助类使 API 实现适用于插件和模块。使 WSDL API 使用fetch_url而不是open_url用于模块（https://github.com/ansible-collections/community.dns/pull/36）。
hetzner_dns_record 和 hosttech_dns_record - 在不使用检查模式的情况下，使用实际返回数据进行差异比较，而不是输入数据，以便可以显示额外数据（https://github.com/ansible-collections/community.dns/pull/63）。
hetzner_dns_zone_info - legacy_ns返回值现在已排序，因为其顺序不稳定（https://github.com/ansible-collections/community.dns/pull/46）。
hosttech_dns_* 模块 - 将zone参数重命名为zone_name。旧名称zone仍然可以用作别名（https://github.com/ansible-collections/community.dns/pull/32）。
hosttech_dns_record_set - 当state=absent和overwrite=true时，不再需要value（https://github.com/ansible-collections/community.dns/pull/31）。
hosttech_dns_record_sets - records已重命名为record_sets。旧名称records仍然可以用作别名（https://github.com/ansible-collections/community.dns/pull/31）。
hosttech_dns_zone_info - 将额外信息作为zone_info返回（https://github.com/ansible-collections/community.dns/pull/38）。

重大更改/移植指南 

所有处理 DNS 记录的 Hetzner 模块和插件现在默认使用未加引号的 TXT 值。可以通过设置txt_transformation=api来获得旧的行为（https://github.com/ansible-collections/community.dns/issues/48，https://github.com/ansible-collections/community.dns/pull/57，https://github.com/ansible-collections/community.dns/pull/60）。
Hosttech API 创建 - 现在需要ModuleOptionProvider对象而不是AnsibleModule对象。或者可以传递 Ansible 插件实例（https://github.com/ansible-collections/community.dns/pull/37）。
hetzner_dns_record_info 和 hosttech_dns_record_info 模块已分别重命名为 hetzner_dns_record_set_info 和 hosttech_dns_record_set_info（https://github.com/ansible-collections/community.dns/pull/54）。
hosttech_dns_record 模块已重命名为 hosttech_dns_record_set（https://github.com/ansible-collections/community.dns/pull/31）。
内部批量记录更新助手（bulk_apply_changes）现在也返回已删除、创建或更新的记录（https://github.com/ansible-collections/community.dns/pull/63）。
内部记录 API 不再允许显式管理注释（https://github.com/ansible-collections/community.dns/pull/63）。
使用内部模块 API 时，现在必须传递区域 ID 类型和提供程序信息对象（https://github.com/ansible-collections/community.dns/pull/27）。
hetzner_dns_record* 模块 - 实现对默认 TTL 的正确处理。在这种情况下，现在接受并返回值none（https://github.com/ansible-collections/community.dns/pull/52，https://github.com/ansible-collections/community.dns/issues/50）。
hetzner_dns_record、hetzner_dns_record_set、hetzner_dns_record_sets - 默认 TTL 现在为 300，不再为 3600，这等于 Web 控制台中的默认值（https://github.com/ansible-collections/community.dns/pull/43）。
hosttech_dns_record_set 模块的 overwrite 选项已被新的 on_existing 选项替换。指定 overwrite=true 等效于 on_existing=replace（新的默认值）。指定 overwrite=false 和 state=present 等效于 on_existing=keep_and_fail，指定 overwrite=false 和 state=absent 等效于 on_existing=keep (https://github.com/ansible-collections/community.dns/pull/31).

已弃用的功能 

hosttech_dns_records 模块已重命名为 hosttech_dns_record_sets。旧名称将在 community.dns 3.0.0 中停止工作 (https://github.com/ansible-collections/community.dns/pull/31).

错误修复 

Hetzner API - 将缺失的 TTL 解释为 300，这与 Web 控制台的操作相同 (https://github.com/ansible-collections/community.dns/pull/42).
更新公共后缀列表。
更新公共后缀列表。
更新公共后缀列表。
hetzner API 代码 - 确保在 HTTP 状态码指示成功时也处理 API 返回的错误。对于 500 内部服务器错误，有时会发生这种情况 (https://github.com/ansible-collections/community.dns/pull/58).
hosttech_dns_zone_info - 确保在通过 ID 或名称请求区域时都返回完整信息 (https://github.com/ansible-collections/community.dns/pull/56).
wait_for_txt - 修复处理过长 TXT 值的问题 (https://github.com/ansible-collections/community.dns/pull/65).
wait_for_txt - 解析名称服务器有时会导致空列表，从而产生错误的结果 (https://github.com/ansible-collections/community.dns/pull/64).

新的插件 

清单 

community.dns.hetzner_dns_records - 从 Hetzner DNS 记录创建清单
community.dns.hosttech_dns_records - 从 Hosttech DNS 记录创建清单

新的模块 

community.dns.hetzner_dns_record - 在 Hetzner DNS 服务中添加或删除单个记录
community.dns.hetzner_dns_record_info - 检索 Hetzner DNS 服务中的记录
community.dns.hetzner_dns_record_set - 在 Hetzner DNS 服务中添加或删除记录集
community.dns.hetzner_dns_record_set_info - 检索 Hetzner DNS 服务中的记录集
community.dns.hetzner_dns_record_sets - 批量同步 Hetzner DNS 服务中的 DNS 记录集
community.dns.hetzner_dns_zone_info - 检索 Hetzner DNS 服务中的区域信息
community.dns.hosttech_dns_record - 在 Hosttech DNS 服务中添加或删除单个记录
community.dns.hosttech_dns_record_info - 检索 Hosttech DNS 服务中的记录
community.dns.hosttech_dns_record_set - 在 Hosttech DNS 服务中添加或删除记录集
community.dns.hosttech_dns_record_sets - 批量同步 Hosttech DNS 服务中的 DNS 记录集

v1.2.0 

发行摘要 

最后一个次要的 1.x.0 版本。2.0.0 版本将对 hosttech_dns_record 和 hosttech_dns_records 模块进行一些向后不兼容的更改，这需要用户干预。这些更改应该会带来更好的用户体验。

次要更改 

hosttech 模块 - 为 hosttech_token 添加 api_token 别名 (https://github.com/ansible-collections/community.dns/pull/26).
hosttech_dns_record - 在 diff 模式下，当 changed 为 false 时，也返回 diff 数据结构 (https://github.com/ansible-collections/community.dns/pull/28).
模块实用程序 - 为一些区域/记录 API 函数添加默认实现，并将通用的 JSON API 代码移动到辅助类 (https://github.com/ansible-collections/community.dns/pull/26).

错误修复 

更新公共后缀列表。
hosttech_dns_record - 正确处理 JSON API 中 CAA 记录中的引号 (https://github.com/ansible-collections/community.dns/pull/30).

避免使用内部 ansible-core module_utils，而使用自 Ansible 2.9 以来可用的等效公共 API (https://github.com/ansible-collections/community.dns/pull/24).

错误修复 

更新公共后缀列表。

更新公共后缀列表。

更新公共后缀列表。

hosttech_dns_* - 使用适当的 JSON API 速率限制来处理 419 Too Many Requests (https://github.com/ansible-collections/community.dns/pull/14).

错误修复 

在规范化期间，避免将包含下划线或其他不在 [a-zA-Z0-9-] 范围内的可打印 ASCII 字符的 ASCII 标签转换为 alabels (https://github.com/ansible-collections/community.dns/pull/13).
更新公共后缀列表。

新的模块 

community.dns.hosttech_dns_records - 在 Hosttech DNS 服务中批量同步 DNS 记录

hosttech_* 模块 - 支持 https://api.ns1.hosttech.eu/api/documentation/ 上的新 JSON API (https://github.com/ansible-collections/community.dns/pull/4).

次要更改 

hosttech_dns_record* 模块 - 允许指定 prefix 代替 record (https://github.com/ansible-collections/community.dns/pull/8).
hosttech_dns_record* 模块 - 允许使用 zone_id 参数指定区域 ID，作为 zone 参数的替代方案 (https://github.com/ansible-collections/community.dns/pull/7).
hosttech_dns_record* 模块 - 成功时返回 zone_id (https://github.com/ansible-collections/community.dns/pull/7).
hosttech_dns_record* 模块 - 支持 IDN 域名和前缀 (https://github.com/ansible-collections/community.dns/pull/9).
hosttech_dns_record_info - 也为记录集返回 prefix (https://github.com/ansible-collections/community.dns/pull/8).
hosttech_record - 通过指定 overwrite=true 允许删除记录而无需首先查询其内容 (https://github.com/ansible-collections/community.dns/pull/4).

重大更改/移植指南 

hosttech_* 模块实用程序 - 完全重写和重构，以支持新的 JSON API 并允许重用与提供程序无关的模块逻辑 (https://github.com/ansible-collections/community.dns/pull/4).

错误修复 

更新公共后缀列表。
hosttech_record - 修复 state=absent 的差异模式 (https://github.com/ansible-collections/community.dns/pull/4).
hosttech_record_info - 修复身份验证错误处理 (https://github.com/ansible-collections/community.dns/pull/4).

新模块 

community.dns.hosttech_dns_zone_info - 在 Hosttech DNS 服务中检索区域信息

community.dns.get_public_suffix - 返回 DNS 名称的公共后缀
community.dns.get_registrable_domain - 返回 DNS 名称的可注册域名
community.dns.remove_public_suffix - 从 DNS 名称中删除公共后缀
community.dns.remove_registrable_domain - 从 DNS 名称中删除可注册域名

新模块 

community.dns.hosttech_dns_record - 在 Hosttech DNS 服务中添加或删除条目
community.dns.hosttech_dns_record_info - 在 Hosttech DNS 服务中检索条目
community.dns.wait_for_txt - 等待 TXT 条目在所有权威名称服务器上可用