Alibaba Cloud Service Mesh:Label traffic

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Une instance ASM exécutant la version 1.17 ou ultérieure

• Un cluster Kubernetes associé à votre instance ASM

• kubectl configuré pour se connecter au cluster

Fonctionnement de l'étiquetage du trafic

Une ressource TrafficLabel définit deux éléments :

1. Portée : les charges de travail à étiqueter (toutes les charges de travail d'un namespace ou un sous-ensemble sélectionné par des étiquettes de pod).

2. Règles : l'emplacement d'extraction de la valeur de l'étiquette (en-têtes de requête, étiquettes de pod ou contexte de trace).

Lorsqu'une requête entre dans une passerelle ou un proxy sidecar, le proxy évalue les règles TrafficLabel, résout une valeur d'étiquette et l'ajoute en tant que nouvel en-tête aux requêtes sortantes. Les services en aval peuvent ensuite utiliser cet en-tête pour prendre des décisions de routage.

apiVersion: istio.alibabacloud.com/v1
kind: TrafficLabel
metadata:
  name: <label-name>              # Name of this TrafficLabel resource
  namespace: <namespace>          # Namespace where this resource applies
spec:
  workloadSelector:               # (Optional) Omit to apply to all workloads in the namespace
    labels:
      <key>: <value>              # Match workloads by label, e.g., app: productpage
  rules:
  - labels:
    - name: <traffic-label-name>  # Header name for the label (must follow HTTP header naming rules)
      valueFrom:
      - <variable-1>             # Primary source for the label value
      - <variable-2>             # Fallback if variable-1 returns empty

Référence des champs

Variables valueFrom

Le champ valueFrom accepte une liste ordonnée de variables. Le proxy les évalue séquentiellement et utilise le premier résultat non vide comme valeur de l'étiquette.

Les quatre variables se divisent en deux groupes selon leur champ d'application :

Client request                    Gateway                         Upstream service
     |                              |                                   |
     |-- headerName: tagValue ----->|                                   |
     |                              |-- userDefinedLabel: tagValue ---->|
     |                              |                                   |

Inbound request       Sidecar proxy (context map)          Outbound request
     |                         |                                 |
     |-- headerName: tagValue  |                                 |
     |-- contextId: ctx123 --->| store: ctx123 -> tagValue       |
     |                         |                                 |
     |          App initiates outbound request                   |
     |                         |-- contextId: ctx123 ----------->|
     |                         |   (lookup: ctx123 -> tagValue)  |
     |                         |-- headerName: tagValue -------->|
     |                         |-- userDefinedLabel: tagValue -->|

Application container          Sidecar proxy              Upstream service
     |                              |                          |
     |-- headerName: tagValue ----->|                          |
     |                              |-- userDefinedLabel: tagValue -->|
     |                              |                          |

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    # This value is read by $getLabel(ASM_TRAFFIC_TAG)
    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: {}

Étiqueter le trafic pour une charge de travail spécifique

Cet exemple étiquette le trafic de la charge de travail productpage. La valeur de l'étiquette est résolue à partir de l'en-tête de requête entrante header1 (corrélé par x-request-id), avec un repli sur l'étiquette de pod header2.

Les deux exemples de cette page nécessitent ASM 1.17 ou une version ultérieure et utilisent l'application exemple Bookinfo.

1. Déployez l'application Bookinfo. Consultez la rubrique Déployer une application dans une instance ASM.

2. Enregistrez le YAML suivant dans le fichier productpage-trafficlabel.yaml :

      apiVersion: istio.alibabacloud.com/v1
      kind: TrafficLabel
      metadata:
        name: productpage
        namespace: default
      spec:
        workloadSelector:
          labels:
            app: productpage          # Only applies to the productpage workload
        rules:
        - labels:
          - name: asm-labels-test-a   # Outbound header name for the label
            valueFrom:
            - $getExternalInboundRequestHeader(header1, x-request-id)  # Primary: read from inbound header
            - $getLabel(header2)                                        # Fallback: read from pod label

3. Appliquez la ressource :

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

4. Vérifiez que le filtre Envoy a été injecté dans le proxy productpage : recherchez le filtre com.aliyun.traffic_label sous dynamic_listeners ou http_filters :

      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",
          ...
        }
      }

5. Confirmez que les charges de travail non sélectionnées ne sont pas affectées. Exécutez la même vérification sur le pod details : un résultat vide confirme qu'aucun filtre d'étiquetage n'a été injecté, comme prévu.

      kubectl exec -it -n default deploy/details-v1 -c istio-proxy -- \
        curl localhost:15000/config_dump | grep traffic_label

Étiqueter le trafic au niveau du namespace

Omettez workloadSelector pour étiqueter le trafic de toutes les charges de travail d'un namespace. Cet exemple étiquette toutes les charges de travail du namespace default.

1. Enregistrez le YAML suivant dans le fichier all-workload-for-ns-trafficlabel.yaml :

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

2. Appliquez la ressource :

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

3. Vérifiez que le filtre d'étiquetage est désormais présent sur toutes les charges de travail. Vérifiez le pod details : Résultat attendu : le filtre est maintenant injecté dans chaque charge de travail du namespace.

      kubectl exec -it -n default deploy/details-v1 -c istio-proxy -- \
        curl localhost:15000/config_dump | grep traffic_label

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

Rubriques connexes

• Déployer une application dans une instance ASM : configurez les charges de travail dans votre maillage avant de configurer les étiquettes de trafic.

• Activer le traçage distribué dans ASM : propagez les en-têtes de trace requis par $getExternalInboundRequestHeader.

• Mettre à jour une instance ASM : effectuez une mise à niveau vers ASM 1.17 ou ultérieur si vous utilisez une version plus ancienne.