--- title: 외부 IP 주소를 노출하여 클러스터의 애플리케이션에 접속하기 content_type: tutorial weight: 10 --- 이 페이지에서는 외부 IP 주소를 노출하는 쿠버네티스 서비스 오브젝트를 생성하는 방법에 대해 설명한다. ## {{% heading "prerequisites" %}} * [kubectl](/ko/docs/tasks/tools/)을 설치한다. * Google Kubernetes Engine 또는 Amazon Web Services와 같은 클라우드 공급자를 사용하여 쿠버네티스 클러스터를 생성한다. 이 튜토리얼은 [외부 로드 밸런서](/ko/docs/tasks/access-application-cluster/create-external-load-balancer/)를 생성하는데, 클라우드 공급자가 필요하다. * `kubectl`이 쿠버네티스 API 서버와 통신하도록 설정한다. 자세한 내용은 클라우드 공급자의 설명을 참고한다. ## {{% heading "objectives" %}} * Hello World 애플리케이션을 다섯 개의 인스턴스로 실행한다. * 외부 IP 주소를 노출하는 서비스를 생성한다. * 실행 중인 애플리케이션에 접근하기 위해 서비스 오브젝트를 사용한다. ## 다섯 개의 파드에서 실행되는 애플리케이션에 대한 서비스 만들기 1. 클러스터에서 Hello World 애플리케이션을 실행한다. {{% code_sample file="service/load-balancer-example.yaml" %}} ```shell kubectl apply -f https://k8s.io/examples/service/load-balancer-example.yaml ``` 위의 명령어는 {{< glossary_tooltip text="디플로이먼트(Deployment)" term_id="deployment" >}} 오브젝트와 관련된 {{< glossary_tooltip term_id="replica-set" text="레플리카셋(ReplicaSet)" >}} 오브젝트를 생성한다. 레플리카셋은 다섯 개의 {{< glossary_tooltip text="파드" term_id="pod" >}}가 있으며, 각 파드는 Hello World 애플리케이션을 실행한다. 1. 디플로이먼트에 대한 정보를 확인한다. ```shell kubectl get deployments hello-world kubectl describe deployments hello-world ``` 1. 레플리카셋 오브젝트에 대한 정보를 확인한다. ```shell kubectl get replicasets kubectl describe replicasets ``` 1. 디플로이먼트를 외부로 노출시키는 서비스 오브젝트를 생성한다. ```shell kubectl expose deployment hello-world --type=LoadBalancer --name=my-service ``` 1. 서비스에 대한 정보를 확인한다. ```shell kubectl get services my-service ``` 결과는 아래와 같은 형태로 나타난다. ```console NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE my-service LoadBalancer 10.3.245.137 104.198.205.71 8080/TCP 54s ``` {{< note >}} `type=LoadBalancer` 서비스는 이 예시에서 다루지 않은 외부 클라우드 공급자가 지원하며, 자세한 내용은 [이 페이지](/ko/docs/concepts/services-networking/service/#loadbalancer)를 참조한다. {{< /note >}} {{< note >}} 만약 외부 IP 주소가 \으로 표시되면 잠시 기다린 다음, 동일한 명령어를 다시 입력한다. {{< /note >}} 1. 서비스에 대한 자세한 정보를 확인한다. ```shell kubectl describe services my-service ``` 출력 결과는 다음과 유사하다. ```console Name: my-service Namespace: default Labels: app.kubernetes.io/name=load-balancer-example Annotations: Selector: app.kubernetes.io/name=load-balancer-example Type: LoadBalancer IP: 10.3.245.137 LoadBalancer Ingress: 104.198.205.71 Port: 8080/TCP NodePort: 32377/TCP Endpoints: 10.0.0.6:8080,10.0.1.6:8080,10.0.1.7:8080 + 2 more... Session Affinity: None Events: ``` 서비스에 의해 노출된 외부 IP 주소 (`LoadBalancer Ingress`)를 기억해두자. 예시에서 외부 IP 주소는 104.198.205.71이다. 그리고 `Port`와`NodePort`의 값을 기억해두자. 예시에서 `Port`는 8080이고 `NodePort`는 32377이다. 1. 위의 출력 결과를 통해, 서비스에 여러 엔드포인트가 있음을 알 수 있다. 10.0.0.6:8080,10.0.1.6:8080,10.0.1.7:8080 + 2. 이 주소는 Hello World 애플리케이션을 실행 중인 파드의 내부 주소다. 해당 주소가 파드 주소인지 확인하려면, 아래 명령어를 입력하면 된다. ```shell kubectl get pods --output=wide ``` 출력 결과는 다음과 유사하다. ```console NAME ... IP NODE hello-world-2895499144-1jaz9 ... 10.0.1.6 gke-cluster-1-default-pool-e0b8d269-1afc hello-world-2895499144-2e5uh ... 10.0.1.8 gke-cluster-1-default-pool-e0b8d269-1afc hello-world-2895499144-9m4h1 ... 10.0.0.6 gke-cluster-1-default-pool-e0b8d269-5v7a hello-world-2895499144-o4z13 ... 10.0.1.7 gke-cluster-1-default-pool-e0b8d269-1afc hello-world-2895499144-segjf ... 10.0.2.5 gke-cluster-1-default-pool-e0b8d269-cpuc ``` 1. Hello World 애플리케이션에 접근하기 위해 외부 IP 주소 (`LoadBalancer Ingress`)를 사용한다. ```shell curl http://: ``` ``는 서비스의 외부 IP 주소 (`LoadBalancer Ingress`)를 의미하며, ``는 서비스 정보에서 `Port` 값을 의미한다. 만약 minikube를 사용하고 있다면, `minikube service my-service` 명령어를 통해, 자동으로 브라우저 내에서 Hello World 애플리케이션에 접근할 수 있다. 성공적인 요청에 대한 응답으로 hello 메세지가 나타난다. ```shell Hello, world! Version: 2.0.0 Hostname: 0bd46b45f32f ``` ## {{% heading "cleanup" %}} 서비스를 삭제하려면, 아래의 명령어를 입력한다. ```shell kubectl delete services my-service ``` Hello World 애플리케이션을 실행 중인 디플로이먼트, 레플리카셋, 파드를 삭제하려면, 아래의 명령어를 입력한다. ```shell kubectl delete deployment hello-world ``` ## {{% heading "whatsnext" %}} [애플리케이션과 서비스 연결하기](/ko/docs/tutorials/services/connect-applications-service/)에 대해 더 배워 본다.