工具

配置加载检查工具

配置加载检查工具校验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在其他测试通过时失败。该测试案例中,将打印冲突详细信息。

  1. Test_1
  2. Test_2
  3. default other virtual_host_name
  4. Test_3
  5. Test_4
  6. Test_5
  7. locations ats cluster_name
  8. 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是否符合配置规范。要验证整个配置,请参阅上述配置加载检查工具章节。目前只支持路由配置模式验证。

输入

该工具需要两个输入:

  1. 检查在JSON中传递的模式类型。支持的类型是:
  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

返回