Alibaba Cloud Service Mesh:VirtualService を用いたリクエストおよびレスポンスヘッダーのカスタマイズ

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• HTTPBin アプリケーションがご利用の ASM インスタンスにデプロイ済みであること。手順については、「HTTPBin アプリケーションのデプロイ」をご参照ください。

ヘッダー操作のリファレンス

VirtualService では、ヘッダー操作として以下の 3 種類がサポートされています。

ヘッダー操作の構成

以下の VirtualService 構成例では、リクエストおよびレスポンスの両方のヘッダーに対して、上記の 3 種類の操作をすべて実行しています。

apiVersion: networking.istio.io/v1alpha3
kind: VirtualService
metadata:
  name: httpbin-vs
spec:
  gateways:
    - httpbin
  hosts:
    - '*'
  http:
  - route:
    - destination:
        host: httpbin
        port:
          number: 8000
      weight: 100
    headers:
      request:
        add:
          x-custom-request-header: "custom-value"       # 静的値を追加
          x-dynamic-request-header: "%START_TIME%"       # 動的値を追加
        set:
          x-another-request-header: "another-value"      # 上書きまたは新規作成
        remove:
          - x-unwanted-header                            # 完全に削除
      response:
        add:
          x-custom-response-header: "custom-response-value"
        set:
          x-another-response-header: "another-response-value"
        remove:
          - x-unwanted-response-header

この構成により、以下のような変更が適用されます。

リクエストヘッダー

• 追加：静的値 custom-value を持つ x-custom-request-header を追加します。

• 追加：%START_TIME% からランタイムで解決されるリクエスト開始時のタイムスタンプを値とする x-dynamic-request-header を追加します。

• 上書き：x-another-request-header を値 another-value で上書きします。該当ヘッダーが存在しない場合は新規作成されます。

• 削除：x-unwanted-header を完全に削除します。

レスポンスヘッダー

• 追加：x-custom-response-header を値 custom-response-value で追加します。

• 上書き：x-another-response-header を値 another-response-value で上書きします。該当ヘッダーが存在しない場合は新規作成されます。

• 削除：x-unwanted-response-header を完全に削除します。

アクセスログにおけるカスタムヘッダーの検証

ASM では、ログフォーマットのカスタマイズが可能です。アクセスログのカスタム式では、リクエストヘッダー、レスポンスヘッダー、および Envoy の組み込み値から値を取得できます。手順については、「アクセスログのフォーマットのカスタマイズ」をご参照ください。

アクセスログフォーマットに以下のフィールドを追加してください。

ログフォーマットを更新した後、ゲートウェイ Pod および HTTPBin Pod の両方のアクセスログを確認してください。

ゲートウェイ Pod のアクセスログ

ゲートウェイ Pod では、リクエストおよびレスポンスの両方のヘッダー変更が記録されます。

{
    "bytes_received": "9",
    "bytes_sent": "33",
    "response_code": "200",
    "my-x-custom-request-header": "custom-value",
    "my-x-dynamic-request-header": "2024-01-16T14:49:21.187Z",
    "my-x-custom-response-header": "custom-response-value"
}

HTTPBin Pod のアクセスログ

HTTPBin のサイドカーでは、VirtualService によるレスポンスヘッダーの変更がサイドカーのログ記録ポイントより後に適用されるため、追加されたレスポンスヘッダーは記録されません。my-x-custom-response-header フィールドには - が表示されます。

{
    "bytes_received": "9",
    "bytes_sent": "33",
    "response_code": "200",
    "my-x-custom-request-header": "custom-value",
    "my-x-dynamic-request-header": "2024-01-16T14:49:21.187Z",
    "my-x-custom-response-header": "-"
}

関連トピック

• アクセスログのフォーマットのカスタマイズ

• コマンド演算子（Envoy ドキュメント）