Alibaba Cloud Service Mesh:トラフィックのラベル付け

$getInboundRequestHeader(headerName)

ゲートウェイへ到達するインバウンドリクエストから headerName ヘッダーを読み取ります。ゲートウェイは、TrafficLabel CRD で定義されたラベル名をキー、抽出された値を値として、新しいアウトバウンドヘッダーを追加します。

headerName を空欄のままにした場合、デフォルトで x-asm-prefer-tag ヘッダーが読み取られます。

データフロー:

クライアントリクエスト                    ゲートウェイ                         上流サービス
     |                              |                                   |
     |-- headerName: tagValue ----->|                                   |
     |                              |-- userDefinedLabel: tagValue ---->|
     |                              |                                   |

$getExternalInboundRequestHeader(headerName, contextId)

サイドカープロキシへ到達するインバウンドリクエストから headerName ヘッダーを読み取り、その値を contextId をキーとする内部コンテキストマップに格納します。このマップは Envoy のメモリ上にデフォルトで 30 秒間保持されます。

パラメーター（両方とも必須）:

コンテキストマップの動作:

1. インバウンドリクエストがサイドカープロキシに到達します。プロキシは headerName を読み取り、tagValue を取得して、map<contextId, tagValue> として格納します。

2. アプリケーションがアウトバウンドリクエストを開始すると、プロキシはコンテキストマップ内で contextId を検索します。

3. 一致が見つかった場合、プロキシはアウトバウンドリクエストに以下の 2 つのヘッダーを追加します。

   • headerName: tagValue

   • userDefinedLabel: tagValue（TrafficLabel CRD で定義されたラベル名を使用）

データフロー:

インバウンドリクエスト       サイドカープロキシ（コンテキストマップ）          アウトバウンドリクエスト
     |                         |                                 |
     |-- headerName: tagValue  |                                 |
     |-- contextId: ctx123 --->| store: ctx123 -> tagValue       |
     |                         |                                 |
     |          アプリケーションがアウトバウンドリクエストを開始         |
     |                         |-- contextId: ctx123 ----------->|
     |                         |   （検索：ctx123 -> tagValue）  |
     |                         |-- headerName: tagValue -------->|
     |                         |-- userDefinedLabel: tagValue -->|

$getLocalOutboundRequestHeader(headerName)

アプリケーションがサイドカープロキシに送信するアウトバウンドリクエストから headerName ヘッダーを読み取ります。プロキシは、TrafficLabel CRD で定義されたラベル名をキー、抽出された値を値として、新しいアウトバウンドヘッダーを追加します。

アプリケーション自体がアウトバウンドリクエストにヘッダーを設定する場合に、この変数を使用します。

データフロー:

アプリケーションコンテナ          サイドカープロキシ              上流サービス
     |                              |                          |
     |-- headerName: tagValue ----->|                          |
     |                              |-- userDefinedLabel: tagValue -->|
     |                              |                          |

$getLabel(labelName)

ゲートウェイ Pod またはサイドカープロキシワークロード Pod の labelName ラベルを読み取り、その値をアウトバウンドトラフィックに付与します。labelName を空欄のままにした場合、プロキシはデフォルトで ASM_TRAFFIC_TAG ラベルを読み取ります。

例: Deployment Pod に ASM_TRAFFIC_TAG: test というラベルが設定されている場合、変数 $getLabel(ASM_TRAFFIC_TAG) は test を返します。

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