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 community 包，则这两个集合都包含在内，您无需执行任何特殊操作。如果您使用 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 - 在查找域的名称服务器时，不要将 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 名称的名称服务器
community.dns.nameserver_record_info - 查找 DNS 名称的所有名称服务器的某种类型的全部记录

从本版本开始，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标签转换为a标签 ( https://github.com/ansible-collections/community.dns/pull/13).
更新了公共后缀列表。

新增模块 

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

hosttech_* 模块 - 支持新的JSON API: https://api.ns1.hosttech.eu/api/documentation/ ( 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_* module_utils - 完全重写和重构，以支持新的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条目在所有权威名称服务器上可用