Container Service for Kubernetes:アノテーションを使用した ELB の一般的な構成

インスタンスタイプと課金方法の指定

インスタンスタイプの詳細および料金については、「CreateLoadBalancer」および「インスタンスタイプと課金」をご参照ください。

例：

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool
  service.openyurt.io/nodepool-labelselector: key1=val1
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-spec: elb.s1.small
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-pay-type: PostPaid

Service 公開モードの設定

例：

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool
  service.openyurt.io/nodepool-labelselector: key1=val1
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: internet

エッジ EIP 仕様の構成（インターネットモードのみ）

address-type が internet の場合、内部 ELB インスタンスとエッジ EIP の両方が必要です。

例：

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool        # Service トポロジーを有効化。
  service.openyurt.io/nodepool-labelselector: key1=val1 # ENS ノードプールを選択。
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: internet
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-eip-bandwidth: "10"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-eip-isp: cmcc
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-eip-instance-charge-type: "PostPaid"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-eip-internet-charge-type: "95BandwidthByMonth"

外部トラフィックポリシーの設定

外部トラフィックポリシーは、どの ENS ノードがトラフィックを受信するかを制御します。

• ローカルモード（externalTrafficPolicy: Local）：トラフィックはアプリケーション Pod をホストしているノードにのみ送信されます。複数の Service が 1 つの ELB インスタンスを共有する場合は使用できません。

• クラスターモード（デフォルト）：トラフィックは仮想プライベートクラウド（VPC）内のすべての ENS ノードに分散されます。複数の Service が 1 つの ELB インスタンスを共有する場合に必要です。

例（ローカルモード）：

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool        # Service トポロジーを有効化。
    service.openyurt.io/nodepool-labelselector: key1=val1 # ENS ノードプールを選択。
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb
  externalTrafficPolicy: Local

ノードラベルによるバックエンドサーバーの追加

特定のエッジノードをバックエンドサーバープールから除外するには、そのノードにラベル node.kubernetes.io/exclude-from-external-load-balancers=true を追加します。

例：

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool
  service.openyurt.io/nodepool-labelselector: key1=val1
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-backend-label: key2=val2

バックエンドサーバーの重み設定

リスナーが重み付きラウンドロビン（WRR）アルゴリズムを使用する場合、リクエストはバックエンドサーバーの重みに基づいて分散されます。

例 — デフォルト重みを 50 に設定し、node1 を 80、node2 を 90 にオーバーライドします。

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool
  service.openyurt.io/nodepool-labelselector: key1=val1,key2=val2
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-backend-weight: base=50,node1=80,node2=90

スケジューリングアルゴリズムの設定

サポートされているアルゴリズム：

例：

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool
  service.openyurt.io/nodepool-labelselector: key1=val1
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-scheduler: wrr

セッション維持の構成（TCP リスナー）

接続タイムアウトの構成（TCP リスナー）

例：

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool
  service.openyurt.io/nodepool-labelselector: key1=val1,key2=val2
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-established-timeout: "900"

ヘルスチェックの構成

例：

annotations:
  openyurt.io/topologyKeys: openyurt.io/nodepool
  service.openyurt.io/nodepool-labelselector: key1=val1,key2=val2
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-healthy-threshold: "5"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-unhealthy-threshold: "5"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-check-interval: "2"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-health-check-connect-timeout: "5"

既存の ELB インスタンスの使用

既存の ELB インスタンスを Service にアタッチするには、ネットワーク ID と ELB インスタンス ID を指定します。

1. managed-by-user アノテーションを付けて Service を適用します。

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx
     namespace: default
     annotations:
       openyurt.io/topologyKeys: openyurt.io/nodepool        # サービスのトポロジーを有効化します。
       service.openyurt.io/nodepool-labelselector: key1=val1
       service.openyurt.io/elb-force-override-listeners: "true"
       service.beta.kubernetes.io/alibaba-cloud-loadbalancer-managed-by-user: "true"
   spec:
     ports:
     - name: nginx-80
       port: 80
       protocol: TCP
       targetPort: 80
     selector:
       app: nginx
     type: LoadBalancer
     loadBalancerClass: alibabacloud.com/elb

2. 対象ノードプール（ENS VPC）に対応する PoolService を見つけ、ELB インスタンス ID をアノテーションとして追加します。

   kubectl annotate ps {<SERVICENAME>-NodePoolID} service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id=<lb_ID>

   <SERVICENAME> はノードプール（ENS VPC）の PoolService 名に、<lb_ID> は ELB インスタンス ID に置き換えてください。

複数の Service 間で 1 つの ELB インスタンスを共有

複数の Service で 1 つの ELB インスタンスを共有する場合、以下のすべての条件を満たす必要があります。

• externalTrafficPolicy をクラスターモード（デフォルト）に設定します。

• ユーザー管理の ELB インスタンスを使用し、managed-by-user アノテーションで指定します。

• EIP 経由でインターネットアクセスが必要な場合は、EIP を手動で作成および管理します。

• service.openyurt.io/elb-force-override-listeners: "true" を設定して、リスナーを強制的に上書きします。

例：

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool        # Service トポロジーを有効化。
    service.openyurt.io/nodepool-labelselector: key1=val1
    service.openyurt.io/elb-force-override-listeners: "true"
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-managed-by-user: "true"
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb