服务网格 ASM：流量标签TrafficLabel说明

字段说明

ASM实例版本为1.17及以上的字段说明如下。

Spec

WorkloadSelector

TrafficLabelRule

Label

valueFrom

valueFrom支持以下四种变量。您可以展开表格下方的折叠面板，查看变量的详细说明。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: productpage-v1
  labels:
    app: productpage
    version: v1
spec:
  replicas: 1
  selector:
    matchLabels:
      app: productpage
      version: v1
  template:
    metadata:
      annotations:
        sidecar.istio.io/logLevel: debug
      labels:
        app: productpage
        version: v1
        ASM_TRAFFIC_TAG: test
    spec:
      serviceAccountName: bookinfo-productpage
      containers:
      - name: productpage
        image: docker.io/istio/examples-bookinfo-productpage-v1:1.16.2
        imagePullPolicy: IfNotPresent
        ports:
        - containerPort: 9080
        volumeMounts:
        - name: tmp
          mountPath: /tmp
      volumes:
      - name: tmp
        emptyDir: {}

配置示例

以下示例的ASM实例版本为1.17及以上。关于升级实例的具体操作，请参见升级ASM实例。

示例一：按照工作负载进行流量打标签

通过定义workloadSelector根据标签选择对应的工作负载，可以实现对某个命名空间下的工作负载进行流量打标签。

1. 部署bookinfo应用。具体操作，请参见在ASM实例关联的集群中部署应用。

2. 使用以下内容，创建productpage-trafficlabel.yaml文件。

   apiVersion: istio.alibabacloud.com/v1
   kind: TrafficLabel
   metadata:
     name: productpage
     namespace: default
   spec:
     workloadSelector:
       labels:
         app: productpage
     rules:
     - labels:
         - name: asm-labels-test-a
           valueFrom:
           - $getExternalInboundRequestHeader(header1, x-request-id)
           - $getLabel(header2)

3. 执行以下命令，对productpage工作负载进行流量打标签。

    kubectl apply -n default  -f productpage-trafficlabel.yaml

4. 执行以下命令，查看productpage工作负载对应的代理配置。

   kubectl exec -it -n default deploy/productpage-v1 -c istio-proxy -- curl localhost:15000/config_dump

   预期输出：

   {
                 "name": "com.aliyun.traffic_label",
                 "typed_config": {
                  "@type": "type.googleapis.com/envoy.config.filter.traffic_label.v3alpha.TrafficLabel",
                  
                 }
                },

   在对应的Listener Config（type.googleapis.com/envoy.admin.v3.ListenersConfigDump）/dynamic_listeners下的type.googleapis.com/envoy.config.listener.v3.Listener/envoy.filters.network.http_connection_manager/http_filters，可以看到上述的filter配置内容，表明流量标签配置成功。

5. 执行以下命令，查看其他工作负载（例如details Pod）对应的代理配置。

   kubectl exec -it -n default deploy/details-v1 -c istio-proxy -- curl localhost:15000/config_dump |grep type.googleapis.com/envoy.config.filter.traffic_label.v3alpha.TrafficLabel

   返回结果为空，表明没有相关的filter，符合预期。

示例二：按照命名空间进行流量打标签

如果不定义workloadSelector字段，将对命名空间下所有的工作负载进行流量打标签。以下示例将对命名空间default下的所有工作负载进行流量打标签。

1. 使用以下内容，创建all-workload-for-ns-trafficlabel.yaml文件。

   apiVersion: istio.alibabacloud.com/v1
   kind: TrafficLabel
   metadata:
     name: all-workload-for-ns
     namespace: default
   spec:
     rules:
     - labels:
         - name: asm-labels-test-b
           valueFrom:
           - $getExternalInboundRequestHeader(header1, x-request-id)
           - $getLabel(header2)

2. 执行以下命令，对命名空间default下的所有工作负载进行流量打标签。

    kubectl apply -n default -f all-workload-for-ns-trafficlabel.yaml

3. 执行以下命令，查看工作负载（例如details Pod）对应的代理的配置。

   kubectl exec -it -n default deploy/details-v1 -c istio-proxy -- curl localhost:15000/config_dump |grep type.googleapis.com/envoy.config.filter.traffic_label.v3alpha.TrafficLabel

   预期输出：

    "@type": "type.googleapis.com/envoy.config.filter.traffic_label.v3alpha.TrafficLabel",

   输出如上内容，表明流量标签配置成功。