Container Compute Service:Advanced ALB Ingress configurations

前提条件

開始する前に、以下を確認してください。

• ACS クラスター。詳細については、「ACS クラスターの作成」をご参照ください。

• AlbConfig オブジェクト。詳細については、「ALB イングレスの開始」をご参照ください。

アノテーション クイックリファレンス

すべての ALB イングレス構成では、Kubernetes アノテーションを使用します。次の表に、このトピックで説明するアノテーションを示します。

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

ALB イングレスは、Ingress ルールの host フィールドに基づいて、受信リクエストをサービスにルーティングします。このセクションでは、指定ドメインとドメインなしでリクエストを転送する方法について説明します。

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

pathType フィールドを設定して、ALB イングレスが URL パスに一致する方法を制御します。3 つの一致タイプがサポートされています: Exact、ImplementationSpecific (デフォルト)、および Prefix。

URL 一致ポリシーは互いに競合する可能性があります。競合が存在する場合、リクエストはポリシー優先度の降順で一致されます。詳細については、「転送ルール優先度の設定」をご参照ください。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo-path
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
        - path: /hello
          backend:
            service:
              name: demo-service
              port:
                number: 80
          pathType: Exact

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo-path
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
        - path: /hello
          backend:
            service:
              name: demo-service
              port:
                number: 80
          pathType: ImplementationSpecific

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: demo-path-prefix
  namespace: default
spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
        - path: /
          backend:
            service:
              name: demo-service
              port:
                number: 80
          pathType: Prefix

curl <ADDRESS>/hello

{"hello":"coffee"}

ヘルスチェックの構成

ヘルスチェックアノテーションを Ingress に追加すると、ALB はバックエンドサーバーをプローブし、異常なものをローテーションから自動的に削除します。

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

HTTP から HTTPS へのリダイレクト

alb.ingress.kubernetes.io/ssl-redirect: "true" を設定すると、すべての 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: 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

バックエンドプロトコルの設定

ALB は、バックエンドプロトコルとして HTTPS と gRPC をサポートしています。alb.ingress.kubernetes.io/backend-protocol アノテーションを "https" または "grpc" に設定します。

Ingress 作成後にバックエンドプロトコルを変更することはできません。プロトコルを変更するには、Ingress を削除して再作成してください。

gRPC の場合、ドメインは SSL 証明書を持ち、TLS を使用する必要があります。次の例は、gRPC バックエンドを構成します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true"
    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.ingress.kubernetes.io/use-regex: "true" を設定すると、path フィールドで正規表現マッチングが有効になります。alb.ingress.kubernetes.io/conditions.<service-name> アノテーションを使用して、カスタムパス条件を定義します。

アノテーションで指定されたサービスはクラスターに存在し、ルールの backend フィールドのサービス名と一致する必要があります。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
   alb.ingress.kubernetes.io/use-regex: "true"
   alb.ingress.kubernetes.io/conditions.service-a: |
     [{
       "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

正規表現パターンは ~* フラグプレフィックスを使用する必要があります (例: ~*^/pathvalue1)。完全一致パスには ~* プレフィックスは必要ありません。

書き換えルールの構成

alb.ingress.kubernetes.io/rewrite-target を alb.ingress.kubernetes.io/use-regex: "true" と組み合わせて使用すると、リクエストがバックエンドに到達する前にリクエストパスを書き換えることができます。

ルール:

• ${number} 形式の変数は、pathType が Prefix である path で使用する必要があります。

• 最大 3 つのキャプチャグループ変数 (${1}、${2}、${3}) がサポートされています。

• path は / で始まる必要があります。

• デフォルトでは、* と ? は path フィールドでは許可されていません。これらを使用するには use-regex を有効にしてください。

次の例は、/something(/|$)(.*) に一致するパスを書き換えます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/use-regex: "true"
    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

${2} 変数は /something/ の後のパスセグメントをキャプチャします。バックエンドは次のパスを受信します。

複数グループの書き換えの場合、次の例を検討してください: path を /sys/(.*)/(.*)/aaa に設定し、rewrite-target を /${1}/${2} に設定します。/sys/ccc/bbb/aaa へのリクエストはパターンに一致し、${1} は ccc に、${2} は bbb に置き換えられるため、バックエンドは /ccc/bbb を受信します。

カスタムリスニングポートの構成

alb.ingress.kubernetes.io/listen-ports を設定すると、サービスを複数のポートで同時に公開できます (例: ポート 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

転送ルール優先度の設定

デフォルトでは、ALB イングレスは次の順序で転送ルールを優先します。

• Ingress は namespace/name の辞書順でランク付けされます。値が小さいほど優先度が高くなります。

• 同じ Ingress 内では、ルールは rules フィールドに表示される順序で上から下へ一致されます。

Ingress の名前を変更せずにデフォルトのランキングをオーバーライドするには、alb.ingress.kubernetes.io/order アノテーションを使用します。

優先度は同じリスナー内で一意である必要があります。値は 1 から 1,000 までの整数である必要があります。値が小さいほど優先度が高くなります。デフォルトは 10 です。

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 ベース、重みベースの 3 つのトラフィック分割方法が利用可能です。

alb.ingress.kubernetes.io/canary: "true" を設定して Ingress でカナリアリリースを有効にし、適切なルーティングアノテーションを追加します。

カナリアルール優先度: ヘッダーベース > Cookie ベース > 重みベース。

カナリアテスト中は、元の Ingress ルールを変更しないでください。変更するとトラフィックが中断される可能性があります。新しいバージョンがテストに合格したら、元の Ingress のバックエンドサービスを更新し、カナリア Ingress を削除してください。

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

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

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

セッション維持の構成

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"
    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.ingress.kubernetes.io/backend-scheduler を使用して、バックエンドサーバーグループの負荷分散アルゴリズムを設定します。クラスターバージョンは 1.19 以降である必要があります。

4 つのアルゴリズムがサポートされています。

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

CORS の構成

alb.ingress.kubernetes.io/enable-cors: "true" を設定すると、ALB イングレスで Cross-Origin Resource Sharing (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

バックエンド接続保持の有効化

デフォルトでは、ALB はバックエンドサーバーグループへの短時間接続を使用します。各リクエストは TCP 接続を開いてから閉じます。接続保持は、複数のリクエストにわたって既存の TCP 接続を再利用し、接続オーバーヘッドを削減し、高負荷時のスループットを向上させます。

alb.ingress.kubernetes.io/backend-keepalive: "true" を設定してこの機能を有効にします。

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 速度制限の構成

alb.ingress.kubernetes.io/traffic-limit-qps を設定すると、転送ルールの秒間クエリ数 (QPS) を制限できます。値は 1 から 100,000 までの整数である必要があります。

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

次のステップ

• AlbConfigs を使用して ALB リスナーを設定する

• ALB イングレスの使用を開始する

• ACS クラスターを作成する