Load Balancer インスタンスの連携

VPC環境で利用できます。

Ncloud Kubernetes Serviceを利用するためにサービスを作成する際、そのサービスと連携する Load Balancerインスタンスを自動的に作成できます。

Kubernetesと連携する Load Balancerインスタンスの管理

インスタンス作成

Ncloud Kubernetes Serviceと連携する Load Balancerインスタンスを作成するには、サービスマニフェストのタイプを LoadBalancerに指定した後、service.beta.kubernetes.io/ncloud-load-balancer-layer-typeアノテーションを nplbまたは nlbに設定します。

• nplb: ネットワークプロキシロードバランサ(NPLB)インスタンスが作成されます。
• nlb: ネットワークロードバランサ(NLB)インスタンスが作成されます。

インスタンスのプロパティ設定

サービスマニフェストのアノテーションを用いて作成されるインスタンスのプロパティを設定できます。インスタンスのプロパティを設定するには、インスタンスを作成する時に次の表を参照して metadata.annotationsの値を入力します。

• ネットワークプロキシロードバランサ(NPLB)

• ネットワークロードバランサ(NLB)

ロードバランサの Subnetタイプに応じたパブリックとプライベート IPアドレスの割り当て方式

ロードバランサ Subnetは Public Subnetと Private Subnetの2つのタイプがあり、パブリック IPアドレスとプライベート IPアドレスが付与されたロードバランサを作成するには、各々のタイプが必要です。

ロードバランサを作成すると、kube-system名前空間の ncloud-config ConfigMapに定義されたlbPublicSubnetNo、lbSubnetNoフィールドの Subnet IDが使用されます。他の Subnetを使用するには、service.beta.kubernetes.io/ncloud-load-balancer-subnet-idアノテーションに希望する Subnet IDを指定します。

1.Public Subnet(Internet Gateway専用)
パブリック IPアドレスが付与されたロードバランサを作成するには Public Subnetが必要です。NAVERクラウドプラットフォームコンソール VPC環境で、Menu > All Services > Networking > VPC > Public IPメニューを順にクリックしてパブリック IPアドレスを申し込んだ後、ロードバランサに割り当てます。パブリック IPアドレスを指定しないと、新規パブリック IPアドレスが自動的に申し込まれます。

2. Private Subnet
プライベート IPアドレスが割り当てられたロードバランサを VPC内部に作成するには、Private Subnetが必要です。

マルチゾーン Subnet IDを指定

マルチゾーンクラスタで NPLB(ネットワークプロキシロードバランサ)を作成する場合、各ゾーンのロードバランサ専用 Subnet IDを service.beta.kubernetes.io/ncloud-load-balancer-subnet-id アノテーションに入力できます。マルチゾーンクラスタで NPLB Subnet IDを指定する場合、以下の内容をご参照ください。

• 2つ以上を入力する場合、コンマ(,)で区切ります。
• 各ゾーンごとにロードバランサ専用サブネットは、1つのみ指定できます。
• 同じゾーンに属する Subnet IDを2つ以上入力すると、ロードバランサ作成に失敗します。
• subnet-id 値はロードバランサを作成する場合のみ適用されます。作成されたロードバランサのサブネットを変更するには、ロードバランサを再度作成する必要があります。
• マルチゾーンサブネット指定は、NPLBでのみサポートします。NLB(ネットワークロードバランサ)は、マルチゾーンサブネット指定をサポートしません。
• マルチゾーンサブネットを指定する場合、パブリック IPアドレスを指定して割り当てられません。

metadata:
  annotations:
    service.beta.kubernetes.io/ncloud-load-balancer-layer-type: "nplb"
    service.beta.kubernetes.io/ncloud-load-balancer-subnet-id: "123456,234567"

インスタンスプロパティ設定のユースケース

インスタンスのプロパティ設定に関するユースケースは、Load Balancerプロパティ設定のユースケースをご参照ください。

作成されたロードバランサインスタンスの External IPを確認

作成されたインスタンスの external IPを確認するには、以下のコマンドを実行します。

$ kubectl --kubeconfig $KUBE_CONFIG get svc example-service

EXTERNAL-IP列に当該インスタンスの external IPが表示されます。以下は、当該コマンドを使用して external IPを照会したユースケースです。

$ kubectl --kubeconfig $KUBE_CONFIG get svc example-service
NAME              TYPE           CLUSTER-IP       EXTERNAL-IP    PORT(S)          AGE
example-service   LoadBalancer   172.16.101.104   10.39.10.118   8765:30365/TCP   2m11s

ロードバランサ管理を一時停止

lb.ncloud.naver.com/pause: "true"は Kubernetes 1.36以上の KVMクラスタで使用できる一時停止オプションです。この値が設定されると、コントローラの spec/provider reconcileが一時停止されます。

インスタンス削除

LoadBalancerタイプで作成した Kubernetesサービスを削除すると、連携された Load Balancerインスタンスが自動的に一緒に削除されます。削除する方法は、次の通りです。

1. 以下のコマンドを実行して作成された Kubernetesサービスを確認します。

• 結果値の TYPE列で各サービスのタイプを確認できます。

$ kubectl --kubeconfig $KUBE_CONFIG get service

2. 以下のコマンドを実行して LoadBalancerタイプのサービスを削除します。

$ kubectl --kubeconfig $KUBE_CONFIG delete service my-nginx