Container Service for Kubernetes:ALB イングレスの高度な使用方法

ドメイン名に基づくリクエストの転送

指定されたドメイン名または空のドメイン名に基づいてリクエストを転送するためのシンプルな Ingress を作成できます。以下の例でその方法を示します。

URL パスに基づくリクエストの転送

以下の例で 3 つのマッチング方法を示します。

ヘルスチェックの設定

ALB イングレスは、以下のアノテーションを使用したヘルスチェック設定をサポートしています。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/healthcheck-enabled: "true"
    alb.ingress.kubernetes.io/healthcheck-path: "/"
    alb.ingress.kubernetes.io/healthcheck-protocol: "HTTP"
    alb.ingress.kubernetes.io/healthcheck-httpversion: "HTTP1.1"
    alb.ingress.kubernetes.io/healthcheck-method: "HEAD"
    alb.ingress.kubernetes.io/healthcheck-code: "http_2xx"
    alb.ingress.kubernetes.io/healthcheck-timeout-seconds: "5"
    alb.ingress.kubernetes.io/healthcheck-interval-seconds: "2"
    alb.ingress.kubernetes.io/healthy-threshold-count: "3"
    alb.ingress.kubernetes.io/unhealthy-threshold-count: "3"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      # Context Path を設定
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      # Context Path を設定
      - path: /coffee
        pathType: ImplementationSpecific
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/healthcheck-enabled: "true"
    alb.ingress.kubernetes.io/healthcheck-path: "/"
    alb.ingress.kubernetes.io/healthcheck-protocol: "HTTP"
    alb.ingress.kubernetes.io/healthcheck-method: "HEAD"
    alb.ingress.kubernetes.io/healthcheck-httpcode: "http_2xx"
    alb.ingress.kubernetes.io/healthcheck-timeout-seconds: "5"
    alb.ingress.kubernetes.io/healthcheck-interval-seconds: "2"
    alb.ingress.kubernetes.io/healthy-threshold-count: "3"
    alb.ingress.kubernetes.io/unhealthy-threshold-count: "3"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      # Context Path を設定。
      - path: /tea
        backend:
          serviceName: tea-svc
          servicePort: 80
      # Context Path を設定。
      - path: /coffee
        backend:
          serviceName: coffee-svc
          servicePort: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/healthcheck-enabled: "true"
    alb.ingress.kubernetes.io/healthcheck-path: "/"
    alb.ingress.kubernetes.io/healthcheck-protocol: "HTTP"
    alb.ingress.kubernetes.io/healthcheck-httpversion: "HTTP1.1"
    alb.ingress.kubernetes.io/healthcheck-method: "HEAD"
    alb.ingress.kubernetes.io/healthcheck-code: "http_2xx"
    alb.ingress.kubernetes.io/healthcheck-timeout-seconds: "5"
    alb.ingress.kubernetes.io/healthcheck-interval-seconds: "2"
    alb.ingress.kubernetes.io/healthy-threshold-count: "3"
    alb.ingress.kubernetes.io/unhealthy-threshold-count: "3"
spec:
... ...

HTTP トラフィックを HTTPS にリダイレクトする

ALB イングレスは、以下のアノテーションを使用して HTTP リクエストを HTTPS ポート 443 にリダイレクトできます。

apiVersion: v1
kind: Service
metadata:
  name: demo-service-ssl
  namespace: default
spec:
  ports:
    - name: port1
      port: 80
      protocol: TCP
      targetPort: 8080
  selector:
    app: demo-ssl
  sessionAffinity: None
  type: NodePort
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-ssl
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: demo-ssl
  template:
    metadata:
      labels:
        app: demo-ssl
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
          imagePullPolicy: IfNotPresent
          name: demo-ssl
          ports:
            - containerPort: 8080
              protocol: TCP
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo-ssl
  namespace: default
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - ssl.alb.ingress.top
  rules:
    - host: ssl.alb.ingress.top
      http:
        paths:
          - backend:
              service:
                name: demo-service-ssl
                port: 
                  number: 80
            path: /
            pathType: Prefix

apiVersion: v1
kind: Service
metadata:
  name: demo-service-ssl
  namespace: default
