永続的なVPCロードバランサー

デフォルトでは、VPCロードバランサーは関連付けられているクラスタが削除されると削除されます。 しかし、LoadBalancer サービス定義を作成するときに、ロードバランサを永続化することができます。 永続的なVPCロードバランサーは、前のクラスタが削除された後でも別のクラスタに適用できます。

VPCロードバランサー名はデフォルトでは kube-<cluster_ID>-<kubernetes_lb_service_UID> のようにフォーマットされます。 クラスタが削除されると、この名前形式では関連するロードバランサも削除されます。 クラスタを削除したときにロードバランサが削除されないようにするには、 service.kubernetes.io/ibm-load-balancer-cloud-provider-vpc-lb-name アノテーションを LoadBalancer サービス定義に含めてロードバランサに一意な名前をつけます。 ロードバランサ名は VPC 内で一意でなければならず、小文字の英数字とハイフン (-) しか使えません。このアノテーションは全ての VPC ロードバランサータイプに適用できます。

永続的なVPCロードバランサーは、不要になったら削除する責任があります。 永続的なVPCロードバランサーを削除するには、そのVPCロードバランサーが関連付けられているKubernetes LoadBalancer サービス定義を削除します。

VPCロードバランサーをクラスタ間で移動する

永続的VPCロードバランサー は、あるVPCクラスタから切り離し、別のVPCクラスタに接続することができます。 新しいクラスタは元のクラスタと同じVPC内になければならない。

ロード・バランサーのヘルス・チェック

VPC ロードバランサは自動的にヘルスチェックが設定され、externalTrafficPolicy アノテーションで設定します。 追加のアノテーションを使って、ロードバランサーのヘルスチェックをカスタマイズする ことができます。

• externalTrafficPolicy が Cluster に設定されている場合、TCP ヘルス・チェックが適用されます。 UDP ロード・バランサーを構成する場合は、追加のポートを指定する必要があります。
• externalTrafficPolicy が Local に設定されている場合、HTTP ヘルス・チェックが適用されます。 着信トラフィックは、特定のノードに存在するアプリケーション・ポッドにのみ配信される。 特定のノードにアプリケーション・ポッドがない場合、受信トラフィックはドロップされる。

externalTrafficPolicy: Local の設定はロードバランサーのワーカーノードのヘルスチェックを失敗させるかもしれません。 通常、ロードバランサーがアプリケーションポッドを持たないノードに接続しようとした場合、トラフィックは意図的にドロップされるため、この結果は予期された動作であり、必ずしも問題を示すものではありません。 詳しくは、ワーカーノードでVPCロードバランサーのヘルスチェックが失敗するのはなぜですか をご覧ください。

ロードバランサーのサブネットやゾーンを変更する

VPC NLBを作成した後、そのリスニングサブネットを再構成することはできません。 既存のVPC NLBのリスニングサブネットを変更したい場合は、対応するKubernetes LoadBalancer サービスを削除、更新、再適用する必要があります。

1. アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

2. Kubernetes サービスをリストし、変更する LoadBalancer サービスの名前を見つけます。

   kubectl get services
   

   出力例。

   NAME                     TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)                        AGE
   my-load-balancer         LoadBalancer   172.21.77.198   52.118.150.107   8080:32767/TCP,443:30943/TCP   5d
   

3. Kubernetes LoadBalancer サービスに対応する VPC ロード・バランサーを見つけます。

   VPC ロード・バランサーの名前の形式は kube-<cluster_ID>-<kubernetes_lb_service_UID> です。 クラスター ID を確認するには、ibmcloud ks cluster get --cluster <cluster_name> を実行します。 Kubernetes LoadBalancer サービスの UID を調べるには、kubectl get svc <load-balancer-name> -o yaml を実行して出力中の 「metadata.uid」フィールドを確認します。 VPC ロードバランサー名の Kubernetes LoadBalancer サービス UID からハイフン (-) が削除されます。

   ibmcloud is load-balancers
   

   出力例。

   ID                                          Name                                                         Family        Subnets                                       Is public   Provision status   Operating status   Resource group      
   r000-5aaaa11f6-c111-111f-b2e0-1c11aaaaf0dc0   kube-c441c43d02mb8mg00r70-3e25d0b5bf11111111fe4ca3f11111cb   Network       subnet-1                                  true        active             online             default                                                    Application      
   

4. Kubernetes LoadBalancer サービス定義を取得し、my-lb.yaml という名前の yaml ファイルとして出力を保存します。

   kubectl describe service my-load-balancer -o yaml
   

5. Kubernetes LoadBalancer サービスを削除します。 これにより、対応する VPC ロード・バランサーも削除されます。

   kubectl delete service my-load-balancer
   

6. 実装するサブネットまたはゾーンの変更内容で Kubernetes LoadBalancer サービス定義ファイルを更新します。 LoadBalancer サービスの名前は変更しないでください。 ネットワーク・ロード・バランサーのサブネットまたはゾーンの指定について詳しくは、「Network Load Balancer for VPC のセットアップ (Setting up a Network Load Balancer for VPC)」を参照してください。

7. 新しい LoadBalancer 定義ファイルを適用します。

   kubectl apply -f my-lb.yaml
   

8. Kubernetes LoadBalancer サービスがクラスター内で正常に再作成されたことを確認します。 サービスが作成されると、 LoadBalancer Ingress フィールドにNLBの外部IPアドレスが入力される。

   kubectl describe service my-load-balancer
   

   出力例。

   NAME:                     my-load-balancer
   Namespace:                default
   Labels:                   <none>
   Annotations:              service.kubernetes.io/ibm-load-balancer-cloud-provider-enable-features: nlb
   Selector:                 app=echo-server
   Type:                     LoadBalancer
   IP:                       172.X.XXX.XX
   LoadBalancer Ingress:     169.XXX.XXX.XXX
   Port:                     tcp-80  80/TCP
   TargetPort:               8080/TCP
   NodePort:                 tcp-80  32022/TCP
   Endpoints:                172.XX.XX.XXX:8080,172.XX.XX.XX:8080,172.XX.XX.XX:8080 + 3 more...
   Session Affinity:         None
   External Traffic Policy:  Local
   HealthCheck NodePort:     30882
   Events:
       Type     Reason                           Age                  From                Message
   ----     ------                           ----                 ----                -------
   Normal   EnsuringLoadBalancer             9m27s (x7 over 15m)  service-controller  Ensuring load balancer
   Normal   EnsuredLoadBalancer              9m20s                service-controller  Ensured load balancer
   Normal   CloudVPCLoadBalancerNormalEvent  8m17s                ibm-cloud-provider  Event on cloud load balancer myvpcnlb for service default/my-load-balancer with UID 2d93b07d-ecf6-41d2-ad3f-9c2985122ec1: The VPC load balancer that routes requests to this Kubernetes LoadBalancer service is currently online/active.
   

9. VPC ロード・バランサーが再作成され、サブネットまたはゾーンが更新されたことを確認します。 VPC ロードバランサーのプロビジョニングには数分かかり、完全にプロビジョニングされるまで create_pending のステータスが表示されるかもしれないことに注意してください。

   ibmcloud is load-balancers
   

   出力例。

   ID                                          Name                                                         Family        Subnets                                       Is public   Provision status   Operating status   Resource group     
   r006-5ecc68f6-c751-409f-b2e0-1c69babf0dc0   kube-c441c43d02mb8mg00r70-3e25d0b5bf03445796fe4ca3f73885cb   Network       subnet-2                                  true        active             online             default