$ opm get zhangbao0325/orangetest1

概述

包含 DNS 客户端、多个工具和负载均衡器的 Lua 库。

该模块目前仅适用于 OpenResty，并基于 `lua-resty-dns` 库构建。

功能

• 解析 A、AAAA、CNAME 和 SRV 记录，包括端口。

• 解析 /etc/hosts。

• 解析 /resolv.conf 并应用 LOCALDOMAIN 和 RES_OPTIONS 变量。

• 将 DNS 查询结果缓存到内存中。

• 同步请求（对多个请求者的单个请求，例如当缓存 TTL 在高负载下过期时）。

• toip 对查询结果应用本地（加权）轮询方案。

• 用于轮询和一致哈希方法的环形均衡器。

版权和许可

版权： (c) 2016-2018 Kong, Inc.

作者：Thijs Schreijer

许可证： Apache 2.0

测试

使用 busted 执行测试，但由于它们在 resty cli 工具中运行，因此必须使用 rbusted 脚本。

历史

版本控制严格基于 语义化版本控制

2.2.0 (2018-08-28) 修复和新选项

• 添加：一个新的选项 validTtl，如果设置，将强制覆盖任何有效答案接收到的 ttl 值。 问题 48.

• 修复：删除多行日志条目，现在编码为单行 json。 问题 52.

• 修复：始终注入 localhost 值，即使不在 /etc/hosts 中。 问题 54.

• 修复：添加了一个针对 Amazon Route 53 命名服务器的解决方法，该服务器使用 ttl=0 响应，而记录具有非 0 ttl。 问题 56.

2.1.0 (2018-05-21) 修复

• 修复：均衡器的轮询方案从随机位置开始，以防止所有工作者从同一个对等方开始。

• 修复：均衡器不再为没有端口的 SRV 记录返回 port = 0，现在返回默认端口。

• 修复：不支持其地址中有范围的 IPv6 命名服务器。此修复程序将简单地跳过它们，而不是在解析时抛出错误。修复 问题 43.

• 次要：改进均衡器中的日志记录。

• 次要：将失败的 DNS 查询的重新查询默认间隔从 1 秒放宽到 30 秒。

2.0.0 (2018-02-22) 主要性能改进（均衡器）和错误修复

• 重大变更：提高了大型均衡器的性能和内存占用。将使用少 80-85% 的内存，而创建时间减少了 85-90%。由于 host:getPeer() 函数签名已更改，因此这是一个重大变更。

• 更改：重大变更：仅缓存查找失败和空记录的错误已更改。

• 修复：如果没有命名服务器，不要失败初始化。

• 修复：正确识别 /etc/hosts 文件中方括号内的 IPv6。

• 修复：不要将成功类型设置为我们没有查找的类型。修复 Kong 问题 #3210.

• 修复：将附加部分的记录存储在缓存中。

• 修复：不要用空记录覆盖客户端缓存中的陈旧数据。

1.0.0 (2017-12-14) 修复和 IPv6

• 更改：重大变更：现在所有 IPv6 地址都以方括号返回。

• 修复：正确识别方括号内的 IPv6 地址。

0.6.3 (2017-11-27) 修复和标记不健康的对等方

• 添加：标记地址为失败/不健康的标志，请参见 setPeerStatus。

• 添加：回调以接收均衡器更新；添加到/从均衡器中删除的地址（例如在 DNS 更新后）。

• 修复：现在支持权重为 0 的 SRV 记录条目。

• 修复：无法解析最后一个主机名（均衡器）。

0.6.2 (2017-09-04) 修复和重构

• 修复：均衡器没有为命名的 SRV 条目返回主机名。参见 问题 #17

• 修复：修复偶尔失败的测试。

• 重构：从记录中删除元数据，而是将其存储在自己的缓存中。

0.6.1 (2017-07-28) 调整随机化

• 更改：使用不同的随机器进行环形均衡器，以可预测的方式在完全相同的状态下重新创建均衡器（添加 lrandom 库作为新的依赖项）。

0.6.0 (2017-06-14) 重写解析器核心以异步解析

