## 工具
### 配置加載檢查工具
配置加載檢查工具校驗JSON格式的配置文件,是否符合JSON編碼規范,并符合Envoy JSON模式。 該工具利用`test/config_test/config_test.cc`中的配置進行校驗。在服務配置初始化中加載JSON配置是,會使用到它進行校驗。
**輸入**
該工具需要一個PATH做為根目錄配置,用于保存JSON Envoy配置文件。該工具將以遞歸方式遍歷文件目錄結構,并對每個文件運行配置測試。請記住,該工具將嘗試所加載路徑中的所有文件。
**輸出**
該工具將輸出Envoy日志,用它正在測試的配置初始化服務器配置。如果存在JSON文件格式不正確或不符合Envoy JSON模式的配置文件,則該工具將以狀態`EXIT_FAILURE`退出。如果該工具成功加載所有找到的配置文件,它將以狀態`EXIT_SUCCESS`退出。
**構建**
使用Bazel在本地構建該工具。
`bazel build //test/tools/config_load_check:config_load_check_tool`
**運行**
使用該工具時,如上所述加上PATH路徑。
`bazel-bin/test/tools/config_load_check/config_load_check_tool PATH`
### 路由表檢查工具
路由表檢查工具檢查路由器返回的路由參數是否與預期相符。該工具還可用于檢查重定向路徑,路徑重寫或主機重寫是否與預期相符。
**輸入**
該工具需要兩個輸入JSON文件:
1. 路由JSON配置文件。配置中找到路由配置JSON文件模式。
2. 工具JSON配置文件。配置中找到工具配置JSON文件模式。工具配置輸入文件指定URL(由權限和路徑組成)和期望的路由參數值。以及額外可選的參數,如附加標題。
**輸出**
如果任何測試用例與期望的路由參數值不匹配,則程序以`EXIT_FAILURE`狀態退出。
添加`--details`選項可以打印出每個測試的詳細信息。第一行表示測試名稱。
如果測試失敗,則打印失敗的測試用例的詳細信息。第一個字段是預期的路由參數值。第二個字段是實際的路由參數值。第三個字段表示比較的參數。在下面的示例中,Test_2和Test_5在其他測試通過時失敗。該測試案例中,將打印沖突詳細信息。
```
Test_1
Test_2
default other virtual_host_name
Test_3
Test_4
Test_5
locations ats cluster_name
Test_6
```
目前不支持使用有效的運行時值進行測試,這可能會在未來添加該功能。
**構建**
使用Bazel在本地構建該工具。
`bazel build //test/tools/router_check:router_check_tool`
**運行**
該工具需要輸入兩個json文件和一個可選的命令行選項`--details`。命令行參數期望的順序是:
1.路由器配置json文件;
2.工具配置json文件;
3.可選的詳細信息標識;
`bazel-bin/test/tools/router_check/router_check_tool router_config.json tool_config.json`
`bazel-bin/test/tools/router_check/router_check_tool router_config.json tool_config.json --details`
**測試**
通過bash的shell腳本,使用bazel運行測試。該測試使用不同的路由和工具的配置json文件,進行比較。這些配置json文件可以在`bazel test //test/tools/router_check/...`中找到。
`bazel test //test/tools/router_check/...`
### 模式驗證檢查工具
模式驗證程序工具驗證傳入的JSON是否符合配置規范。要驗證整個配置,請參閱上述配置加載檢查工具章節。目前只支持[路由配置](../v1APIreference/HTTPRouteconfiguration.md)模式驗證。
**輸入**
該工具需要兩個輸入:
1. 檢查在JSON中傳遞的模式類型。支持的類型是:
- route - 用于[路由配置](../v1APIreference/HTTPRouteconfiguration.md)驗證;
2. JSON的路徑;
**輸出**
如果JSON符合模式,則該工具將以狀態`EXIT_SUCCESS`退出。 如果JSON不符合模式,則會輸出錯誤消息,詳細說明不符合模式的內容。該工具將以狀態`EXIT_FAILURE`退出。
**構建**
使用Bazel在本地構建該工具。
`bazel build //test/tools/schema_validator:schema_validator_tool`
**運行**
該工具如上所述采取路徑。
`bazel-bin/test/tools/schema_validator/schema_validator_tool --schema-type SCHEMA_TYPE --json-path PATH`
## 返回
- [上一級](../Buildingandinstallation.md)
- [首頁目錄](../README.md)
- 首頁
- 簡介
- Envoy是什么
- 架構介紹
- 術語
- 線程模型
- 監聽器
- L3/L4網絡過濾器
- HTTP連接管理
- HTTP過濾器
- HTTP路由
- gRPC
- WebSocket支持
- 集群管理
- 服務發現
- 健康檢查
- 連接池
- 負載均衡
- 異常檢測
- 熔斷
- 全局限速
- TLS
- 統計
- 運行時配置
- 跟蹤
- TCP代理
- 訪問日志
- MongoDB
- DynamoDB
- Redis
- 熱重啟
- 動態配置
- 初始化
- 逐出
- 腳本
- 部署
- 業界對比
- 獲得幫助
- 歷史版本
- 編譯安裝
- 編譯
- 參考配置
- 演示沙箱
- 前端代理
- Zipkin跟蹤
- Jaeger跟蹤
- gRPC橋接
- 構建Envoy Docker鏡像
- 工具
- 配置參考
- V1 API 概述
- V2 API 概述
- 監聽器
- 網絡過濾器
- TLS客戶端身份認證
- Echo
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP連接管理器
- 路由匹配
- 流量轉移/分流
- HTTP頭部操作
- HTTP頭部清理
- 統計
- 運行時設置
- 路由發現服務
- HTTP過濾器
- 緩存
- CORS過濾器
- 故障注入
- DynamoDB
- gRPC HTTP/1.1 橋接
- gRPC-JSON 轉碼過濾器
- gRPC-Web 過濾器
- 健康檢查
- 速率限制
- 路由
- Lua
- 集群管理
- 統計
- 運行時設置
- 集群發現服務
- 健康檢查
- 熔斷
- 訪問日志
- 限速服務
- 運行時配置
- 路由表檢查工具
- 運維管理
- 命令行選項
- 熱重啟
- 管理接口
- 統計概述
- 運行時配置
- 文件系統
- 自定義擴展示例
- V1 API參考
- 監聽器
- 網絡過濾器
- TLS客戶端身份認證
- Echo
- HTTP連接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP路由配置
- 虛擬主機
- 路由
- 虛擬集群
- 速率限制配置
- 路由發現服務
- HTTP過濾器
- 緩存
- CORS過濾器
- DynamoDB
- 故障注入
- gRPC HTTP/1.1 橋接
- gRPC-JSON 轉碼過濾器
- gRPC-Web 過濾器
- 健康檢查
- Lua
- 速率限制
- 路由
- 集群管理
- 集群
- 健康檢查
- 熔斷
- TLS上下文
- 異常值檢測
- HASH環負載均衡配置
- 異常檢測
- 集群發現服務
- 服務發現服務
- 訪問日志
- 管理接口
- 限速服務
- 運行時配置
- 跟蹤
- V2 API參考
- 啟動引導
- 監聽&監聽發現
- 集群&集群發現
- 服務發現
- 健康檢查
- HTTP路由管理&發現
- TLS配置
- 通用的類型
- 網絡地址
- 協議選項
- 發現API
- 限速組件
- 過濾器
- 網絡過濾器
- TLS客戶端身份認證
- HTTP連接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP過濾器
- 緩存
- 故障注入
- 健康檢查
- Lua
- 速率限制
- 路由
- gRPC-JSON轉碼器
- 常見訪問日志類型
- 常見故障注入類型
- FAQ
- Envoy有多快?
- 我在哪里獲得二進制文件?
- 我如何設置SNI?
- 如何設置區域感知路由?
- 我如何設置Zipkin跟蹤?