spec:
  ports:
    - name: port1
      port: 80
      protocol: TCP
      targetPort: 8080
  selector:
    app: demo-ssl
  sessionAffinity: None
  type: NodePort
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-ssl
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: demo-ssl
  template:
    metadata:
      labels:
        app: demo-ssl
    spec:
      containers:
        - image: registry.cn-hangzhou.aliyuncs.com/alb-sample/cafe:v1
          imagePullPolicy: IfNotPresent
          name: demo-ssl
          ports:
            - containerPort: 8080
              protocol: TCP
---
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo-ssl
  namespace: default
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - ssl.alb.ingress.top
  rules:
    - host: ssl.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: demo-service-ssl
              servicePort: 80
            path: /
            pathType: Prefix

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/ssl-redirect: "true"
  name: demo-ssl
 ... ...

バックエンドの HTTPS および gRPC プロトコルのサポート

ALB は、バックエンドプロトコルとして HTTPS および gRPC をサポートしています。Ingress に以下のアノテーションを追加できます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: demo-alb-ingress
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:  
      - path: /
        pathType: Prefix
        backend:
          service:
            name: grpc-demo-svc
            port:
              number: 9080

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: demo-alb-ingress
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: grpc-demo-svc
              servicePort: 9080
            path: /
            pathType: Prefix

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: demo-alb-ingress
... ...

正規表現の設定

alb.ingress.kubernetes.io/use-regex: "true" アノテーションを使用して、正規表現モードを有効にできます。その後、カスタム転送条件またはアクションで対応する正規表現を設定できます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true"  ## 正規表現の使用を許可します。
   alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME>: | ## <YOUR-SVC-NAME> を実際のサービス名に置き換えます。以下にある backend.service.name と一致している必要があります。
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*/pathvalue1", ## 正規表現の前に ~* または ~ を正規表現フラグとして追加します。~* または ~ の後の内容が有効な正規表現となります。~* は大文字と小文字を区別するマッチングを示し、~ は大文字と小文字を区別しないマッチングを示します。
              "/pathvalue2"    ## 完全一致の場合は ~* は不要です。
           ]
       }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
   - http:
      paths:
      - path: /test-path-for-alb
        pathType: Prefix
        backend:
          service:
            name: <YOUR-SVC-NAME> ## <YOUR-SVC-NAME> を実際のサービス名に置き換えます。アノテーションで指定されたカスタム転送条件のサービス名と一致している必要があります。
            port:
              number: 88

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true"  ## 正規表現の使用を許可します。
   alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME>: | ## <YOUR-SVC-NAME> を実際のサービス名に置き換えます。以下にある backend.service.name と一致している必要があります。
     [{
       "type": "Path",         ## Host もサポートされています。
       "pathConfig": {
           "values": [
              "~*/pathvalue1", ## 正規表現の前に ~* または ~ を正規表現フラグとして追加します。~* または ~ の後の内容が有効な正規表現となります。~* は大文字と小文字を区別するマッチングを示し、~ は大文字と小文字を区別しないマッチングを示します。
              "/pathvalue2"    ## 完全一致の場合は ~* は不要です。
           ]
       }
      }]
... ...

正規表現マッチングルール：

正規表現のプレフィックスマッチングを設定する

デフォルトでは、正規表現マッチングは「部分一致」を使用します。つまり、リクエストに正規表現に一致する内容が含まれている場合、ルールが一致します。特定の内容で始まるパスのみを一致させるには、正規表現の先頭に ^ を追加します。これにより、指定された内容で始まるパスのみが一致します。たとえば、^/api は /api で始まるリクエストパスのみに一致します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-example
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true"  ## 正規表現マッチングを有効にします。
    alb.ingress.kubernetes.io/conditions.<YOUR-SVC-NAME>: |     ## <YOUR-SVC-NAME> を実際のサービス名に置き換えます。以下にある backend.service.name と一致している必要があります。
      [
        {
          "type": "Path",
          "pathConfig": {
            "values": [
              "~*^/pathvalue1",  # ~* または ~ は正規表現マッチングを示します。^ は「/pathvalue1 で始まる」ことを示します。
              "/pathvalue2"     # 通常のプレフィックスまたは完全一致。~* または ~ は不要です。
            ]
          }
        }
      ]
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /test-path-for-alb
            pathType: Prefix
            backend:
              service:
                name: <YOUR-SVC-NAME>   # 実際のサービス名に置き換えます。アノテーションと一致している必要があります。
                port:
                  number: 88

