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

フィールドの説明

このセクションでは、バージョン 1.17 以降の ASM インスタンスの CRD フィールドについて説明します。

Spec

WorkloadSelector

TrafficLabelRule

Label

valueFrom

valueFrom フィールドでは、次の 4 つの変数がサポートされています。表の下にある対応する展開アイコンをクリックすると、変数の説明を表示できます。

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 インスタンスの更新方法の詳細については、「ASM インスタンスを更新する」をご参照ください。

例 1：ワークロードのトラフィックのラベル付け

workloadSelector を定義してラベルに基づいてワークロードを選択し、名前空間内のワークロードのトラフィックにラベルを付けることができます。

1. Bookinfo アプリケーションをデプロイします。 詳細については、「ASM インスタンスに追加された ACK クラスターにアプリケーションをデプロイする」をご参照ください。

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

   上記の filter 設定は、リスナー設定（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 で確認できます。 これは、トラフィックラベルが設定されていることを示します。

5. 次のコマンドを実行して、他のワークロード（details ポッドなど）のプロキシ設定を表示します。

   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 がないことを示しています。 結果は予想どおりです。

例 2：名前空間レベルでのトラフィックのラベル付け

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 ポッドなど）のプロキシ設定を表示します。

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

   上記の出力は、トラフィックラベルが設定されていることを示します。