Load Balancer instance integrations

Available in VPC

You can automatically create a Load Balancer instance integrated with a service when creating the service to use Ncloud Kubernetes Service.

Management of Load Balancer instances integrated with Kubernetes

Create an instance

To create a Load Balancer instance integrated with Ncloud Kubernetes Service, set the service manifest type to LoadBalancer, and set the service.beta.kubernetes.io/ncloud-load-balancer-layer-type annotation to either nplb or nlb.

• nplb: A Network Proxy Load Balancer (NPLB) instance is created.
• nlb: A Network Load Balancer (NLB) instance is created.

Configure instance properties

You can configure the properties of the instance to be created using annotations in the service manifest. To configure instance properties, enter the metadata.annotations values according to the table below when creating the instance.

• Network Proxy Load Balancer (NPLB)

• Network Load Balancer (NLB)

Public and private IP assignment methods based on the Load Balancer subnet type

Load Balancer subnets are classified into two types: Public Subnet and Private Subnet. Each type is required to create a Load Balancer with a public or private IP assigned, respectively. When creating a Load Balancer, the Subnet ID defined in the lbPublicSubnetNo and lbSubnetNo fields of the ncloud-config ConfigMap in the kube-system namespace is used. This subnet ID can be changed to another ID by using the service.beta.kubernetes.io/ncloud-load-balancer-subnet-id annotation when creating a Load Balancer.

1. Public subnet (for Internet gateway only)
A public subnet is required to create a Load Balancer with a public IP assigned. In the NAVER Cloud Platform console, navigate to > Services > Networking > VPC > Public IP to request a public IP, and assign it to the Load Balancer. If no public IP is specified, a new one will be requested.

2. Private Subnet
To create a Load Balancer with a private IP assigned within a VPC, a private subnet is required.

Examples of configuring instance properties

For detailed examples of configuring instance properties, see Load Balancer properties settings examples.

Check the external IP of the created Load Balancer instance

To check the external IP of the created instance, run the following command:

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

The external IP of the instance will be displayed in the EXTERNAL-IP column. The following is an example of retrieving the external IP using the command.

$ 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

Delete an instance

Deleting a Kubernetes Service created with the LoadBalancer type also automatically deletes the integrated Load Balancer instance.
To check and delete a Kubernetes Service created with the LoadBalancer type:

1. Run the following command to check the created Kubernetes Service:

• You can check the type of each Service in the TYPE column of the result values.

$ kubectl --kubeconfig $KUBE_CONFIG get service

2. Run the following command to delete the Service of LoadBalancer type:

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