書き換えの設定

ALB イングレスは、書き換え機能をサポートしています。ALB イングレスがクライアントリクエストを受信すると、バックエンド Service にリクエストを送信する前にリクエストのパスを変更します。書き換え機能は、以下の 2 つのアノテーションを使用して実装されます。

• alb.ingress.kubernetes.io/rewrite-target: /<path>/${number}：書き換えを有効にして、書き換え後のパスを指定します。

  重要

  • ${number} 形式を使用して、元のパスから正規表現でキャプチャされた変数を表します。${1}、${2}、または ${3} を設定できます。元のパスから最大 3 つの変数をキャプチャできます。

  • Ingress で pathType を Prefix に設定する必要があります。

• alb.ingress.kubernetes.io/use-regex: true：パスで正規表現を使用します。rewrite-target が設定されている場合、デフォルトで有効になります。

  重要

  • このアノテーションが存在する場合、その値が true または false のいずれであっても、正規表現マッチングが有効になります。正規表現マッチングを無効にするには、このアノテーションを削除する必要があります。

  • このアノテーションが設定されておらず、パスに “%#;!()[]^,”\" などの特殊文字が含まれている場合、Ingress リソースを作成できません。

設定例

例 1：プレフィックスの削除

以下の YAML 例では、path: /something(/|$)(.*) が正規表現を使用してクライアントリクエストパスを 3 つの部分に分割します。

• /something：削除したいプレフィックスに一致します。

• (/|$)：最初のキャプチャグループ。このグループは、/something の後に続く / または $（パスの末尾）に一致します。

• (.*)：2 番目のキャプチャグループ。このグループは /something/ の後のすべての内容に一致します。書き換え後のパスでは ${2} を使用できます。

