服务配置文件 为 Linkerd 提供有关服务的附加信息。
以下是可以使用服务配置文件完成的所有操作的参考。
系列
中文手册(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 时应考虑请求的时间 |