Linkerd Service Mesh 服務配置文件規范
作者： 為少
服務配置文件 為 Linkerd 提供有關服務的附加信息。以下是可以使用服務配置文件完成的所有操作的參考。
服務配置文件 為 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 時應考慮請求的時間 |
實戰
- 設置服務配置文件
https://linkerd.hacker-linner.com/2.11/tasks/setting-up-service-profiles/
- 完整的 demo 演練
https://linkerd.hacker-linner.com/2.11/tasks/books/#service-profiles/
責任編輯：武曉燕
來源：
黑客下午茶
