Container Compute Service:ALB イングレスのルーティングルールをカスタマイズ

ソース IP およびリクエストヘッダーに基づくトラフィックルーティング

以下の Ingress では、次の 3 つの条件すべてが満たされた場合にのみ、リクエストを gray-hello にルーティングします：ソース IP が 192.168.0.0/16 または 172.16.0.0/16 の範囲内であること、gray-hello ヘッダーの値が value1 または value2 であること、およびパスが /hello であること。それ以外のすべてのリクエストは、他のサービスに送信されます。

alb.ingress.kubernetes.io/order は Ingress の優先度を設定します — 数値が小さいほど優先度が高くなります。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/order: "1"
    alb.ingress.kubernetes.io/conditions.gray-hello: |
      [{
        "type": "Header",
        "headerConfig": {
          "key": "gray-hello",
          "values": [
            "value1",
            "value2"
          ]
        }
       },
       {
         "type": "SourceIp",
         "sourceIpConfig": {
           "values": [
             "192.168.0.0/16",
             "172.16.0.0/16"
           ]
         }
      }]
  name: gray-hello
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /hello
            pathType: ImplementationSpecific
            backend:
              service:
                name: gray-hello
                port:
                  number: 88

ドメイン名、リクエストメソッド、および Cookie に基づくトラフィックルーティング

