乐趣区

关于apisix:服务网格|如何使用-Amesh-配置插件

作者 @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 controller
kubectl 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.yaml
kubectl -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/v1alpha1
kind: AmeshPluginConfig
metadata:
  name: ameshpluginconfig-sample
spec:
  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: APISIX
Server: APISIX/2.15.0
X-Header: Rewrite

BODY_REWRITE

更新插件配置

将示例 AmeshPluginConfig 文件批改为如下,移除 Body 配置:

apiVersion: apisix.apache.org/v1alpha1
kind: AmeshPluginConfig
metadata:
  name: ameshpluginconfig-sample
spec:
  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/v1alpha1
kind: AmeshPluginConfig
metadata:
  name: faultinjection-sample
spec:
  plugins:
  - name: fault-injection
    config: '{"abort": {"http_status": 200,"body":"Fault Injection!"}'

总结

本文以 response-rewrite 插件为例,演示了 Amesh v0.2 版本新增的插件配置性能。在理论应用中,用户能够依据须要,为 Amesh 配置适宜的 APISIX 中已有的插件。也欢送各位在实践中进行体验,并反馈更多对于服务网格的想法。

退出移动版