• 添加：只要有可能，解析将异步完成。为了使这能够正常工作，引入了新的设置 staleTtl，它确定在后台查询正在进行时陈旧记录将返回多长时间。

• 更改：重大变更！以前返回和接受解析器对象的几个函数不再这样做。

• 修复：如果查询类型不是 A 或 AAAA，则不再将 IP 地址查找为名称。

• 修复：查询后将名称规范化为小写。

• 修复：为主机文件条目和 IP 地址设置上次成功类型。

0.5.0 (2017-04-25) 实现 SEARCH 和 NDOTS

• 移除：重大变更！已删除 stdError 函数。

• 添加：已实现 search 和 ndots 选项。

• 更改：resolve 不再将空结果或 DNS 错误作为表返回，而是作为 Lua 错误（nil + error）。

• 更改：toip() 和 resolve() 具有额外的结果；历史记录。包含已尝试的名称/类型/结果列表的表。

• 修复：resolv.conf 中的超时和重传选项被 client 模块忽略。

• 修复：具有 IPv6 地址的命名服务器无法正确使用。还添加了一个标志 enable_ipv6（默认 == false）来启用使用 IPv6 命名服务器。

0.4.1 (2017-04-21) 错误修复

• 修复：CNAME 记录缓存会导致过多的 DNS 查询，请参见 Kong 问题 #2303.

0.4.0 (2017-03-30) 错误修复

• 更改：重大变更！修改了哈希处理，现在必须是大于 0 的整数。

• 添加：重大变更！一个重试计数器，以在哈希重试时贯穿（更改了 getpeer 签名）。

• 修复：MAXNS（3）没有被遵守，因此从 resolv.conf 文件解析了超过 3 个命名服务器。修复 Kong 问题 #2290.

• 添加：两个方便的哈希函数。

• 性能：一些改进（为插槽列表预分配表）。

0.3.2 (2017-03-06) 错误修复

• 修复：清理了禁用的地址，但没有删除它们，导致在重复添加/删除它们时出错。

• 修复：重新查询 DNS 记录时可能出现的竞争条件。

• 修复：在使用运行的计时器释放均衡器对象时可能出现的内存泄漏。

0.3.1 (2017-02-22) 错误修复

• Kubernetes DNS 为各个节点返回 SRV 记录，其中目标是相同的名称（因此导致递归循环）。现在将删除这些条目，如果剩下的条目为空，它将使 SRV 查找失败，导致贯穿到下一个记录类型。

• Kubernetes 倾向于在没有提供/设置端口的情况下返回端口 0，因此 toip() 函数现在忽略 port=0 并回退到传入的端口。

0.3.0 (2016-11-08) 重大更新

• 重大变更：重命名了很多东西；方法名称、模块名称等，几乎破坏了所有内容... 也以新名称发布。

• 功能：添加了 UDP 函数 setpeername（客户端）。

• 修复：不要为 ttl=0 请求同步 DNS 查询（客户端）。

• 修复：完整的测试覆盖率和伴随的修复（环形均衡器）。

• 功能：为失败的 DNS 查询自动重试（环形均衡器）。

• 功能：现在支持更新权重，无需删除/重新添加（环形均衡器）。

• 更改：为失败的 DNS 查询配置自动重试间隔（环形均衡器）。

• 更改：为 ttl=0 DNS 记录配置最大生存时间间隔（环形均衡器）。

0.2.1 (2016-10-24) 错误修复

• 修复：toip() 在只有 1 个条目的 SRV 记录上失败。

0.2 (2016-10-18) 添加了均衡器

• 修复：即使从缓存中提供服务，也会创建解析器对象。

• 更改：更改解析器顺序（SRV 现在默认情况下是第一个），用于为每个条目创建 SRV 和 A 记录的 DNS 服务器。

• 功能：使解析器顺序可配置。

• 功能：环形均衡器（实验性，尚无完整的测试覆盖率）。

• 其他：更多 DNS 客户端的测试覆盖率。

0.1 (2016-09-09) 初始发布版本