• 工具
    • 配置加载检查工具
    • 路由表检查工具
    • 模式验证检查工具
  • 返回

    工具

    配置加载检查工具

    配置加载检查工具校验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中传递的模式类型。支持的类型是:
      • route - 用于路由配置验证;
    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

    返回

    • 上一级
    • 首页目录