Linkerd Service Mesh 服务配置文件规范

服务配置文件 为 Linkerd 提供有关服务的附加信息。

以下是可以使用服务配置文件完成的所有操作的参考。

系列

中文手册(https://linkerd.hacker-linner.com)

Spec(规范)

服务配置文件规范必须包含以下顶级字段：

field	value
routes	route 对象的列表
retryBudget	定义此服务的最大重试率的 retry budget 对象

Route(路由)

route 对象必须包含以下字段：

field	value
name	这条 route 的名称，因为它将出现在 route 标签中
condition	一个 request match 对象，用于定义请求是否与此 route 匹配
responseClasses	（可选）response class 对象列表
isRetryable	表示对该 route 的请求始终可以安全重试，并且会导致 proxy 尽可能重试该 route 上失败的请求
timeout	发送请求后等待响应（包括重试）完成的最长时间

Request Match(请求匹配)

请求匹配对象必须恰好包含以下字段之一：

field	value
pathRegex	匹配请求路径的正则表达式
method	GET, POST, PUT, DELETE, OPTION, HEAD, TRACE 之一
all	必须全部匹配的 request match 对象列表
any	request match 对象的列表，其中至少一个必须匹配
not	必须不匹配的 request match 对象

Request Match 使用示例

最简单的条件是路径正则表达式：

pathRegex: '/authors/\d+'

这是检查请求方法的条件：

method: POST

如果设置了多个条件字段，则必须满足所有条件。这等效于使用 all 条件：

all:
- pathRegex: '/authors/\d+'
- method: POST

可以使用 all、any 和 not 组合条件：

any:
- all:
  - method: POST
  - pathRegex: '/authors/\d+'
- all:
  - not:
      method: DELETE
  - pathRegex: /info.txt

Response Class(响应类)

response class 对象必须包含以下字段：

field	value
condition	一个 response match 对象，它定义一个 response 是否匹配这个 response class
isFailure	一个布尔值，用于定义这些 response 是否应归类为失败

Response Match(响应匹配)

response match 对象必须恰好包含以下字段之一：

field	value
status	用于匹配响应状态代码的 status range 对象
all	必须全部匹配的 response match 对象列表
any	response match 对象列表，其中至少一个必须匹配
not	必须不匹配的 response match 对象

Response Match 条件可以以类似于上面显示的 Request Match 使用示例 的方式组合

Status Range(状态范围)

status range 对象必须包含以下至少一个字段。只指定 min 或 max 中的一个将只匹配一个状态码。

field	value
min	状态码必须大于或等于此值
max	状态码必须小于或等于此值

Retry Budget(重试预算)

retry budget 指定应发送到此服务的最大重试总次数与原始请求量的比率。

field	value
retryRatio	重试请求与原始请求的最大比率
minRetriesPerSecond	除了 retryRatio 允许的重试次数外，允许每秒重试次数
ttl	指示在计算 retryRatio 时应考虑请求的时间

实战

• 设置服务配置文件
• 完整的 demo 演练

公众号：黑客下午茶