Container Service for Kubernetes:MSE Ingressの高度な使用

例：

• リクエストヘッダーがmse:alwaysの場合、リクエストはcanaryバージョンのdemo-service-canaryに送信されます。 それ以外の場合、リクエストは基本バージョンのデモサービスに送信されます。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
    名前: demo-canary
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            - backend:
                service:
                  名前: demo-service-canary
                  port: 
                    number: 80
              パス: /hello
              pathType: 正確
  ---
  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /hello
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
    名前: demo-canary
  spec:
    ingressClassName: mse
    ルール:
      -http:
          paths:
            -パス: /hello
              バックエンド:
                serviceName: demo-service-canary
                servicePort: 80
  ---
  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    名前: デモ
  spec:
    ingressClassName: mse
    ルール:
      -http:
          paths:
            -パス: /hello
              バックエンド:
                serviceName: デモサービス
                servicePort: 80 

• リクエストヘッダーがmse:v1の場合、リクエストはカナリアバージョンdemo-service-canary-v1に送信されます。 リクエストヘッダーがmse:v2の場合、リクエストはカナリアバージョンdemo-service-canary-v2に送信されます。 それ以外の場合、リクエストは基本バージョンのデモサービスに送信されます。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
      nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
    名前: demo-canary-v1
  spec:
    ingressClassName: mse
    rules:
      -http:
          パス:
            - backend:
                service:
                  名前: demo-service-canary-v1
                  port: 
                    number: 80
              パス: /hello
              pathType: 正確
  ---
  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
      nginx.ingress.kubernetes.io/canary-by-header-value: "v2"
    名前: demo-canary-v2
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            - backend:
                service:
                  名前: demo-service-canary-v2
                  port: 
                    number: 80
              パス: /hello
              pathType: 正確
  ---
  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /hello
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
      nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
    名前: demo-canary-v1
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            -パス: /hello
              backend:
                serviceName: demo-service-canary-v1
                servicePort: 80
  ---
  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
      nginx.ingress.kubernetes.io/canary-by-header-value: "v2"
    名前: demo-canary-v2
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            -パス: /hello
              backend:
                serviceName: demo-service-canary-v2
                servicePort: 80
  ---
  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            -パス: /hello
              backend:
                serviceName: デモサービス
                servicePort: 80 

リクエストが宛先バックエンドサービスに転送される前に、書き換え操作を実行して、リクエスト内の元のパスとホストを変更できます。

1. e example.com/testリクエストがバックエンドサービスに転送される前に、s example.com/dev. e example.com/test サンプル設定:

   Kubernetes V1.19以降を実行するクラスター

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   メタデータ:
     アノテーション：
       nginx.ingress.kubernetes.io/rewrite-target: "/dev"
     名前: デモ
   spec:
     ingressClassName: mse
     rules:
       -host: example.com
         http:
           paths:
             - backend:
                 service:
                   名前: demo-service
                   port: 
                     number: 80
               パス: /test
               pathType: 正確 

   V1.19より前のバージョンのKubernetesを実行するクラスター

   apiVersion: networking.k8s.io/v1beta1
   kind: Ingress
   メタデータ:
     アノテーション：
       nginx.ingress.kubernetes.io/rewrite-target: "/dev"
     名前: デモ
   spec:
     ingressClassName: mse
     rules:
       - http:
           paths:
             -パス: /test
               pathType: 正確
               backend:
                 serviceName: デモサービス
                 servicePort: 80 

2. e example.com/v1/xxxリクエストがバックエンドサービスに転送される前に、プレフィックス /v1を削除し、リクエストをs example.com/xxx. サンプル設定:

   Kubernetes V1.19以降を実行するクラスター

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   メタデータ:
     アノテーション：
       nginx.ingress.kubernetes.io/rewrite-target: "/$1"
     名前: デモ
   spec:
     ingressClassName: mse
     rules:
       -host: example.com
         http:
           paths:
             - backend:
                 service:
                   名前: demo-service
                   port: 
                     number: 80
               パス: /v1/(.*)
               pathType: プレフィックス 

   V1.19より前のバージョンのKubernetesを実行するクラスター

   apiVersion: networking.k8s.io/v1beta1
   kind: Ingress
   メタデータ:
     アノテーション：
       nginx.ingress.kubernetes.io/rewrite-target: "/$1"
     名前: デモ
   spec:
     ingressClassName: mse
     rules:
       - http:
           paths:
             -パス: /v1/(.*) 
             	pathType: プレフィックス
               backend:
                 serviceName: デモサービス
                 servicePort: 80 

