$ opm get zhangbao0325/orange

概述

包含 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年8月28日) 修复和新增选项

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

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

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

• 修复：添加了一个解决方法，用于 Amazon Route 53 命名服务器回复 ttl=0，而记录具有非 0 ttl。 问题 56。

2.1.0 (2018年5月21日) 修复

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

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

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

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

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

2.0.0 (2018年2月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年9月4日) 修复和重构

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

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

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

0.6.1 (2017年7月28日) 调整随机化

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

0.6.0 (2017年6月14日) 重写解析器核心以异步解析

• 新增：只要可能，解析将以异步方式完成。为了使此功能正常工作，已引入一个新设置 staleTtl，它确定在后台进行查询时，陈旧记录将返回多长时间。

• 更改：重大更改！以前返回并采用解析器对象的几个函数不再这样做。

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

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

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

0.5.0 (2017年4月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年4月21日) 错误修复

• 修复：cname 记录缓存导致过多的 DNS 查询，请参阅 Kong 问题 #2303。

0.4.0 (2017年3月30日) 错误修复

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

• 新增：重大更改！一个重试计数器，用于在哈希重试时贯穿（更改了 getpeer 签名）

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

• 新增：两个方便的哈希函数

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

0.3.2 (2017年3月6日) 错误修复

• 修复：清理了禁用的地址，但未删除它们，导致在反复添加/删除它们时出现错误

• 修复：重新查询 DNS 记录时的潜在竞争条件

• 修复：当带有正在运行的计时器的均衡器对象被释放时，潜在的内存泄漏

0.3.1 (2017年2月22日) 错误修复

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

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

0.3.0 (2016年11月8日) 重大更新

• 重大更改：重命名了许多内容；方法名称、模块名称等，几乎破坏了一切……还在使用新名称发布

• 特性：添加了 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年9月9日) 初始发布版本