以下の Ingress では、すべての条件が一致した場合にのみ、リクエストを service-a にルーティングします：ドメインが www.hostvalue1.edu または www.hostvalue2.edu であること、メソッドが GET または HEAD であること、Cookie cookiekey1 の値が cookievalue1 であること、およびパスが /test であること。その他のリクエストは service-b に送信されます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/conditions.service-a: |
      [{
        "type": "Cookie",
        "cookieConfig": {
          "values": [
            {
              "key": "cookiekey1",
              "value": "cookievalue1"
            }
          ]
        }
       },
       {
        "type": "Method",
        "methodConfig": {
          "values": [
            "GET",
            "HEAD"
          ]
        }
       },
       {
        "type": "Host",
        "hostConfig": {
          "values": [
            "www.hostvalue1.edu",
            "www.hostvalue2.edu"
          ]
        }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /test
            pathType: ImplementationSpecific
            backend:
              service:
                name: service-a
                port:
                  number: 88
          - path: /test
            pathType: ImplementationSpecific
            backend:
              service:
                name: service-b
                port:
                  number: 88

クエリ文字列、複数のリクエストヘッダー、および複数のパスに基づくトラフィックルーティング

以下の Ingress では、すべての条件が一致した場合にリクエストを service-a にルーティングします：パスが /pathvalue1、/pathvalue2、または /test であること；クエリ文字列 querystringkey1 の値が querystringvalue2 であること；ヘッダー headerkey1 の値が headervalue1 または headervalue2 であること；およびヘッダー headerkey2 の値が headervalue3 または headervalue4 であること。その他のリクエストは service-b に送信されます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/conditions.service-a: |
      [{
        "type": "Path",
        "pathConfig": {
          "values": [
            "/pathvalue1",
            "/pathvalue2"
          ]
        }
       },
       {
        "type": "QueryString",
        "queryStringConfig": {
          "values": [
            {
              "key": "querystringkey1",
              "value": "querystringvalue2"
            }
          ]
        }
       },
       {
        "type": "Header",
        "headerConfig": {
          "key": "headerkey1",
          "values": [
            "headervalue1",
            "headervalue2"
          ]
        }
       },
       {
        "type": "Header",
        "headerConfig": {
          "key": "headerkey2",
          "values": [
            "headervalue3",
            "headervalue4"
          ]
        }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /test
            pathType: ImplementationSpecific
            backend:
              service:
                name: service-a
                port:
                  number: 88
          - path: /test
            pathType: ImplementationSpecific
            backend:
              service:
                name: service-b
                port:
                  number: 88

ステータスコード 503 を伴う固定応答の返信

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: ingress
  annotations:
    alb.ingress.kubernetes.io/actions.insert-header: |
      [{
        "type": "InsertHeader",
        "InsertHeaderConfig": {
          "key": "source",
          "value": "alibaba",
          "valueType": "UserDefined"
        }
      }]
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: insert-header
                port:
                  number: 80

301 を使用した HTTPS へのリダイレクト

以下の Ingress では、すべての HTTP リクエストを恒久的なリダイレクト（301）を使用して HTTPS にリダイレクトします。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: ingress
  annotations:
    alb.ingress.kubernetes.io/actions.redirect: |
      [{
        "type": "Redirect",
        "RedirectConfig": {
          "host": "${host}",
          "path": "${path}",
          "port": "${port}",
          "protocol": "https",
          "query": "${query}",
          "httpCode": "301"
        }
      }]
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: redirect
                port:
                  name: use-annotation # リダイレクト操作では、use-annotation を指定する必要があります

RedirectConfig のパラメーター：

リクエストヘッダーの挿入

以下の Ingress では、すべてのリクエストに source: alibaba ヘッダーを挿入し、バックエンドに転送します。既に同名のヘッダーが存在する場合は、上書きされます。

アノテーション内の Service 名は、backend フィールド内の Service 名と一致している必要があります。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: ingress
  annotations:
    alb.ingress.kubernetes.io/actions.insert-header: |
      [{
        "type": "InsertHeader",
        "InsertHeaderConfig": {
          "key": "source",
          "value": "alibaba",
          "valueType": "UserDefined"
        }
      }]
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: insert-header
                port:
                  number: 80

サーバーグループへのトラフィックミラーリング

以下の Ingress では、demo.domain.ingress.top/test に一致するすべてのトラフィックを指定されたサーバーグループにミラーリングします。同時に、元のリクエストは通常通り転送されます。

サーバーグループ ID を取得するには、Server Load Balancer (SLB) コンソール にログインし、ALB ＞ サーバーグループ を選択して、サーバーグループ ページで ID を確認します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: traffic-mirror-ingress
  annotations:
    # アノテーション内の Service 名は、backend フィールド内の Service 名と一致している必要があります。
    alb.ingress.kubernetes.io/actions.traffic-mirror: |
      [{
        "type": "TrafficMirror",
        "TrafficMirrorConfig": {
          "TargetType": "ForwardGroupMirror",
          "MirrorGroupConfig": {
            "ServerGroupTuples": [{
              "ServerGroupID": "sgp-2auud2fxj1r46*****"
            }]
          }
        }
      }]
spec:
  ingressClassName: alb
  rules:
    - host: demo.domain.ingress.top
      http:
        paths:
          - path: /test
            pathType: Prefix
            backend:
              service:
                name: traffic-mirror
                port:
                  number: 80

複数のバックエンドサーバーグループへのリクエスト転送

重みに基づいて、複数のバックエンドサーバーグループ間でリクエストを分散します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: forward-ingress
  annotations:
    # アノテーション内の Service 名は、backend フィールド内の Service 名と一致している必要があります。
    alb.ingress.kubernetes.io/actions.forward: |
      [{
        "type": "ForwardGroup",
        "ForwardConfig": {
          "ServerGroups": [{
            "ServiceName": "tea-svc",
            "Weight": 80,
            "ServicePort": 80
          },
          {
            "ServiceName": "coffee-svc",
            "Weight": 20,
            "ServicePort": 80
          }]
        }
      }]
spec:
  ingressClassName: alb
  rules:
    - host: demo.domain.ingress.top
      http:
        paths:
          - path: /path
            pathType: Prefix
            backend:
              service:
                name: forward
                port:
                  name: use-annotation # 転送操作では、use-annotation を指定する必要があります

alb.ingress.kubernetes.io/actions.forward: |
  [{
    "type": "ForwardGroup",
    "ForwardConfig": {
      "ServerGroups": [{
        "ServerGroupID": "sgp-71aexb9y93ypo*****",
        "Weight": 80
      },
      {
        "ServerGroupID": "sgp-slygpbvm2cydo*****",
        "Weight": 20
      }]
    }
  }]

ドメイン名、パス、またはクエリ文字列の書き換え

以下の Ingress では、/path に一致するすべてのリクエストについて、ドメイン名を demo.domain.ingress.top に、パスを /test に、クエリ文字列を querystring に書き換えます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: default
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/actions.rewrite: |
      [{
        "type": "Rewrite",
        "RewriteConfig": {
          "Host": "demo.domain.ingress.top",
          "Path": "/test",
          "Query": "querystring"
        }
      }]
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /path
            pathType: Prefix
            backend:
              service:
                name: rewrite
                port:
                  number: 80

書き換えルールの詳細については、「書き換えルールの設定」をご参照ください。

レスポンスヘッダーの値に基づくレスポンスヘッダーの変更

デフォルトでは、カスタムルーティングルールはインバウンドトラフィックに適用されます。ルールをアウトバウンドトラフィック（応答）に適用するには、alb.ingress.kubernetes.io/rule-direction.<service-name> を Response に設定します。

以下の Ingress では、応答に response-hello ヘッダーが含まれており、その値が value1 または value2 の場合に、応答に source: alibaba ヘッダーを挿入します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/rule-direction.response-header: Response
    alb.ingress.kubernetes.io/conditions.response-header: |
      [{
        "type": "ResponseHeader",
        "responseHeaderConfig": {
          "key": "response-hello",
          "values": [
            "value1",
            "value2"
          ]
        }
      }]
    alb.ingress.kubernetes.io/actions.response-header: |
      [{
        "type": "InsertHeader",
        "InsertHeaderConfig": {
          "key": "source",
          "value": "alibaba",
          "valueType": "UserDefined"
        }
      }]
  name: response-header
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /
            pathType: ImplementationSpecific
            backend:
              service:
                name: response-header
                port:
                  name: use-annotation # アウトバウンドルーティングルールでは、use-annotation を指定する必要があります

レスポンスステータスコードに基づくレスポンスヘッダーの削除

以下の Ingress では、ステータスコード 200 または 300 を返す応答から response-hello ヘッダーを削除します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/rule-direction.response-hello: Response
    alb.ingress.kubernetes.io/conditions.response-hello: |
      [{
        "type": "ResponseStatusCode",
        "responseStatusCodeConfig": {
          "values": [
            "200",
            "300"
          ]
        }
      }]
    alb.ingress.kubernetes.io/actions.response-hello: |
      [{
        "type": "RemoveHeader",
        "RemoveHeaderConfig": {
          "key": "response-hello"
        }
      }]
  name: response-hello
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /*
            pathType: ImplementationSpecific
            backend:
              service:
                name: response-hello
                port:
                  name: use-annotation # アウトバウンドルーティングルールでは、use-annotation を指定する必要があります

QPS スロットリングによるリクエストレート制限

グローバルなリクエストレート制限、クライアント IP 単位のレート制限、またはその両方を設定します。QPS スロットリング操作は、転送操作と組み合わせる必要があります。

annotations:
  alb.ingress.kubernetes.io/actions.traffic-limit: |
    [{
      "type": "TrafficLimit",
      "TrafficLimitConfig": {
        "QPS": "1000",
        "QPSPerIp": "100"
      }
    }]