使用 WebAssembly 插件扩展 waypoint

此功能针对开发人员/专家用户，被认为是 Alpha.

Istio 提供了使用 WebAssembly（Wasm）扩展其功能的能力。 Wasm 可扩展性的一个主要优势是可以在运行时动态加载扩展插件。 本文概述了如何在 Istio 中使用 Wasm 功能扩展 Ambient 模式。 在 Ambient 模式下，必须将 Wasm 配置应用到部署在每个命名空间中的 waypoint 代理。

开始之前

  1. 参照 Ambient 模式入门指南中的指示说明设置 Istio。

  2. 部署 Bookinfo 示例应用。

  3. 将 default 命名空间添加到 Ambient 网格。

  4. 部署 sleep 样例应用，用作发送请求的测试源。

    Zip

    1. $ kubectl apply -f @samples/sleep/sleep.yaml@

在网关处

Istio 使用 Kubernetes Gateway API，提供了一个集中的入口点来管理进入服务网格的流量。 我们将在网关级别配置一个 WasmPlugin，确保所有通过网关的流量都遵循扩展的身份验证规则。

为网关配置 WebAssembly 插件

在此示例中，您将向网格添加一个 HTTP 基本的身份验证模块。 您将配置 Istio 从远程镜像仓库中拉取并加载基本身份验证模块。 此模块将被配置为在调用 /productpage 时运行。 这些步骤与分发 WebAssembly 模块大致相同， 区别是推荐使用 targetRefs 而不是标签选择算符。

要使用远程 Wasm 模块配置一个 WebAssembly 过滤器， 请创建一个指向 bookinfo-gateway 的 WasmPlugin 资源：

  1. $ kubectl get gateway
  2. NAME               CLASS            ADDRESS                                            PROGRAMMED   AGE
  3. bookinfo-gateway   istio            bookinfo-gateway-istio.default.svc.cluster.local   True         42m
  1. $ kubectl apply -f - <<EOF
  2. apiVersion: extensions.istio.io/v1alpha1
  3. kind: WasmPlugin
  4. metadata:
  5.   name: basic-auth-at-gateway
  6. spec:
  7.   targetRefs:
  8.     - kind: Gateway
  9.       group: gateway.networking.k8s.io
  10.       name: bookinfo-gateway # gateway name retrieved from previous step
  11.   url: oci://ghcr.io/istio-ecosystem/wasm-extensions/basic_auth:1.12.0
  12.   phase: AUTHN
  13.   pluginConfig:
  14.     basic_auth_rules:
  15.       - prefix: "/productpage"
  16.         request_methods:
  17.           - "GET"
  18.           - "POST"
  19.         credentials:
  20.           - "ok:test"
  21.           - "YWRtaW4zOmFkbWluMw=="
  22. EOF

HTTP 过滤器将被作为身份验证过滤器注入网关。 Istio 代理将解释 WasmPlugin 配置，从 OCI 镜像仓库下载远程 Wasm 模块到本地文件， 并通过引用该文件在网关处注入 HTTP 过滤器。

通过网关来验证流量

  1. 在没有凭据的情况下测试 /productpage：

    1. $ kubectl exec deploy/sleep -- curl -s -w "%{http_code}" -o /dev/null "http://bookinfo-gateway-istio.default.svc.cluster.local/productpage"
    2. 401

  2. 使用 WasmPlugin 资源中配置的凭据来测试 /productpage：

    1. $ kubectl exec deploy/sleep -- curl -s -o /dev/null -H "Authorization: Basic YWRtaW4zOmFkbWluMw==" -w "%{http_code}" "http://bookinfo-gateway-istio.default.svc.cluster.local/productpage"
    2. 200

在 waypoint 处设置命名空间中的所有服务

waypoint 代理在 Istio 的 Ambient 模式中扮演了一个重要的角色：在服务网格内确保通讯安全和高效。 下文将探索如何将 Wasm 配置应用到 waypoint，动态增强代理功能。

部署 waypoint 代理

遵循 waypoint 部署说明将 waypoint 代理部署到 bookinfo 命名空间中。

  1. $ istioctl waypoint apply --enroll-namespace --wait

验证到达服务的流量：

  1. $ kubectl exec deploy/sleep -- curl -s -w "%{http_code}" -o /dev/null http://productpage:9080/productpage
  2. 200

为 waypoint 配置 WebAssembly 插件

