본문으로 건너뛰기

[Kubernetes] Expose App (Service 생성)

kubectl expose로 Deployment를 Service로 노출하고 기본 ClusterIP 타입을 NodePort로 바꿔 클러스터 외부에서 Flask 앱에 접속하는 방법을 정리합니다.

요약

  • kubectl expose deployment flask-example-app --port 80으로 Service를 만들면 기본 타입은 ClusterIP입니다.
  • kubectl edit service로 type을 NodePort로 바꾸면 <NodeIP>:<NodePort>로 클러스터 외부에서 접속할 수 있습니다.
  • Service 타입에는 ClusterIP, NodePort, LoadBalancer, ExternalName이 있으며 노출 범위가 각각 다릅니다.

목차

Expose APP

이 문서는 Service 생성에 대해 포함된 문서입니다.

Service 란?


Kubernetes Pod 들은 언젠가는 죽게됩니다. 실제 Pod 들은 생명주기를 갖습니다.
워커 노드가 죽으면, 노드 상에서 동작하는 Pod 들 또한 종료됩니다.
Kubernetes 에서 service 는 Pod 들에 접근 할 수 있는 정책을 정의하는 추상적 개념입니다.

  • ClusterIP (기본값)
    • 클러스터 내에서 내부 IP 에 대해 서비스를 노출합니다. 이 방식은 클러스터 내에서만 서비스가 접근될 수 있도록 합니다.
  • NodePort
    • NAT가 이용되는 클러스터 내에서 각각 선택된 노드들의 동일한 포트에 서비스를 노출 시켜줍니다.
      <NodeIP>:<NodePort>를 이용하여 클러스터 외부로부터 서비스가 접근할 수 있도해줍니다. ClusterIP 의 상위 집합입니다.
  • LoadBalancer
    • (지원 가능한 경우) 기존 클라우드에서 외부용 로드밸런서를 생성하고 고정된 공인 IP를 할당합니다.
      NodePort 의 상위 집합입니다.
  • ExternalName
    • 이름으로 CNAME 레코드를 반환함으로써 임의의 이름(Spec 에서 externalName 으로 명시)을 이용하여 서비스를 노출시켜줍니다.
      프록시는 사용되지 않습니다. 이 방식은 kube-dns 버전 1.7 이상에서 지원 가능합니다.
    • 외부 서비스를 쿠버네티스 내부에서 호출 하고자 할때 사용할 수 있습니다.

      Expose APP

      아래 명령어를 통해 APP 을 외부에 노출 할 수 있습니다.
      현재 Hands on 환경은 LoadBalancer or Ingress 가 사용이 불가능하므로 Nodeport 를 이용하여 TEST 해보도록 하겠습니다.

  • expose 옵션으로 생성
      $ kubectl expose deployment flask-example-app --port 80
    
  • create옵션으로 생성
      $ kubectl create service clusterip flask-example-app --tcp=80
    

    위와 명령으로 생성하는 경우, 기본적으로 ClusterIP 로 생성이 됩니다.

아래 명령을 통해 ClusterIP 를 NodePort 로 변경하도록 하겠습니다.

$ kubectl edit service flask-example-app

해당 yaml 구문에서 spec 부분을 보면 아래와 같습니다.

...
spec:
  clusterIP: 10.43.65.110
  ports:
  - port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: flask-example-app
  sessionAffinity: None
  type: ClusterIP              <<<
...

위와 같이 ClusterIP 부분은 NodePort 로 변경하고 저장을 합니다.
(저장 및 종료, VIM or VI 과 동일함.)

NodePort 로 변경이 되었는지 확인합니다.

kubectl get service
NAME                TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)        AGE
kubernetes          ClusterIP   10.43.0.1      <none>        443/TCP        99m
flask-example-app   NodePort    10.43.65.110   <none>        80:32296/TCP   3m26s

위와 같이 32296 로 Port 할당된 것을 확인 할 수 있습니다.
(해당 Port 할당은 따로 yaml 에서 지정을 안하면 랜덤 Mapping 입니다.)

TEST SERVICE

$ curl 192.168.200.110:32296
 Container LAB | POD Working : flask-example-app-959c5f88d-k95wk | v=1

참고 문서

자주 묻는 질문

kubectl expose로 만든 Service를 NodePort로 바꾸려면 어떻게 하나요?

kubectl edit service flask-example-app으로 YAML을 열고 spec의 type: ClusterIP를 NodePort로 수정해 저장합니다. kubectl get service에서 TYPE이 NodePort로 바뀐 것을 확인할 수 있습니다.

NodePort 번호를 지정하지 않으면 어떻게 되나요?

YAML에서 따로 지정하지 않으면 포트가 랜덤으로 할당됩니다. 본문 예제에서는 80:32296/TCP처럼 32296 포트가 할당되었습니다.

ClusterIP와 NodePort의 차이는 무엇인가요?

ClusterIP는 클러스터 내부 IP로만 서비스를 노출하고, NodePort는 선택된 노드들의 동일한 포트로 노출해 클러스터 외부에서도 접근할 수 있게 합니다. NodePort는 ClusterIP의 상위 집합입니다.