服务网格｜如何使用 Amesh 配置插件

2023-01-12
黑龙江
本文字数：1677 字
阅读完需：约 6 分钟

作者 @lingsamuel，API7.ai 云原生技术专家，Apache APISIX Committer。

在上一篇 Amesh 产品介绍中，我们有提到在 Amesh v2.0 版本新增了一个可选的控制面组件，即 amesh-controller 及相应的 CRD。Amesh controller 为用户提供了配置 APISIX 插件的能力，使 APISIX 众多的插件在服务网格场景下也能开箱即用，而无需用户进行自定义的开发。

那么如何使用这些组件，来进行 APISIX 插件能力的使用呢？本文在假设已经成功安装 Amesh 后，如何在 Amesh 中进行部署、配置和更新插件等操作。

部署 Amesh Controller 与 CRD

使用如下命令部署 Amesh Controller 与 CRD：

cd controllerkubectl apply -k ./config/crd/helm install amesh-controller -n istio-system ./charts/amesh-controller

复制代码

默认情况下，Amesh 将会自动连接到位于 istio-system namespace 下的 amesh-controller 服务 15810 端口，而无需重启 Sidecar。

如需自定义，可以使用 AMESH_GRPC_SOURCE 环境变量进行配置。该变量默认值为 "grpc://amesh-controller.istio-system.svc:15810"，按需指定到对应的 amesh-controller 即可。

部署示例应用

这里我们以 Istio 提供的 Bookinfo 应用为测试用例。

# 在 Istio 目录下执行kubectl -n test apply -f samples/bookinfo/platform/kube/bookinfo.yamlkubectl -n test run consumer --image curlimages/curl --image-pull-policy IfNotPresent --command sleep 1d

复制代码

测试是否能够正常访问：

kubectl -n test exec -it -c istio-proxy consumer -- curl -i -XGET "http://productpage:9080/productpage" | grep -o "<title>.*</title>"

复制代码

输出细节类似如下所示：

<title>Simple Bookstore App</title>

复制代码

配置示例插件

本文将以 response-rewrite 插件为例进行演示。首先为集群应用下列示例配置：

apiVersion: apisix.apache.org/v1alpha1kind: AmeshPluginConfigmetadata:  name: ameshpluginconfig-samplespec:  plugins:    - name: response-rewrite      config: '{"body": "BODY_REWRITE", "headers": {"X-Header":"Rewrite"}}'

复制代码

尝试访问测试负载：

kubectl -n test exec -it -c istio-proxy consumer -- curl -i -XGET "http://productpage:9080/productpage"

复制代码

输出细节应该包含如下内容：

Via: APISIXServer: APISIX/2.15.0X-Header: Rewrite
BODY_REWRITE

复制代码

更新插件配置

将示例 AmeshPluginConfig 文件修改为如下，移除 Body 配置：

apiVersion: apisix.apache.org/v1alpha1kind: AmeshPluginConfigmetadata:  name: ameshpluginconfig-samplespec:  plugins:  - name: response-rewrite    config: '{"headers": {"X-Header":"Rewrite"}}'

复制代码

再次请求测试负载：

kubectl -n test exec -it -c istio-proxy consumer -- curl -i -XGET "http://productpage:9080/productpage" | grep -o "<title>.*</title>"

复制代码

输出应该包含如下内容：

<title>Simple Bookstore App</title>

复制代码

这表明响应 Body 没有被重写，符合我们的预期。下面的命令可以验证 Header 是否被正常重写：

kubectl -n test exec -it -c istio-proxy consumer -- curl -i -XGET "http://productpage:9080/productpage" | grep "X-Header"

复制代码

输出内容如下所示：

X-Header: Rewrite

复制代码

其他场景

除了上文演示的 response-rewrite 插件之外，Amesh 还支持配置 APISIX 的所有插件。用户可以根据需要进行配置。

例如，当需要进行故障注入时，只需要将配置中的插件名改为 fault-injection，插件配置改为 '{"abort": { "http_status": 200, "body": "Fault Injection!" }' 即可实现，具体如下所示：

apiVersion: apisix.apache.org/v1alpha1kind: AmeshPluginConfigmetadata:  name: faultinjection-samplespec:  plugins:  - name: fault-injection    config: '{"abort": { "http_status": 200, "body": "Fault Injection!" }'

复制代码

总结

本文以 response-rewrite 插件为例，演示了 Amesh v0.2 版本新增的插件配置功能。在实际使用中，用户可以根据需要，为 Amesh 配置适合的 APISIX 中已有的插件。也欢迎各位在实践中进行体验，并反馈更多关于服务网格的想法。

发布于: 刚刚阅读数: 4

原文链接:【http://xie.infoq.cn/article/18457fde7be3f9341a1ca5866】。

Apache APISIX 中文社区

关注

https://apisix.apache.org/ 2021-06-02 加入

Apache APISIX 是一个动态、实时、高性能的云原生 API 网关，提供了负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。

发布

暂无评论

创作场景

服务网格｜如何使用 Amesh 配置插件

部署 Amesh Controller 与 CRD

部署示例应用

配置示例插件

更新插件配置

其他场景

总结

Apache APISIX 中文社区

评论