3. e example.com/v1/xxxリクエストがバックエンドサービスに転送される前に、プレフィックス /v1を /v2に変更し、リクエストをs example.com/v2/xxx. サンプル設定:

   Kubernetes V1.19以降を実行するクラスター

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   メタデータ:
     アノテーション：
       nginx.ingress.kubernetes.io/rewrite-target: "/v2/$1"
     名前: デモ
   spec:
     ingressClassName: mse
     rules:
       -host: example.com
         http:
           paths:
             - backend:
                 service:
                   名前: demo-service
                   port: 
                     number: 80
               パス: /v1/(.*)
               pathType: プレフィックス 

   V1.19より前のバージョンのKubernetesを実行するクラスター

   apiVersion: networking.k8s.io/v1beta1
   kind: Ingress
   メタデータ:
     アノテーション：
       nginx.ingress.kubernetes.io/rewrite-target: "/v2/$1"
     名前: デモ
   spec:
     ingressClassName: mse
     rules:
       - http:
           paths:
             -パス: /v1/(.*)
               pathType: プレフィックス
               backend:
                 serviceName: デモサービス
                 servicePort: 80 

例：

• ヘッダーfoo: barとtest: trueをreques t example.com/test. に追加します サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/request-header-control-add: |
        fooバー
        テストtrue
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/request-header-control-add: |
        fooバー
        テストtrue
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com 
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

• ヘッダ制御は、カナリアバージョンに送信される要求を識別するためにカナリアリリースと共に使用することができる。 リクエストヘッダーがmse: v1の場合、リクエストはカナリアバージョンdemo-service-canary-v1に送信され、ヘッダーstage: grayがリクエストに追加されます。 それ以外の場合は、リクエストは基本バージョンのデモサービスに送信され、ヘッダーステージ: プロダクションがリクエストに追加されます。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
      nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
      mse.ingress.kubernetes.io/request-header-control-add: "stage gray"
    名前: demo-canary-v1
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            - backend:
                service:
                  名前: demo-service-canary-v1
                  port: 
                    number: 80
              パス: /hello
              pathType: 正確
  ---
  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/request-header-control-add: "stage production"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /hello
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/canary: "true"
      nginx.ingress.kubernetes.io/canary-by-header: "mse"
      nginx.ingress.kubernetes.io/canary-by-header-value: "v1"
      mse.ingress.kubernetes.io/request-header-control-add: "stage gray"
    名前: demo-canary-v1
  spec:
    ingressClassName: mse
    rules:
      - http:
          paths:
            -パス: /hello
              backend:
                serviceName: demo-service-canary-v1
                servicePort: 80
  ---
  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/request-header-control-add: |
        fooバー
        テストtrue
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com 
        http:
          paths:
            -パス: /hello
              backend:
                serviceName: デモサービス
                servicePort: 80 

例：

• クライアントIPアドレス1.1.xx.xxからのo example.com/testへのアクセスを許可します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/whitelist-source-range: 1.1.X.X
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/whitelist-source-range: 1.1.X.X
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com 
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

• クライアントIPアドレス2.2.xx.xxからのo example.com/testアクセスを拒否します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/blacklist-source-range: 2.2.2.2
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/blacklist-source-range: 2.2.2.2
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

例：

• クライアントIPアドレス1.1.xx.xxおよび2.2.xx.xxからドメイン名e example.comのすべてのルートへのアクセスを許可します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確
           - backend:
                service:
                  name: app-service
                  port: 
                    number: 80
              パス: /app
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80
            -パス: /app
              backend:
                serviceName: app-service
                servicePort: 80 

• ドメイン名レベルでIPアドレスホワイトリストとブラックリストを使用し、ルートレベルでIPアドレスホワイトリストとブラックリストを使用します。 クライアントIPアドレス1.1.xx.xxおよびクライアントIPアドレス2.2.xx.xxからe example.comドメイン名のすべてのルートへのアクセスを許可し、クライアントIPアドレス3.3.xx.xxからのみe example.com/orderのルートへのアクセスを許可します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
    名前: demo-domain
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確
           - backend:
                service:
                  name: app-service
                  port: 
                    number: 80
              パス: /app
              pathType: 正確
  ---
  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/whitelist-source-range: 3.3.X.X
    名前: demo-route
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /order
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/domain-whitelist-source-range: 1.1.X.X,2.2.2.2
    名前: demo-domain
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80
            -パス: /app
              backend:
                serviceName: app-service
                servicePort: 80
  ---
  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/whitelist-source-range: 3.3.X.X
    名前: demo-route
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /order
              backend:
                serviceName: デモサービス
                servicePort: 80 

例：