要使用远程 Wasm 模块配置 WebAssembly 过滤器， 请创建指向 waypoint 网关的 WasmPlugin 资源：

  1. $ kubectl get gateway
  2. NAME               CLASS            ADDRESS                                            PROGRAMMED   AGE
  3. bookinfo-gateway   istio            bookinfo-gateway-istio.default.svc.cluster.local   True         23h
  4. waypoint           istio-waypoint   10.96.202.82                                       True         21h
  1. $ kubectl apply -f - <<EOF
  2. apiVersion: extensions.istio.io/v1alpha1
  3. kind: WasmPlugin
  4. metadata:
  5.   name: basic-auth-at-waypoint
  6. spec:
  7.   targetRefs:
  8.     - kind: Gateway
  9.       group: gateway.networking.k8s.io
  10.       name: waypoint # gateway name retrieved from previous step
  11.   url: oci://ghcr.io/istio-ecosystem/wasm-extensions/basic_auth:1.12.0
  12.   phase: AUTHN
  13.   pluginConfig:
  14.     basic_auth_rules:
  15.       - prefix: "/productpage"
  16.         request_methods:
  17.           - "GET"
  18.           - "POST"
  19.         credentials:
  20.           - "ok:test"
  21.           - "YWRtaW4zOmFkbWluMw=="
  22. EOF

查看配置的插件

  1. $ kubectl get wasmplugin
  2. NAME                     AGE
  3. basic-auth-at-gateway    28m
  4. basic-auth-at-waypoint   14m

通过 waypoint 代理来验证流量

  1. 在不含凭据的情况下测试内部 /productpage：

    1. $ kubectl exec deploy/sleep -- curl -s -w "%{http_code}" -o /dev/null http://productpage:9080/productpage
    2. 401

  2. 在有凭据的情况下测试内部 /productpage：

    1. $ kubectl exec deploy/sleep -- curl -s -w "%{http_code}" -o /dev/null -H "Authorization: Basic YWRtaW4zOmFkbWluMw==" http://productpage:9080/productpage
    2. 200

在 waypoint 处设置特定的服务

要为特定服务使用远程 Wasm 模块配置 WebAssembly 过滤器， 请直接创建指向特定服务的 WasmPlugin 资源。

创建一个指向 reviews 服务的 WasmPlugin，以便此扩展仅适用于 reviews 服务。 在此配置中，身份验证令牌和前缀是专门为 reviews 服务定制的， 确保只有指向它的请求才会受到此身份验证机制的影响。

  1. $ kubectl apply -f - <<EOF
  2. apiVersion: extensions.istio.io/v1alpha1
  3. kind: WasmPlugin
  4. metadata:
  5.   name: basic-auth-for-service
  6. spec:
  7.   targetRefs:
  8.     - kind: Service
  9.       group: ""
  10.       name: reviews
  11.   url: oci://ghcr.io/istio-ecosystem/wasm-extensions/basic_auth:1.12.0
  12.   phase: AUTHN
  13.   pluginConfig:
  14.     basic_auth_rules:
  15.       - prefix: "/reviews"
  16.         request_methods:
  17.           - "GET"
  18.           - "POST"
  19.         credentials:
  20.           - "ok:test"
  21.           - "MXQtaW4zOmFkbWluMw=="
  22. EOF

验证指向服务的流量

  1. 使用通用 waypoint 代理处配置的凭据来测试内部 /productpage：

    1. $ kubectl exec deploy/sleep -- curl -s -w "%{http_code}" -o /dev/null -H "Authorization: Basic YWRtaW4zOmFkbWluMw==" http://productpage:9080/productpage
    2. 200

  2. 使用特定的 reviews-svc-waypoint 代理处配置的凭据来测试内部 /reviews：

    1. $ kubectl exec deploy/sleep -- curl -s -w "%{http_code}" -o /dev/null -H "Authorization: Basic MXQtaW4zOmFkbWluMw==" http://reviews:9080/reviews/1
    2. 200

  3. 在没有凭据的情况下测试内部 /reviews：

    1. $ kubectl exec deploy/sleep -- curl -s -w "%{http_code}" -o /dev/null http://reviews:9080/reviews/1
    2. 401

当在没有凭据的情况下执行提供的命令时，它会验证访问内部 /productpage 会造成 401 未经授权的响应，这确认了在没有正确身份验证凭据的情况下访问资源会失败的预期行为。

清理

  1. 移除 WasmPlugin 配置：

    1. $ kubectl delete wasmplugin basic-auth-at-gateway basic-auth-at-waypoint basic-auth-for-service

  2. 参考 Ambient 模式卸载指南移除 Istio 和样例测试应用。