:高度なALBイングレス構成

ドメイン名に基づいてリクエストを転送する

次の手順を実行して、ドメイン名を持つイングレスとドメイン名を持たないイングレスを作成し、イングレスを使用してリクエストを転送します。

URLパスに基づいてリクエストを転送する

次の手順を実行して、異なるURL一致ポリシーを構成できます。

ヘルスチェックを設定する

次のアノテーションを使用して、ALBイングレスのヘルスチェックを設定できます。次のYAMLテンプレートは、ヘルスチェックが有効になっているイングレスを作成する方法の例を示しています。

次のYAMLテンプレートは、ヘルスチェックが有効になっているイングレスを作成する方法の例を示しています。

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-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:
      # コンテキストパスを設定します。
      - path: /tea
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      # コンテキストパスを設定します。
      - path: /coffee
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

HTTPリクエストからHTTPSリクエストへのリダイレクトを設定する

alb.ingress.kubernetes.io/ssl-redirect: "true"アノテーションを追加することで、HTTPリクエストをHTTPSポート443にリダイレクトするようにALBイングレスを設定できます。

例：

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: ClusterIP
---
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

バックエンドプロトコルとしてHTTPSまたはgRPCを設定する

ALBイングレスは、バックエンドプロトコルとしてHTTPSまたはgRPCをサポートしています。HTTPSまたはgRPCを設定するには、alb.ingress.kubernetes.io/backend-protocol: "grpc"またはalb.ingress.kubernetes.io/backend-protocol: "https"アノテーションを追加します。イングレスを使用してgRPCサービスにリクエストを配信する場合は、gRPCサービスのSSL証明書を設定し、TLSプロトコルを使用してgRPCサービスと通信する必要があります。例：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/backend-protocol: "grpc"
  name: lxd-grpc-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

正規表現を設定する

pathフィールドにルーティング条件として正規表現を指定できます。例：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true" # pathフィールドで正規表現をサポートします。
   alb.ingress.kubernetes.io/conditions.service-a: | # アノテーションで指定されたサービスは、クラスター内の既存のサービスでなければならず、サービス名はruleフィールドのbackendのサービス名と同じである必要があります。
     [{
       "type": "Path",
       "pathConfig": {
           "values": [
              "~*^/pathvalue1", # 正規表現は正規表現フラグ~ *に従う必要があります。
              "/pathvalue2" # 完全一致の場合は、パスの前に~ *を追加する必要はありません。
           ]
       }
      }]
  name: ingress-example
spec:
  ingressClassName: alb
  rules:
   - http:
      paths:
      - path: /test
        pathType: Prefix
        backend:
          service:
            name: service-a
            port:
              number: 88

書き換えルールを設定する

ALBイングレスは書き換えルールをサポートしています。書き換えルールを設定するには、アノテーションalb.ingress.kubernetes.io/rewrite-target: /path/${2}を追加します。次のルールが適用されます。

• rewrite-target アノテーションでは、pathType フィールドを、${number} タイプの変数に対して Prefix に設定する必要があります。

• デフォルトでは、pathパラメーターは、アスタリスク（*）や疑問符（?）などの正規表現でサポートされている文字をサポートしていません。pathパラメーターで正規表現で使用される文字を指定するには、rewrite-targetアノテーションを追加する必要があります。

• pathパラメーターの値は、スラッシュ（/）で始まる必要があります。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true" # pathフィールドで正規表現をサポートします。
    alb.ingress.kubernetes.io/rewrite-target: /path/${2} # 正規表現に一致する変数は連結され、元のパスを上書きするパスが形成されます。
  name: rewrite-ingress
spec:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /something(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: rewrite-svc
            port:
              number: 9080

カスタムリスニングポートを設定する

ALBイングレスでは、カスタムリスニングポートを設定できます。これにより、ポート80と443を介して同時にサービスを公開できます。

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

転送ルール優先順位を設定する

ALBイングレスのnamespace/nameパラメーターを使用して転送ルールの優先順位を付けたくない場合は、代わりに次のアノテーションを使用できます。

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

アノテーションを使用して段階的リリースを実行する

ALBでは、複雑なトラフィックルーティングを処理するために、リクエストヘッダー、Cookie、および重み付けに基づいてカナリアリリースを設定できます。アノテーションalb.ingress.kubernetes.io/canary: "true"を追加して、カナリアリリース機能を有効にできます。その後、次のアノテーションを使用して、さまざまなカナリアリリースルールを設定できます。

• alb.ingress.kubernetes.io/canary-by-headerおよびalb.ingress.kubernetes.io/canary-by-header-value：このルールは、リクエストのヘッダーとヘッダー値と一致します。このルールを使用する場合は、両方のアノテーションを追加する必要があります。

  • リクエストのheaderとheader valueがルールと一致する場合、リクエストは新しいアプリケーションバージョンにルーティングされます。

  • リクエストのheaderがheaderベースのルールと一致しない場合、リクエストはルールの優先順位に基づいて他のタイプのルールと照合されます。

  alb.ingress.kubernetes.io/canary-by-headerアノテーションをlocation: hzに設定すると、ルールと一致するリクエストは新しいアプリケーションバージョンにルーティングされます。ルールと一致しないリクエストは、重みベースのルールに基づいてルーティングされます。例：

  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

• alb.ingress.kubernetes.io/canary-by-cookie：このルールは、リクエストのCookieと一致します。

  • cookieをalwaysに設定すると、ルールと一致するリクエストは新しいアプリケーションバージョンにルーティングされます。

  • cookieをneverに設定すると、ルールと一致するリクエストは古いアプリケーションバージョンにルーティングされます。

  説明

  Cookieベースのカナリアリリースルールは、他の設定をサポートしていません。Cookie値はalwaysまたはneverである必要があります。

  demo=alwaysCookieを含むリクエストは、新しいアプリケーションバージョンにルーティングされます。例：

  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

• alb.ingress.kubernetes.io/canary-weight：このルールでは、指定されたサービスに送信されるリクエストの割合を設定できます。0～100の整数を入力できます。

  次の例では、新しいアプリケーションバージョンにルーティングされるリクエストの割合は50％に設定されています。

  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

アノテーションを使用してセッション永続性を設定する

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"
    alb.ingress.kubernetes.io/cookie-timeout: "1800"
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      # コンテキストパスを設定します。
      - path: /tea2
        backend:
          service:
            name: tea-svc
            port: 
             number: 80
      # コンテキストパスを設定します。
       - path: /coffee2
         backend:
           service:
              name: coffee-svc
              port: 
               number: 80

バックエンドサーバーグループのロードバランシングアルゴリズムを指定する

ALBイングレスでは、アノテーションalb.ingress.kubernetes.io/backend-schedulerを使用して、バックエンドサーバーグループのロードバランシングアルゴリズムを指定できます。クラスターのKubernetesバージョンは、デフォルトで1.19以降です。例：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    alb.ingress.kubernetes.io/backend-scheduler: "uch" # ビジネス要件に基づいて、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:
      - path: /tea
        pathType: ImplementationSpecific
        backend:
          service:
            name: tea-svc
            port:
              number: 80

CORSを設定する

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"

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:
  ingressClassName: alb
  rules:
  - host: demo.alb.ingress.top
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: cloud-nodeport
            port:
              number: 80

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