• e example.com/testリクエストの場合、RPMの最大数を100に設定し、RPMの最大数のバースト制限を200に設定します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/route-limit-rpm: "100"
      mse.ingress.kubernetes.io/route-limit-burst-multiplier: "2"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/route-limit-rpm: "100"
      mse.ingress.kubernetes.io/route-limit-burst-multiplier: "2"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

• e example.com/testリクエストの場合、RPSの最大数を10に設定し、RPSの最大数のバースト制限を50に設定します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/route-limit-rps: "10"
      # デフォルト値は5です。
      # mse.ingress.kubernetes.io/route-limit-burst-multiplier: "5"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      mse.ingress.kubernetes.io/route-limit-rps: "10"
      # デフォルト値は5です。
      # mse.ingress.kubernetes.io/route-limit-burst-multiplier: "5"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

例1: ゲートウェイクラスターで処理されるf example.com/testリクエストの最大数を1000に設定し、デフォルトの同時実行制御動作を保持します。 サンプル設定:

apiVersion: networking.k8s.io/v1
kind: Ingress
メタデータ:
  アノテーション：
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
  名前: デモ
spec:
  ingressClassName: mse
  rules:
    -host: example.com
      http:
        paths:
          - backend:
              service:
                名前: demo-service
                port: 
                  number: 80
            パス: /test
            pathType: 正確 

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
メタデータ:
  アノテーション：
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
  名前: デモ
spec:
  ingressClassName: mse
  rules:
    -host: example.com
      http:
        paths:
          -パス: /test
            backend:
              serviceName: デモサービス
              servicePort: 80 

例2: ゲートウェイクラスターで処理されるm example.com/testからのリクエストの最大数を1,000に設定し、レスポンスコードを503に設定し、並行制御がトリガーされるとレスポンスボディがサーバーにオーバーロードされます。

apiVersion: networking.k8s.io/v1
kind: Ingress
メタデータ:
  アノテーション：
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code: 503
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body: "server is overload"
  名前: デモ
spec:
  ingressClassName: mse
  rules:
    -host: example.com
      http:
        paths:
          - backend:
              service:
                名前: demo-service
                port: 
                  number: 80
            パス: /test
            pathType: 正確 

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
メタデータ:
  アノテーション：
    mse.ingress.kubernetes.io/concurrency-limit: "1000"
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-code: 503
    mse.ingress.kubernetes.io/concurrency-limit-fallback-custom-response-body: "server is overload"
  名前: デモ
spec:
  ingressClassName: mse
  rules:
    -host: example.com
      http:
        paths:
          -パス: /test
            backend:
              serviceName: デモサービス
              servicePort: 80 

例：

• HTTPSを使用して、サンプル /テストリクエストをバックエンドサービスに転送します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              path: /
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

• gRPCを使用して、サンプル /テスト要求をバックエンドサービスに転送します。 次の方法を使用できます。

  • 方法1: 注釈を使用する。 サンプル設定:

    Kubernetes V1.19以降を実行するクラスター

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    メタデータ:
      アノテーション：
        nginx.ingress.kubernetes.io/backend-protocol: "GRPC"
      名前: デモ
    spec:
      ingressClassName: mse
      rules:
        -host: example.com
          http:
            paths:
              - backend:
                  service:
                    名前: demo-service
                    port: 
                      number: 80
                パス: /test
                pathType: 正確 

    V1.19より前のバージョンのKubernetesを実行するクラスター

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    メタデータ:
      アノテーション：
        nginx.ingress.kubernetes.io/backend-protocol: "GRPC"
      名前: デモ
    spec:
      ingressClassName: mse
      rules:
        -host: example.com
          http:
            paths:
              -パス: /test
                backend:
                  serviceName: デモサービス
                  servicePort: 80 

  • 方法2: Ingressリソース設定でspec > ports > nameを使用します。 サンプル設定:

    Kubernetes V1.19以降を実行するクラスター

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    メタデータ:
      名前: デモ
    spec:
      ingressClassName: mse
      rules:
        -host: example.com
          http:
            paths:
              - backend:
                  service:
                    名前: demo-service
                    port: 
                      number: 80
                パス: /order
                pathType: 正確
    ---
    apiVersion: v1
    種類: サービス
    メタデータ:
      名前: demo-service
    spec:
      ポート：
        -名前: grpc
          port: 80
          protocol: TCP
      セレクタ：
        app: デモサービス 

    V1.19より前のバージョンのKubernetesを実行するクラスター

    apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    メタデータ:
      名前: デモ
    spec:
      ingressClassName: mse
      rules:
        -host: example.com
          http:
            paths:
              -パス: /test
                backend:
                  serviceName: デモサービス
                  servicePort: 80
    ---
    apiVersion: v1
    種類: サービス
    メタデータ:
      名前: demo-service
    spec:
      ポート：
        -名前: grpc
          port: 80
          protocol: TCP
      セレクタ：
        app: デモサービス 

