Load Balancer インスタンスの連携

最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

VPC環境で利用できます。

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

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

インスタンス作成

Ncloud Cloud 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アドレスが付与されたロードバランサを作成するために必要です。ロードバランサを作成する際、kube-system名前空間内の ncloud-config ConfigMapで定義された lbPublicSubnetNoと lbSubnetNoフィールドにある Subnet IDを使用します。この Subnet IDはロードバランサを作成する時、service.beta.kubernetes.io/ncloud-load-balancer-subnet-id annotationを利用して他の Subnet IDを使うように指定できます。

1. Public Subnet(Internet Gateway専用)
グローバル IPアドレスが付与されたロードバランサを作成するためには、Public Subnetが必要です。NAVERクラウドプラットフォームコンソールの VPC > Public IP メニューからグローバル IPアドレスを申し込み、これをロードバランサに割り当てることができます。グローバル IPアドレスを指定しないと、新規グローバル IPアドレスが申し込まれます。

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

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

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

ネットワークプロキシロードバランサ(NPLB)インスタンス作成のユースケース

以下は、Kubernetesと連携する NPLBインスタンスを作成するユースケースです。

1. 以下のサンプルコードを nks-lb.ymlファイルとして保存します。

• 以下のサンプルコードで、プライベートネットワークプロキシタイプのロードバランサインスタンスを作成するためのアノテーションを確認できます。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      run: my-nginx
  template:
    metadata:
      labels:
        run: my-nginx
    spec:
      containers:
      - name: my-nginx
        image: nginx
        ports:
        - containerPort: 80
---

kind: Service
apiVersion: v1
metadata:
  name: my-nginx
  annotations:
    service.beta.kubernetes.io/ncloud-load-balancer-layer-type: "nplb"
    service.beta.kubernetes.io/ncloud-load-balancer-internal: "true"    
    service.beta.kubernetes.io/ncloud-load-balancer-size: "SMALL"
spec:
  ports:
  - port: 80
    targetPort: 80
  selector:
    run: my-nginx
  type: LoadBalancer

2. kubectl apply -f nks-lb.ymlコマンドを実行してリリースします。

ネットワークロードバランサ(NLB)インスタンス作成のユースケース

1. 以下のサンプルコードを nks-lb.ymlファイルとして保存します。

• 以下のサンプルコードで、プライベートネットワークプロキシタイプのロードバランサインスタンスを作成するためのアノテーションを確認できます。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      run: my-nginx
  template:
    metadata:
      labels:
        run: my-nginx
    spec:
      containers:
      - name: my-nginx
        image: nginx
        ports:
        - containerPort: 80
---

kind: Service
apiVersion: v1
metadata:
  name: my-nginx
  annotations:
    service.beta.kubernetes.io/ncloud-load-balancer-layer-type: "nlb"
    service.beta.kubernetes.io/ncloud-load-balancer-internal: "true"    
    service.beta.kubernetes.io/ncloud-load-balancer-size: "SMALL"
spec:
  ports:
  - port: 80
    targetPort: 80
  selector:
    run: my-nginx
  type: LoadBalancer

2. kubectl apply -f nks-lb.ymlコマンドを実行してリリースします。

作成されたロードバランサインスタンスの 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

インスタンス削除

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

LoadBalancerタイプで作成した Kubernetesサービスを確認して削除する方法は、次の通りです。

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

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

$ kubectl --kubeconfig $KUBE_CONFIG get service

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

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