alb.ingress.kubernetes.io/rewrite-target アノテーションで設定された書き換えパスは、/（標準パスプレフィックス）+ ${2}（2 番目のキャプチャグループの内容）です。以下の表にパス書き換えの効果を示します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # path フィールドで正規表現を使用できるようにします。
    alb.ingress.kubernetes.io/rewrite-target: /${2} # このアノテーションは正規表現の置き換えをサポートします。
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /something(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

例 2：複数の部分をキャプチャして並べ替える

以下の例では、パス /items/(.*)/(.*)/(.*) から複数の部分をキャプチャして並べ替えます。これにより、ユーザーが意識することなく URL 形式を POST のような形式に変更します。書き換えパスは、/（標準パスプレフィックス）+ ${2}（2 番目のキャプチャグループの内容）+ ?code= + ${3}（3 番目のキャプチャグループの内容）です。以下の表にパス書き換えの効果を示します。

この例では、パスに正確に 4 つのセグメントが必要です。クライアントが固定のパス形式を使用する場合にのみ、この方法を使用できます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # path フィールドで正規表現を使用できるようにします。
    alb.ingress.kubernetes.io/rewrite-target: /${2}?code=${3} # このアノテーションは正規表現の置き換えをサポートします。
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /items/(.*)/(.*)/(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

例 3：複数のパスを単一のパスに書き換える

以下の例では、複数のパス /app-a(/|$)(.*) および /app-b(/|$)(.*) の正規表現マッチングを使用して、それらを単一のパスに書き換えます。書き換えパスは、/app-c/ + ${2}（2 番目のキャプチャグループの内容）です。以下の表にパス書き換えの効果を示します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rewrite-ingress
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # path フィールドで正規表現を使用できるようにします。
    alb.ingress.kubernetes.io/rewrite-target: /app-c/${2} # このアノテーションは正規表現の置き換えをサポートします。
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /app-a(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080
      - path: /app-b(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

例 4：ドメイン名の書き換え

alb.ingress.kubernetes.io/rewrite-target アノテーションはパスのみを変更することをサポートしています。ドメイン名やパラメーターなど、URL の他の部分を変更するには、カスタム転送ルールを使用できます。

書き換えルールの一致を検証する

sed コマンドを使用して、特定のクライアントパスがパスに設定された正規表現に一致するかどうかを事前にテストし、書き換え後のパスを確認できます。

例 2：複数の部分をキャプチャして並べ替える のキャプチャパス /items/(.*)/(.*)/(.*) および書き換えルール /${2}?code=${3} を例に挙げます。

1. 以下のサンプルコマンドを path2.txt に保存します。

   /items/electronics/computers/554
   /items/produce/fruits/12
   /items/headphones/5
   /drinks/41

2. パスが一致するかどうかを確認し、書き換え後のパスを表示します。

   以下のコマンドでは、例のパス正規表現 (/items/(.*)/(.*)/(.*)) および書き換えパス (/${2}?code=${3}) を使用しています。`sed` コマンドでは、特殊文字 / は \ でエスケープされ、キャプチャグループ表記は ${2} から \2 に変更されています。

   sed -E 's#\/items\/(.*)\/(.*)\/(.*)#Matched: [&]  --->  Rewritten: [/\2?code=\3]#' path2.txt

   期待される出力：最初の 2 つのパスは書き換えルールに一致し、新しいパスに書き換えられます。最後の 2 つのパスは一致せず、書き換えられません。

   Matched: [/items/electronics/computers/554]  --->  Rewritten: [/computers?code=554]
   Matched: [/items/produce/fruits/12]  --->  Rewritten: [/fruits?code=12]
   /items/headphones/5
   /drinks/41

カスタムリスニングポートの設定

ALB イングレスは、アノテーションを使用したカスタムリスニングポートをサポートしています。これにより、サービスがポート 80 (HTTP) とポート 443 (HTTPS) の両方を同時に公開できます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'
  name: cafe-ingress
spec:
  ingressClassName: alb
  tls:
  - hosts:
    - demo.alb.ingress.top
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: tea-svc
              servicePort: 80
            path: /tea
            pathType: ImplementationSpecific

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80},{"HTTPS": 443}]'
... ...

転送ルールの優先度を設定する

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/order: "2"
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/order: "2" 
  name: cafe-ingress
spec:
  ingressClassName: alb
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: tea-svc
              servicePort: 80
            path: /tea
            pathType: ImplementationSpecific

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/order: "2"
spec:
... ...

アノテーションによる段階的リリースの実装

ALB は、ヘッダー、Cookie、重みに基づく複雑なルーティングおよび段階的リリースをサポートしています。以下のアノテーションを設定して、さまざまな段階的リリース戦略を柔軟に実装できます。段階的リリースのベストプラクティスの詳細については、「ALB イングレスを使用して段階的リリースを実装する」をご参照ください。

• 指定されたヘッダーに基づいて段階的リリースのトラフィックを割り当てる

  パラメーター	説明	YAML 例
  alb.ingress.kubernetes.io/canary-by-header	このルールでは、リクエストヘッダーとその値をカスタマイズできます。両方のアノテーションを設定する必要があります。 リクエスト内の header および header-value が設定値と一致する場合、リクエストトラフィックは段階的サービスエンドポイントにルーティングされます。 一致しない他のリクエストは、段階的優先度に基づいて後続の段階的サービスに割り当てられます。	apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "1" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-by-header: "location" alb.ingress.kubernetes.io/canary-by-header-value: "hz" name: demo-canary spec: ... ...
  alb.ingress.kubernetes.io/canary-by-header-value

  リクエストヘッダーに location: hz が含まれている場合、トラフィックは段階的サービスにルーティングされます。他のリクエストは、重みベースの戦略に基づいて対応する段階的サービスに割り当てられます。以下のサンプル構成を使用します。

  完全な YAML 例を表示するには展開してください

  バージョン 1.19 以降のクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    annotations:
      alb.ingress.kubernetes.io/order: "1"
      alb.ingress.kubernetes.io/canary: "true"
      alb.ingress.kubernetes.io/canary-by-header: "location"
      alb.ingress.kubernetes.io/canary-by-header-value: "hz"
    name: demo-canary
    namespace: default
  spec:
    ingressClassName: alb
    rules:
      - http:
          paths:
            - backend:
                service:
                  name: demo-service-hello
                  port: 
                    number: 80
              path: /hello
              pathType: ImplementationSpecific

  バージョン 1.19 より前のクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  metadata:
    annotations:
      alb.ingress.kubernetes.io/order: "1"
      alb.ingress.kubernetes.io/canary: "true"
      alb.ingress.kubernetes.io/canary-by-header: "location"
      alb.ingress.kubernetes.io/canary-by-header-value: "hz"
    name: demo-canary
    namespace: default
  spec:
    ingressClassName: alb
    rules:
      - http:
          paths:
            - backend:
                serviceName: demo-service-hello
                servicePort: 80
              path: /hello
              pathType: ImplementationSpecific

• 指定された Cookie に基づいて段階的リリースのトラフィックを割り当てる

  パラメーター	Cookie 値	YAML 例
  alb.ingress.kubernetes.io/canary-by-cookie	always：すべてのリクエストトラフィックが段階的サービスエンドポイントにルーティングされます。 never：リクエストトラフィックが段階的サービスエンドポイントにルーティングされません。 Cookie ベースの段階的リリースは、always および never のみをサポートしています。	apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "2" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-by-cookie: "demo" name: demo-canary-cookie ... ...

  リクエストヘッダーに Cookie: demo=always が含まれている場合、トラフィックは段階的サービスにルーティングされます。リクエストヘッダーに Cookie: demo=never が含まれている場合、トラフィックは段階的サービスにルーティングされません。以下のサンプル構成を使用します。

  完全な YAML 例を表示するには展開してください

  バージョン 1.19 以降のクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    annotations:
      alb.ingress.kubernetes.io/order: "2"
      alb.ingress.kubernetes.io/canary: "true"
      alb.ingress.kubernetes.io/canary-by-cookie: "demo"
    name: demo-canary-cookie
    namespace: default
  spec:
    ingressClassName: alb
    rules:
      - http:
          paths:
            - backend:
                service:
                  name: demo-service-hello
                  port: 
                    number: 80
              path: /hello
              pathType: ImplementationSpecific

  バージョン 1.19 より前のクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  metadata:
    annotations:
      alb.ingress.kubernetes.io/order: "2"
      alb.ingress.kubernetes.io/canary: "true"
      alb.ingress.kubernetes.io/canary-by-cookie: "demo"
    name: demo-canary-cookie
    namespace: default
  spec:
    ingressClassName: alb
    rules:
      - http:
          paths:
            - backend:
                serviceName: demo-service-hello
                servicePort: 80
              path: /hello
              pathType: ImplementationSpecific

• 重みに基づいてトラフィックを割り当てる

  パラメーター	説明	YAML 例
  alb.ingress.kubernetes.io/canary-weight	指定されたサービスにルーティングされるリクエストの割合を設定します。有効値：0 ～ 100 の整数。	apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: alb.ingress.kubernetes.io/order: "3" alb.ingress.kubernetes.io/canary: "true" alb.ingress.kubernetes.io/canary-weight: "50" name: demo-canary-weight

  段階的サービスの重みを 50% に設定できます。以下のサンプル構成を使用します。

  完全な YAML 例を表示するには展開してください

  バージョン 1.19 以降のクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  metadata:
    annotations:
      alb.ingress.kubernetes.io/order: "3"
      alb.ingress.kubernetes.io/canary: "true"
      alb.ingress.kubernetes.io/canary-weight: "50"
    name: demo-canary-weight
    namespace: default
  spec:
    ingressClassName: alb
    rules:
      - http:
          paths:
            - backend:
                service:
                  name: demo-service-hello
                  port: 
                    number: 80
              path: /hello
              pathType: ImplementationSpecific

  バージョン 1.19 より前のクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  metadata:
    annotations:
      alb.ingress.kubernetes.io/order: "3"
      alb.ingress.kubernetes.io/canary: "true"
      alb.ingress.kubernetes.io/canary-weight: "50"
    name: demo-canary-weight
    namespace: default
  spec:
    ingressClassName: alb
    rules:
      - http:
          paths:
            - backend:
                serviceName: demo-service-hello
                servicePort: 80
              path: /hello
              pathType: ImplementationSpecific

アノテーションによるセッション維持の実装

ALB イングレスは、以下のアノテーションを使用したセッション維持をサポートしています。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress-v3
  annotations:
    alb.ingress.kubernetes.io/sticky-session: "true"
    alb.ingress.kubernetes.io/sticky-session-type: "Insert"   # カスタム Cookie がサポートされている場合、Cookie 挿入タイプは Server である必要があります。
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - backend:
          service:
            name: tea-svc
            port:
              number: 80
        path: /tea2
        pathType: ImplementationSpecific
      - backend:
          service:
            name: coffee-svc
            port:
              number: 80
        path: /coffee2
        pathType: ImplementationSpecific

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: cafe-ingress-v3
  annotations:
    alb.ingress.kubernetes.io/sticky-session: "true"
    alb.ingress.kubernetes.io/sticky-session-type: "Insert"  # カスタム Cookie がサポートされている場合、Cookie 挿入タイプは Server である必要があります。
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      # Context Path を設定。
      - path: /tea2
        pathType: ImplementationSpecific
        backend:
          serviceName: tea-svc
          servicePort: 80
      # Context Path を設定。
      - path: /coffee2
        pathType: ImplementationSpecific
        backend:
          serviceName: coffee-svc
          servicePort: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress-v3
  annotations:
    alb.ingress.kubernetes.io/sticky-session: "true"
    alb.ingress.kubernetes.io/sticky-session-type: "Server"   # カスタム Cookie がサポートされている場合、Cookie 挿入タイプは Server である必要があります。
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
    alb.ingress.kubernetes.io/cookie: "test"
spec:
... ...

サーバーグループの負荷分散アルゴリズムの指定

ALB イングレスは、以下のアノテーションを使用してサーバーグループの負荷分散アルゴリズムを指定することをサポートしています。以下の表に、有効値とその説明を示します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # 必要に応じて、このパラメーターを wrr、sch、または wlc に設定することもできます。
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # このパラメーターは、負荷分散アルゴリズムが uch の場合にのみ必要です。アルゴリズムが wrr、sch、または wlc の場合は必要ありません。
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # 必要に応じて、このパラメーターを wrr、sch、または wlc に設定することもできます。
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # このパラメーターは、負荷分散アルゴリズムが uch の場合にのみ必要です。アルゴリズムが wrr、sch、または wlc の場合は必要ありません。
  name: cafe-ingress
spec:
  ingressClassName: alb
  rules:
    - host: demo.alb.ingress.top
      http:
        paths:
          - backend:
              serviceName: tea-svc
              servicePort: 80
            path: /tea
            pathType: ImplementationSpecific

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # 必要に応じて、このパラメーターを wrr、sch、または wlc に設定することもできます。
    alb.ingress.kubernetes.io/backend-scheduler-uch-value: "test" # このパラメーターは、負荷分散アルゴリズムが uch の場合にのみ必要です。アルゴリズムが wrr、sch、または wlc の場合は必要ありません。
spec:
... ... 

クロスオリジン設定

ALB イングレスは、以下のアノテーションパラメーターを使用してクロスオリジン動作を制御することをサポートしています。許可されたサイト、リクエストメソッド、リクエストおよびレスポンスヘッダー、認証情報の送信、プリフライト (OPTIONS) キャッシュの継続時間を指定して、さまざまなセキュリティおよびビジネスシナリオのクロスオリジンアクセス要件を満たすことができます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-cors: "true"
    alb.ingress.kubernetes.io/cors-expose-headers: ""
    alb.ingress.kubernetes.io/cors-allow-methods: "GET,POST"
    alb.ingress.kubernetes.io/cors-allow-credentials: "true"
    alb.ingress.kubernetes.io/cors-max-age: "600"
    alb.ingress.kubernetes.io/cors-allow-origin: "Allowed cross-origin domain names"
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: cloud-nodeport
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-cors: "true"
    alb.ingress.kubernetes.io/cors-expose-headers: ""
    alb.ingress.kubernetes.io/cors-allow-methods: "GET,POST"
    alb.ingress.kubernetes.io/cors-allow-credentials: "true"
    alb.ingress.kubernetes.io/cors-max-age: "600"
    alb.ingress.kubernetes.io/cors-allow-origin: "Allowed cross-origin domain names"
spec:
... ...

バックエンドの接続保持

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-keepalive: "true"
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: cloud-nodeport
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-keepalive: "true"
spec:

サーバーグループの IPv6 アタッチメントのサポート

サーバーグループの IPv6 アタッチメントを有効にした後は、クラスターのデュアルスタック機能が有効になっていることを確認して、IPv4 および IPv6 の両方の Pod をサーバーグループにアタッチする必要があります。詳細については、「ACK マネージドクラスターの作成」をご参照ください。

apiVersion: v1
kind: Service
metadata:
  name: tea-svc
spec:
  # デュアルスタックを設定する場合、ipFamilies は IPv4 または IPv6 に設定し、ipFamilyPolicy は RequireDualStack または PreferDualStack に設定する必要があります。
  ipFamilyPolicy: RequireDualStack
  ipFamilies:
  - IPv4
  - IPv6
  ports:
  - port: 80
    targetPort: 80
    protocol: TCP
  selector:
    app: tea
  type: NodePort
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: tea
spec:
  replicas: 2
  selector:
    matchLabels:
      app: tea
  template:
    metadata:
      labels:
        app: tea
    spec:
      containers:
      - name: tea
        image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
        ports:
        - containerPort: 80
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-ipv6: "true"
spec:
  ingressClassName: alb
  rules:
   - host: demo.alb.ingress.top
     http:
      paths:
      - path: /tea
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

Service と ALB イングレスの両方をデュアルスタック要件に基づいて設定する必要があります。デュアルスタック ALB インスタンスを作成した後、サーバーグループは IPv4 および IPv6 の両方のバックエンドサーバーをアタッチできます。

apiVersion: v1
kind: Service
metadata:
  name: tea-svc
spec:
  # デュアルスタックを設定する場合、ipFamilies は IPv4 または IPv6 に設定し、ipFamilyPolicy は RequireDualStack または PreferDualStack に設定する必要があります。
  ipFamilyPolicy: RequireDualStack
  ipFamilies:
  - IPv4
  - IPv6
... ...

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/enable-ipv6: "true"
spec:
... ...

QPS レート制限のサポート

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/traffic-limit-qps: "50"
spec:
  ingressClassName: alb
  rules:
   - host: demo.alb.ingress.top
     http:
      paths:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      - path: /coffee
        pathType: ImplementationSpecific
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/traffic-limit-qps: "50"
spec:
... ...

バックエンドのスロースタート

Service のバックエンドに新しい Pod が追加されると、ALB イングレスはすぐに新しい Pod にトラフィックをルーティングします。これにより、CPU またはメモリ使用量が急激に増加し、アクセスエラーが発生する可能性があります。スロースタート機能により、ALB イングレスは新しい Pod に徐々にトラフィックをシフトできます。これにより、トラフィックの急増による影響を軽減できます。以下のサンプル構成を使用します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/slow-start-enabled: "true"
    alb.ingress.kubernetes.io/slow-start-duration: "100"
  name: alb-ingress
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/slow-start-enabled: "true"
    alb.ingress.kubernetes.io/slow-start-duration: "100"
  name: alb-ingress
... ...

接続ドレイン

Pod が Terminating 状態になると、ALB イングレスはその Pod をバックエンドサーバーグループから削除します。ただし、ALB と Pod 間の既存の接続は直ちに終了しません。クライアントはこれらのバックエンドサーバーに引き続きリクエストを送信する可能性があります。これにより、Pod が長時間オンラインのままになったり、リクエストエラーが発生したりする可能性があります。この問題を回避するために、ALB の接続ドレイン機能を使用できます。Pod が削除された場合やヘルスチェックに失敗した場合、ALB イングレスは指定された継続時間の間、通常の送信を維持した後、接続を積極的に閉じて、サービスのスムーズなシャットダウンを保証します。詳細については、「ALB 接続ドレインによるスムーズなサービスシャットダウンの実現」をご参照ください。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/connection-drain-enabled: "true"
    alb.ingress.kubernetes.io/connection-drain-timeout: "199"
  name: alb-ingress
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/connection-drain-enabled: "true"
    alb.ingress.kubernetes.io/connection-drain-timeout: "199"
  name: alb-ingress
... ...

ゾーン間 (AZ) 無効化

デフォルトでは、ALB はゾーン間 (AZ) 負荷分散を有効にしています。この機能により、同一リージョン内の異なるゾーンにあるバックエンドサービス間でトラフィックが均等に分散されます。ALB サーバーグループのゾーン間負荷分散を無効にすると、同一リージョン内の同じゾーンにあるバックエンドサービス間でのみトラフィックが分散されます。

以下の手順を実行して、ゾーン間負荷分散を無効にできます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
spec:
  ingressClassName: alb
  rules:
  - host: alb.ingress.alibaba.com
    http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: alb-ingress
  namespace: default
  annotations:
    alb.ingress.kubernetes.io/cross-zone-enabled: "false"
... ...