Load Balancer instance integrations

Available in VPC

When you create a service to use Ncloud Kubernetes Service, you can automatically create a Load Balancer instance which is integrated to the service.

Manage Load Balancer instances integrated to Kubernetes

Create instances

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

• nplb: a network proxy load balancer (NPLB) instance is created.
• nlb: a network load balancer (NLB) instance is created.

Set instance properties

You can set properties of an instance created through the service manifest's annotation. To set instance properties, see the following table and enter the metadata.annotations value when creating an instance:

• Network proxy load balancer (NPLB)

• Network load balancer (NLB)

Public/private IP assignment method according to Load Balancer's subnet type

Load balancers use two types of subnets: public subnet and private subnet. Each type is required when creating a Load Balancer with a private or public IP assigned. When creating a Load Balancer, use the lbPublicSubnetNo configured by ncloud-config ConfigMap in the kube-system namespace or the Ssubnet ID in the lbSubnetNo field. This subnet ID can be specified to use a different subnet ID using the service.beta.kubernetes.io/ncloud-load-balancer-subnet-id annotation when creating a Load Balancer.

1. Public Subnet (Internet Gateway only)
A public subnet is required to create a load balancer with an public IP assigned. You may request a public IP from VPC > Public IP on the NAVER Cloud Platform console and assign it to a Load Balancer. If no public IP is specified, a new public IP is applied.

2. Private Subnet
This subnet is required to create a load balancer in the private subnet assigned with a private IP within VPC.

Examples of instance properties settings

For more detailed example of setting instance properties, see Load Balancer properties settings examples.

Example of network proxy load balancer (NPLB) instance creation

An example of creating an NPLB instance integrated to Kubernetes is as follows:

1. Save the following code example as an nks-lb.yml file:

• You can see the annotation to create a private network proxy type Load Balancer instance in the following code example:

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. Run the kubectl apply -f nks-lb.yml command to deploy.

Example of network load balancer (NLB) instance creation

1. Save the following code example as an nks-lb.yml file:

• You can see the annotation to create a private network proxy type Load Balancer instance in the following code example:

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. Run the kubectl apply -f nks-lb.yml command to deploy.

Check the external IP of a created Load Balancer instance

Run the following command to check the external IP of a created instance:

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

The external IP of the instance is displayed in the EXTERNAL-IP column. The following is an example of viewing 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 instance

Delete the Kubernetes service which is created as LoadBalancer type to automatically delete the integrated Load Balancer instance with it.
To check the Kubernetes service created as LoadBalancer type and delete it, follow these steps:

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

• Each service's type can be seen in the result's TYPE column.

$ kubectl --kubeconfig $KUBE_CONFIG get service

2. Run the following command to delete the Load Balancer type service:

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