提供了编程的基础技术教程

zl程序教程

您现在的位置是：首页 >  其他

当前栏目

Linkerd SMI 扩展入门

入门
2023-03-14 22:51:29 时间

内容整理来自于官方文档

Service Mesh Interface 是 Kubernetes 上服务网格的标准接口。它定义了一组资源，可用于实现该资源的服务网格。您可以在规范中阅读有关它的更多信息。

  • https://smi-spec.io/
  • https://github.com/servicemeshinterface/smi-spec

目前，Linkerd 支持 SMI 的 TrafficSplit 规范， 该规范可用于在本地执行跨服务的流量拆分。这意味着您可以在没有任何额外组件/配置的情况下应用 SMI 资源， 但这显然有一些缺点，因为 Linkerd 可能无法添加特定于它的额外特定配置， 因为 SMI 更像是服务网格功能的最小公分母。

为了解决这些问题，Linkerd 可以使用一个适配器， 将 SMI 规范转换为它可以理解和执行操作的原生 Linkerd 配置。这也消除了与 SMI 资源与控制平面的额外原生耦合， 并且适配器可以独立移动并拥有自己的发布周期。Linkerd SMI 是一个可以做到这一点的扩展。

  • https://www.github.com/linkerd/linkerd-smi

本指南将引导您安装 SMI 扩展并配置 TrafficSplit 规范，以跨服务执行流量拆分(Traffic Splitting)。

前提条件

  • 要使用本指南，您需要在集群上安装 Linkerd。

安装 Linkerd-SMI 扩展

CLI

通过运行以下命令安装 SMI 扩展 CLI 二进制文件：

curl -sL https://linkerd.github.io/linkerd-smi/install | sh

或者，您可以直接通过发布页面下载 CLI。

  • https://github.com/linkerd/linkerd-smi/releases

第一步是将 Linkerd-SMI 扩展安装到您的集群上。此扩展包含一个 SMI-Adaptor，可将 SMI 资源转换为原生 Linkerd 资源。

要安装 Linkerd-SMI 扩展，请运行以下命令：

linkerd smi install | kubectl apply -f -

您可以通过运行以下命令来验证 Linkerd-SMI 扩展是否已正确安装：

linkerd smi check

Helm

要安装 linkerd-smi Helm chart，请运行：

helm repo add l5d-smi https://linkerd.github.io/linkerd-smi
helm install l5d-smi/linkerd-smi --generate-name

安装示例应用程序

首先，让我们安装示例应用程序。

# create a namespace for the sample application
kubectl create namespace trafficsplit-sample

# install the sample application
linkerd inject https://raw.githubusercontent.com/linkerd/linkerd2/main/test/integration/trafficsplit/testdata/application.yaml | kubectl -n trafficsplit-sample apply -f -

这将安装一个简单的客户端和两个服务器部署。服务器部署之一，即 faling-svc 总是返回 500 错误， 而另一个，即 backend-svc 总是返回 200。

kubectl get deployments -n trafficsplit-sample
NAME          READY   UP-TO-DATE   AVAILABLE   AGE
backend       1/1     1            1           2m29s
failing       1/1     1            1           2m29s
slow-cooker   1/1     1            1           2m29s

默认情况下，客户端将访问 backend-svc 服务。这在 edges 子命令中很明显。

linkerd viz edges deploy -n trafficsplit-sample
SRC           DST           SRC_NS                DST_NS                SECURED
prometheus    backend       linkerd-viz           trafficsplit-sample   √
prometheus    failing       linkerd-viz           trafficsplit-sample   √
prometheus    slow-cooker   linkerd-viz           trafficsplit-sample   √
slow-cooker   backend       trafficsplit-sample   trafficsplit-sample   √

配置流量拆分

现在，让我们应用一个 TrafficSplit 资源在 backend-svc 上执行流量拆分， 以在它和 failing-svc 之间分配负载。

cat <<EOF | kubectl apply -f -
apiVersion: split.smi-spec.io/v1alpha2
kind: TrafficSplit
metadata:
  name: backend-split
  namespace: trafficsplit-sample