nginx.ingress.kubernetes.io/load-balance: バックエンドサービスで使用される一般的な負荷分散アルゴリズムを指定します。 デフォルト値: round_robin。 有効な値：

• round_robin: ラウンドロビンに基づく負荷分散。

• least_conn: 最小接続に基づく負荷分散。

• random: ランダムな負荷分散。

nginx.ingress.kubernetes.io/upstream-hash-by: コンシステントハッシングに基づく負荷分散アルゴリズムを指定します。 クラウドネイティブゲートウェイは、次のタイプのコンシステントハッシングをサポートします。

• NGINX変数に基づく一貫したハッシュ:

  • $request_uri: ハッシュキーとして使用されるリクエストパス。 パスパラメータが含まれています。

  • $host: ハッシュキーとして使用されるリクエストホスト。

  • $remote_addr: ハッシュキーとして使用されるクライアントIPアドレス。

• リクエストヘッダーに基づく一貫したハッシュ。 $http_headerNameを設定するだけです。

• 要求パスパラメータに基づく一貫したハッシュ。 $arg_varNameを設定するだけです。

例：

• リクエストのクライアントIPアドレスをハッシュキーとして使用します。 クライアントIPアドレスからのリクエストは、常に同じノードに配信されます。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/upstream-hash-by: "$remote_addr"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/upstream-hash-by: "$remote_addr"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

• リクエストヘッダーX-Stageをハッシュキーとして使用し、リクエストヘッダーX-Stageと同じ値のリクエストを同じノードに配布します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/upstream-hash-by: "$http_x-stage"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/upstream-hash-by: "$http_x-stage"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

• リクエストパスパラメーターX-Stageをハッシュキーとして使用し、リクエストパスパラメーターX-Stageの値が同じリクエストを同じノードに配布します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/upstream-hash-by: "$arg_x-stage"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/upstream-hash-by: "$arg_x-stage"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

例：

• cookieアフィニティを有効にし、MSE Ingressのデフォルト設定を使用します。 cookie名をINGRESSCOKIEに設定し、パスを /に設定し、セッションレベルでcookieのライフサイクルを設定します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/affinity: "cookie"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/affinity: "cookie"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

• cookie affinityを有効にし、テストするcookie名、/へのパス、およびcookieの有効期限を10秒に設定します。 サンプル設定:

  Kubernetes V1.19以降を実行するクラスター

  apiVersion: networking.k8s.io/v1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/affinity: "cookie"
      nginx.ingress.kubernetes.io/session-cookie-name: "test"
      nginx.ingress.kubernetes.io/session-cookie-max-age: "10"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            - backend:
                service:
                  名前: demo-service
                  port: 
                    number: 80
              パス: /test
              pathType: 正確 

  V1.19より前のバージョンのKubernetesを実行するクラスター

  apiVersion: networking.k8s.io/v1beta1
  kind: Ingress
  メタデータ:
    アノテーション：
      nginx.ingress.kubernetes.io/affinity: "cookie"
      nginx.ingress.kubernetes.io/session-cookie-name: "test"
      nginx.ingress.kubernetes.io/session-cookie-max-age: "10"
    名前: デモ
  spec:
    ingressClassName: mse
    rules:
      -host: example.com
        http:
          paths:
            -パス: /test
              backend:
                serviceName: デモサービス
                servicePort: 80 

MSE Ingressでサポートされているデフォルトの最も古いTLSバージョンはTLSv1.0です。 デフォルトの最新のTLSバージョンはTLSv1.3です。 デフォルトでは、次の暗号スイートが使用されます。

• ECDHE-ECDSA-AES128-GCM-SHA256

• ECDHE-RSA-AES128-GCM-SHA256

• ECDHE-ECDSA-AES128-SHA

• ECDHE-RSA-AES128-SHA

• AES128-GCM-SHA256

• AES128-SHA

• ECDHE-ECDSA-AES256-GCM-SHA384

• ECDHE-RSA-AES256-GCM-SHA384

• ECDHE-ECDSA-AES256-SHA

• ECDHE-RSA-AES256-SHA

• AES256-GCM-SHA384

• AES256-SHA

次の表に、特定のドメイン名の最も古いまたは最新のTLSバージョンと暗号スイートを指定するために使用できるアノテーションを示します。