로드밸런서 생성 및 삭제
로드밸런서(Load Balancer)는 시스템으로 유입되는 대량의 트래픽을 다수의 서버로 분산시켜 안정적인 서비스 운영을 지원합니다. Kubernetes Engine 서비스에서 로드밸런 서 타입의 서비스 생성 시 annotation 옵션에 따라, Network Load Balancer(NLB) 또는 Application Load Balancer(ALB)이 생성됩니다.
로드밸런서 생성
Kubernetes Engine 서비스에서 로드밸런서를 생성하는 방법은 다음과 같습니다.
kr-central-2 리전에서는 서로 다른 AZ(가용 영역)를 사용하도록 클러스터 네트워크를 설정하여, 가용성 높은 Multi-AZ 클러스터를 생성할 수 있습니다. 클러스터의 Subnet이 서로 다른 AZ를 사용하는 Multi-AZ 클러스터에 로드밸런서를 생성할 경우, 클러스터 네트워크가 설정되어있는 모든 AZ에 로드밸런서가 기본 생성됩니다.
Multi-AZ 클러스터의 노드 풀이 특정 1개의 AZ에만 설정된 경우에도, 클러스터의 로드밸런서는 모든 AZ에 생성됩니다. 로드밸런서 타입(NLB 또는 ALB)의 구분 없이 모두 과금 대상에 포함되니 유의해 주세요.
사전 작업
Step 1. kubectl 설치 및 제어 설정하기
Kubernetes에서 Service 객체를 생성하기 위해서는 kubectl를 설치하고, 클러스터에 대한 kubectl 제어를 설정해야 합니다. kubectl 설치 및 제어 설정에 대한 자세한 설명은 kubectl 제어 설정을 참고하시기 바랍니다.
Step 2. SSL 인증서 등록 및 관리하기
Kubernetes에서 Application Load Balancer(ALB)를 생성하고 로드밸런서의 리스너를 TERMINATED_HTTPS로 설정할 경우, SSL 인증서가 필요합니다. Kubernetes에서 생성한 Application Load Balancer에 사용할 SSL 인증서는 아래와 같이 등록 및 관리합니다.
인증서 등록하기
-
카카오클라우드 콘솔에서 Container Pack > Kubernetes Engine > Certification 탭으로 이동합니다.
-
Certification 메뉴에서 [인증서 등록하기] 버튼을 클릭합니다.
-
인증서 등록하기 팝업창에서 필요한 정보를 입력 후, [등록하기] 버튼을 클릭합니다.
-
인증서 목록에서 등록한 인증서 정보를 확인합니다.
인증서 삭제하기
-
카카오클라우드 콘솔에서 Container Pack > Kubernetes Engine > Certification 탭으로 이동합니다.
-
Certification 메뉴에서 삭제할 인증서의 [더 보기] 아이콘 > 인증서 삭제를 선택합니다.
-
인증서 삭제 팝업창에서 정보를 입력하고, [삭제] 버튼을 클릭합니다.
Step 1. 로드밸런서 타입 서비스 명세 확인하기
로드밸런서 타입 서비스의 명세를 확인합니다. app: nginx
와 연동된 로드밸런서 타입 서비스 YAML 파일 예시에서 아래의 2개 항목을 확인합니다.
확인 필요 항목 | 설정값 및 설명 |
---|---|
spec.type | 설정값:LoadBalancer ㄴ 로드밸런서 생성을 위한 서비스 타입 설정 |
metadata.annotations 하위의 annotations | 로드밸런서 타입 설정 설정값 loadbalancer.ke.kakaocloud.com/load-balancer-type ㄴ NLB (기본값) : Network Load Balancer 생성 ㄴ ALB : Application Load Balancer 생성 ㄴ annotation 미설정 시, Network Load Balancer로 기본 생성됩니다. 공인 IP 사용 설정 설정값 service.beta.kubernetes.io/openstack-internal-load-balancer ㄴ true (기본값): 사설 IP를 사용 ㄴ false : 공인 IP를 사용 |
NLB 로드밸런서 타입 서비스 명세 확인
kind: Service
apiVersion: v1
metadata:
name: default-http-nginx-service
annotations:
service.beta.kubernetes.io/openstack-internal-load-balancer: 'true'
loadbalancer.ke.kakaocloud.com/load-balancer-type: 'NLB'
spec:
selector:
app: nginx
type: LoadBalancer
ports:
- name: http
port: 80
targetPort: 80
ALB 로드밸런서 타입 서비스 명세 확인
kind: Service
apiVersion: v1
metadata:
name: default-http-nginx-service
annotations:
service.beta.kubernetes.io/openstack-internal-load-balancer: 'true'
loadbalancer.ke.kakaocloud.com/load-balancer-type: 'ALB'
loadbalancer.openstack.org/default-tls-container-ref: 'https://key-manager.{해당 리전의 인증서 path 입력}/v1/secrets/{인증서 ID 입력}'
spec:
selector:
app: nginx
type: LoadBalancer
ports:
- name: http
port: 80
targetPort: 80
Step 2. 로드밸런서 타입 설정하기
로드밸런서 타입 설정에 따라, Network Load Balancer(NLB)또는 Application Load Balancer(ALB)이 생성됩니다.
- 'Network Load Balancer(NLB)' 생성하기
- 'Application Load Balancer(ALB)' 생성하기
Kubernetes Engine 서비스에서 로드밸런서 타입의 서비스를 생성하면 OSI 4계층인 네트워크 계층에서 트래픽을 처리하는 Network Load Balancer(NLB)가 기본적으로 생성됩니다.
metadata.annotations 하위의 annotations
을 아래와 같이 설정합니다.
annotation 항목 | 설정값 및 설명 |
---|---|
loadbalancer.ke.kakaocloud.com/load-balancer-type | Network Load Balancer(NLB) 생성 - "NLB" 로 지정 |
Kubernetes Engine 서비스에서 Application Load Balancer(ALB)를 생성해 OSI 7계층인 애플리케이션 계층에서 트래픽을 처리할 수 있습니다. metadata.annotations 하위의 annotations
을 아래와 같이 설정합니다.
- kr-central-1
- kr-central-2
annotation 항목 | 설정값 및 설명 |
---|---|
loadbalancer.ke.kakaocloud.com/load-balancer-type | Application Load Balancer(ALB) 생성 - "ALB" 로 지정 |
loadbalancer.openstack.org/default-tls-container-ref | Listener 프로토콜이 'TERMINATED_HTTPS' 로 설정되며, SSL 인증서 설정 필요 - "https://key-manager.kr-central-1.kakaoi.io/v1/secrets/{secret UUID 값}" 입력 ㄴ {secret UUID} 영역에 적용할 인증서의 ‘인증서 ID 입력 ㄴ콘솔의 certification 탭에서 인증서 사전 등록 후, 인증서 ID 확인 가능 ㄴALB에 인증서가 적용되지 않으면, Listener 프로토콜이 'HTTP' 로 설정됨 |
annotation 항목 | 설정값 및 설명 |
---|---|
loadbalancer.ke.kakaocloud.com/load-balancer-type | Application Load Balancer(ALB) 생성 - "ALB" 로 지정 |
loadbalancer.openstack.org/default-tls-container-ref | Listener 프로토콜이 'TERMINATED_HTTPS' 로 설정되며, SSL 인증서 설정 필요 - "https://key-manager.kr-central-2.kakaoi.io/v1/secrets/{secret UUID 값}" 입력 ㄴ {secret UUID} 영역에 적용할 인증서의 ‘인증서 ID 입력 ㄴ콘솔의 certification 탭에서 인 증서 사전 등록 후, 인증서 ID 확인 가능 ㄴALB에 인증서가 적용되지 않으면, Listener 프로토콜이 'HTTP' 로 설정됨 |
- ALB annotation 설정 시 리전별로 인증서 설정 path가 다르니, 로드밸런서를 생성하는 리전에 해당하는 annotation을 입력하세요.
- ALB에 적용하는 인증서는 최초 ALB를 생성할 때, 인증서 설정 annotation을 함께 적용해야 합니다.
- 인증서 설정 변경이 필요할 경우, Service 객체를 삭제한 후 다시 생성해야 합니다. 이 때 기존 로드밸런서가 연결 해제 또는 삭제된 후 신규 로드밸런서가 생성되니 유의해 주세요.
Step 3. 로드밸런서 공인 IP 설정하기
로드밸런서 생성 시, 공인 IP 사용 여부를 설정할 수 있습니다.
metadata.annotations 하위의 service.beta.kubernetes.io/openstack-internal-load-balancer
값을 설정하여 로드밸런서의 공인 IP 사용을 설정합니다.
- 사설 IP를 갖는 로드밸런서를 생성하려면 값을
true
로 설정 (기본값) - 공인 IP를 갖는 로드밸런서를 생성하려면 값을
false
로 설정
service.beta.kubernetes.io/openstack-internal-load-balancer
설정값에 따라, 로드밸런서의 공인 IP가 새로운 공인 IP를 생성하여 연결 또는 연결 해제됩니다. false로 설정하여 로드밸런서에 사용한 공인 IP가 있었다면, 이후 true로 설정값을 변경하여도 공인 IP 연결 해제 상태가 되어 공인 IP 과금 대상에 포함되니 유의해 주세요.- Kubernetes Engine 로드밸런서에 사용한 공인 IP 삭제는 카카오클라우드 콘솔의 VPC 메뉴의 퍼블릭 IP 메뉴에서 가능합니다. 자세한 설명은 퍼블릭 IP 생성 및 관리를 참고하시기 바랍니다.
부록. 로드밸런서 상세 옵션 설정하기
Kubernetes Engine 서비스에서 로드밸런서를 생성할 때 추가 옵션을 설정할 수 있습니다. 로드밸런 서 타입 서비스 YAML 파일 예시의 annotations
항목을 확인하여 설정합니다.
옵션 설정 항목 | 설정값 및 설명 |
---|---|
metadata.annotations 하위의 annotations | 공인 IP 삭제 설정 설정값: - loadbalancer.ke.kakaocloud.com/delete-floatingip ㄴ true : 로드밸런서 삭제 시, 해당 로드밸런서에 연결되어 있던 공인 IP를 삭제함 ㄴ false (기본값): 로드밸런서 삭제 시, 해당 로드밸런서에 연결되어 있던 공인 IP를 연결 해제함 Health Check (상태 확인) 조건 설정 설정값: - loadbalancer.openstack.org/health-monitor-timeout ㄴ 로드밸런서 헬스 체크 최대 응답시간을 설정 ㄴ (기본값): 상세 옵션 미지정 시 30 적용됨 ㄴ 조건: 초 단위로 설정하며, 설정값은 제한 없음 - loadbalancer.openstack.org/health-monitor-delay ㄴ 로드밸런서 헬스 체크 주기를 설정 ㄴ (기본값): 상세 옵션 미지정 시 60 적용됨 ㄴ 조건: 초 단위로 설정하며, timeout 값보다 큰 값이 설정되어야 함 - loadbalancer.openstack.org/health-monitor-max-retries ㄴ 설명: 로드밸런서 헬스 체크 최대 재시도 횟수를 설정 ㄴ (기본값): 상세 옵션 미지정 시 5 로 적용됨 ㄴ 조건: 1~10 범위 이내의 값으로 설정되어야 함 |