Container Service for Kubernetes:アノテーションを使用したELBインスタンスの設定

注意事項

• 注釈の内容は大文字と小文字を区別します。 小文字を使用します。

• サービスタイプをtype: LoadBalancerに設定します。

• ELBインスタンスを使用するには、ロードバランサタイプをloadBalancerClass: alibabacloud.com/elbに設定します。

ELB

EdgeControllerManager (ECM) で管理されるELBインスタンスの作成

• NodePoolSelectorは、次のいずれかの方法で指定する必要があります。

  • key1=val1,key2=val2: ELBインスタンスは、key1=val1条件とkey2=val2条件の両方を満たすエッジノードサービス (ENS) ノードプール用に作成されます。 複数のラベル間の論理的関係はANDである。

  • key in (val1,val2): key=val1またはkey=val2の条件を満たすENSノードプール用にELBインスタンスが作成されます。 複数の値の間の論理関係はORである。

• openyurt.io/topologyKeys: openyurt.io/nodepoolは、ノードプールのサービストポロジを指定します。 これにより、トラフィックは指定されたノードプール内のアプリケーションポッドにのみ転送されます。

  YAMLコンテンツ:

  apiVersion: v1
  kind: Service
  metadata:
    name: nginx
    namespace: default
    annotations:
      openyurt.io/topologyKeys: openyurt.io/nodepool           #Enable the Service topology feature.
      service.openyurt.io/nodepool-labelselector: key1=val1    #Select ENS node pools. 
  spec:
    ports:
    - name: nginx-80
      port: 80
      protocol: TCP
      targetPort: 80
    selector:
      app: nginx
    type: LoadBalancer
    loadBalancerClass: alibabacloud.com/elb

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

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  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    
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

サービス公開モードの指定

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool          
    service.openyurt.io/nodepool-labelselector: key1=val1
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: internet 
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

サービスがインターネットに公開されている場合のEIP仕様の指定

サービスをインターネットに公開するには、内部対応のELBインスタンスとEIPを購入する必要があります。

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool           #Enable the Service topology feature.
    service.openyurt.io/nodepool-labelselector: key1=val1    #Select ENS node pools.
    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"
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

バックエンドサーバーグループ

• ローカルモードでは、外部トラフィックポリシーは、アプリケーションポッドをホストするノード (バックエンドサーバー) にのみトラフィックを分散します。 複数のサービスが1つのELBインスタンスを共有する場合、外部トラフィックポリシーをローカルモードに設定することはできません。

• 外部トラフィックポリシーをクラスターモードに設定する必要があります。 このモードでは、ポリシーは仮想プライベートクラウド (VPC) 内のすべてのENSノード (バックエンドサーバー) にトラフィックを分散します。

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool           #Enable the Service topology feature.
    service.openyurt.io/nodepool-labelselector: key1=val1    #Select ENS node pools.
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ラベルをエッジノードに追加します。

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  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
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb
  externalTrafficPolicy: Local

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

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  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
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

リスナー

ECMは、サービスのSpec.portsに基づいてリスナーを自動的に作成します。 リスナーがリッスンするバックエンドサーバーポートは、クラスターによって割り当てられます。 特定のバックエンドサーバーポートでリッスンするには、nodePort: ${YOUR_SPEC_PORT} を指定します。 YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool
    service.openyurt.io/nodepool-labelselector: key1=val1
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    nodePort: 30080
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

リスナーのスケジューリングアルゴリズムの構成

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool
    service.openyurt.io/nodepool-labelselector: key1=val1
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-scheduler: "wrr"
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    nodePort: 30080
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

TCPリスナーのセッション持続期間の設定

TCPリスナーの接続タイムアウト期間の設定

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  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"
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    nodePort: 30080
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

リスナーのヘルスチェックの構成

YAMLコンテンツ:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  namespace: default
  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-health-check-interval: "2"
   service.beta.kubernetes.io/alibaba-cloud-loadbalancer-health-check-connect-timeout: "5"
spec:
  ports:
  - name: nginx-80
    port: 80
    protocol: TCP
    nodePort: 30080
    targetPort: 80
  selector:
    app: nginx
  type: LoadBalancer
  loadBalancerClass: alibabacloud.com/elb

高度な設定

このセクションでは、ELBの高度な設定について説明します。

1. さまざまなシナリオでサービスを作成します。

   既存のELBインスタンスの指定

   既存のELBインスタンスを指定するには、ネットワークIDとELBインスタンスIDを指定する必要があります。

   • 次のYAMLコンテンツに基づいてサービスを作成します。

     apiVersion: v1
     kind: Service
     metadata:
       name: nginx
       namespace: default
       annotations:
         openyurt.io/topologyKeys: openyurt.io/nodepool           #Enable the Service topology feature.
         service.openyurt.io/nodepool-labelselector: key1=val1
         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

   1つのELBインスタンスを共有する複数のサービスを作成する

   • 外部トラフィックポリシーをクラスターモードに設定する必要があります。

   • 自己管理ELBインスタンスを使用し、ELBインスタンスを指定する必要があります。

   • EIPを使用してインターネットアクセスを有効にするには、EIPを手動で作成および管理する必要があります。

   • 対応するパラメーターをtrueに設定して、リスナーを強制的に上書きする必要があります。

   YAMLコンテンツ:

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx
     namespace: default
     annotations:
       openyurt.io/topologyKeys: openyurt.io/nodepool           #Enable the Service topology feature.
       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を見つけ、次のコマンドを実行して負荷分散を設定します。

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

   説明

   上記のコマンドの <SERVICENAME> をノードプール (ENS VPC) のPoolServiceの名前に置き換えます。

   <lb_ID> をELBインスタンスのIDに置き換えます。