Alibaba Cloud Service Mesh:Label traffic

Ön koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• 1,17 veya sonraki bir sürümü çalışan bir ASM örneği

• ASM örneğinizle ilişkili bir Kubernetes kümesi

• Kümeye bağlanacak şekilde yapılandırılmış kubectl

Trafik etiketlemenin çalışma biçimi

Bir TrafficLabel kaynağı iki unsuru tanımlar:

1. Kapsam -- Hangi iş yüklerinin etiketleneceği (bir ad alanındaki tüm iş yükleri veya pod etiketleriyle seçilen bir alt küme).

2. Kurallar -- Etiket değerinin nereden alınacağı (istek başlıkları, pod etiketleri veya izlem bağlamı).

Bir istek bir ağ geçidine veya sidecar proxy'sine girdiğinde proxy, TrafficLabel kurallarını değerlendirir, bir etiket değeri çözümler ve bunu giden isteklere yeni bir başlık olarak ekler. Aşağı akış hizmetleri daha sonra yönlendirme kararları için bu başlığı eşleştirebilir.

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

Alan referansı

valueFrom değişkenleri

valueFrom alanı, sıralı bir değişken listesini kabul eder. Proxy bunları sırayla değerlendirir ve etiket değeri olarak ilk boş olmayan sonucu kullanır.

Dört değişken, uygulandıkları yere göre iki gruba ayrılır:

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: {}

Belirli bir iş yükü için trafiği etiketleme

Bu örnek, productpage iş yükünün trafiğini etiketler. Etiket değeri, gelen istek başlığı header1 (x-request-id ile ilişkilendirilmiş) üzerinden çözümlenir ve yedek olarak pod etiketi header2 kullanılır.

Bu sayfadaki her iki örnek de ASM 1.17 veya sonraki bir sürüm gerektirir ve Bookinfo örnek uygulamasını kullanır.

1. Bookinfo uygulamasını dağıtın. Bkz. ASM örneğinde uygulama dağıtma.

2. Aşağıdaki YAML'i productpage-trafficlabel.yaml dosyasına kaydedin:

      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. Kaynağı uygulayın:

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

4. Envoy filtresinin productpage proxy'sine enjekte edildiğini doğrulayın: dynamic_listeners veya http_filters altında com.aliyun.traffic_label filtresini arayın:

      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. Seçilmemiş iş yüklerinin etkilenmediğini onaylayın. Aynı kontrolü details podu üzerinde çalıştırın: Boş sonuç, beklendiği gibi hiçbir etiketleme filtresinin enjekte edilmediğini doğrular.

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

Ad alanı düzeyinde trafiği etiketleme

Bir ad alanındaki tüm iş yükleri için trafiği etiketlemek amacıyla workloadSelector alanını atlayın. Bu örnek, default ad alanındaki tüm iş yüklerini etiketler.

1. Aşağıdaki YAML'i all-workload-for-ns-trafficlabel.yaml dosyasına kaydedin:

      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. Kaynağı uygulayın:

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

3. Etiketleme filtresinin artık tüm iş yüklerinde bulunduğunu doğrulayın. details podunu kontrol edin: Beklenen çıktı: Filtre artık ad alanındaki her iş yüküne enjekte edilmiştir.

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

İlgili konular

• ASM örneğinde uygulama dağıtma -- Trafik etiketlerini yapılandırmadan önce ağınızda iş yüklerini kurun.

• ASM'de dağıtılmış izlemeyi etkinleştirme -- $getExternalInboundRequestHeader tarafından gereken iz başlıklarını yayma.

• ASM örneğini güncelleme -- Daha eski bir sürüm kullanıyorsanız ASM 1.17+ sürümüne yükseltin.