云原生自定义插件示例: envoy-extproc-caching-demo-go¶
Envoy-extproc-method-conv-demo-go是一个基于 envoy-extproc-sdk-go实现的,用以展示如何在 Go 语言中使用 Envoy 提供的 ext_proc 功能的示例。
功能¶
主要功能是使用一个非持久化存储来缓存由 Downstream 发起的 GET 请求的应答,针对某个 path 的第一次请求将由 Upstream 响应并被 Caching 缓存; 之后所有针对此 Path 的请求,将由 Caching 直接应答,而不再路由到 Upstream,直到 Caching 重启.以达到响应体缓存的目的。
前置条件¶
- 安装 Envoy (Version >= v1.29)
- 安装 Go (Verson >= v1.21) 如果只是运行,可跳过此步
-
支持 HTTP Method:GET 的目标服务(以下简称 Upstream),且假设其支持以下 route:
/*
/no-extproc
编译¶
进入项目根目录(如果只是运行,可跳过此步)。
运行¶
-
Envoy:
- 此文件位于项目根目录
-
Caching:
-
裸金属
-
K8s
- 此文件位于项目根目录
-
-
Curl:
- Caching 不会作用于此 route,每次请求都将由 Upstream 应答
- 第一次请求将由 Upstream 应答,并被 Caching 缓存,后续针对 /abc 的请求将会由 Caching 直接应答
参数说明¶
- log-stream:是否输出关于请求/响应流的日志
- log-phases:是否输出各处理阶段的日志
- update-extproc-header:是否在响应头中添加此插件的名字
- update-duration-header:在结束流时,响应头中添加总处理时间
以上参数默认均为 false
- payload-limit 32:请求体最大允许长度为 32 字节
注意事项¶
-
此示例只支持 HTTP Method: GET
-
processing_mode 的配置项中的 request_header_mode 及 response_body_mode 必须配置为 下图 红框中的选项