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 유형에 따른 공인 및 사설 아이피 할당 방식

로드 밸런서 Subnet은 Public Subnet와 Private Subnet의 두 가지 유형이 있습니다. 각 타입은 공인 및 사설 아이피가 부여된 로드 밸런서를 생성하기 위해 요구됩니다. 로드 밸런서를 생성할 때, 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 전용)
공인 아이피가 부여된 로드밸런서를 생성 하기 위해서는 Public Subnet이 요구됩니다. 네이버 클라우드 플랫폼 콘솔의 VPC > Public IP 메뉴에서 공인 아이피를 신청하고, 이를 로드밸런서에 할당할 수 있습니다. 공인 아이피를 지정하지 않으면 신규 공인 아이피가 신청됩니다.

2. Private Subnet
VPC 내에서 로드 밸런서를 사설 아이피가 할당된 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