spec:
  service: backend-svc
  backends:
  - service: backend-svc
    weight: 500
  - service: failing-svc
    weight: 500
EOF

因为 smi-adaptor 监视 TrafficSplit 资源， 它会自动创建相应的 ServiceProfile 资源来执行相同的操作。这可以通过检索 ServiceProfile 资源来验证。

kubectl describe serviceprofile -n trafficsplit-sample
Name:         backend-svc.trafficsplit-sample.svc.cluster.local
Namespace:    trafficsplit-sample
Labels:       <none>
Annotations:  <none>
API Version:  linkerd.io/v1alpha2
Kind:         ServiceProfile
Metadata:
  Creation Timestamp:  2021-08-02T12:42:52Z
  Generation:          1
  Managed Fields:
    API Version:  linkerd.io/v1alpha2
    Fields Type:  FieldsV1
    fieldsV1:
      f:spec:
        .:
        f:dstOverrides:
    Manager:         smi-adaptor
    Operation:       Update
    Time:            2021-08-02T12:42:52Z
  Resource Version:  3542
  UID:               cbcdb74f-07e0-42f0-a7a8-9bbcf5e0e54e
Spec:
  Dst Overrides:
    Authority:  backend-svc.trafficsplit-sample.svc.cluster.local
    Weight:     500
    Authority:  failing-svc.trafficsplit-sample.svc.cluster.local
    Weight:     500
Events:         <none>

正如我们所见，已经创建了一个带有 DstOverrides 的相关 ServiceProfile 来执行 TrafficSplit。

可以通过运行 edges 命令来验证流量拆分。

linkerd viz edges deploy -n trafficsplit-sample
SRC           DST           SRC_NS                DST_NS                SECURED
prometheus    backend       linkerd-viz           trafficsplit-sample   √
prometheus    failing       linkerd-viz           trafficsplit-sample   √
prometheus    slow-cooker   linkerd-viz           trafficsplit-sample   √
slow-cooker   backend       trafficsplit-sample   trafficsplit-sample   √
slow-cooker   failing       trafficsplit-sample   trafficsplit-sample   √

这也可以通过在 TrafficSplit 资源上运行 stat 子命令来验证。

linkerd viz stat ts/backend-split -n traffic-sample
NAME            APEX          LEAF          WEIGHT   SUCCESS      RPS   LATENCY_P50   LATENCY_P95   LATENCY_P99
backend-split   backend-svc   backend-svc      500   100.00%   0.5rps           1ms           1ms           1ms
backend-split   backend-svc   failing-svc      500     0.00%   0.5rps           1ms           1ms           1ms

这也可以通过检查 smi-adaptor 日志来验证。

kubectl -n linkerd-smi logs deploy/smi-adaptor smi-adaptor
time="2021-08-04T11:04:35Z" level=info msg="Using cluster domain: cluster.local"
time="2021-08-04T11:04:35Z" level=info msg="Starting SMI Controller"
time="2021-08-04T11:04:35Z" level=info msg="Waiting for informer caches to sync"
time="2021-08-04T11:04:35Z" level=info msg="starting admin server on :9995"
time="2021-08-04T11:04:35Z" level=info msg="Starting workers"
time="2021-08-04T11:04:35Z" level=info msg="Started workers"
time="2021-08-04T11:05:17Z" level=info msg="created serviceprofile/backend-svc.trafficsplit-sample.svc.cluster.local for trafficsplit/backend-split"
time="2021-08-04T11:05:17Z" level=info msg="Successfully synced 'trafficsplit-sample/backend-split'"

清理

通过运行以下命令删除 trafficsplit-sample 资源

kubectl delete namespace/trafficsplit-sample

结论

不过，Linkerd 目前支持直接读取 TrafficSplit 资源，ServiceProfiles 总是优先于 TrafficSplit 资源。将在进一步的版本中删除对 TrafficSplit 资源的支持，在该版本中，需要 linkerd-smi 扩展以将 SMI 资源与 Linkerd 一起使用。

相关文章