NGINX 인그레스(Ingress) 컨트롤러로 Minikube에서 인그레스 설정하기

인그레스는 클러스터의 서비스에 대한 외부 액세스를 허용하는 규칙을 정의하는 API 객체이다. 인그레스 컨트롤러는 인그레스에 설정된 규칙을 이행한다.

이 페이지에서는 HTTP URI에 따라 요청을 Service web 또는 web2로 라우팅하는 간단한 인그레스를 설정하는 방법을 보여준다.

시작하기 전에

쿠버네티스 클러스터가 필요하고, kubectl 커맨드-라인 툴이 클러스터와 통신할 수 있도록 설정되어 있어야 한다. 이 튜토리얼은 컨트롤 플레인 호스트가 아닌 노드가 적어도 2개 포함된 클러스터에서 실행하는 것을 추천한다. 만약, 아직 클러스터를 가지고 있지 않다면, minikube를 사용해서 생성하거나 다음의 쿠버네티스 플레이그라운드 중 하나를 사용할 수 있다.

• Katacoda
• Play with Kubernetes

Minikube 클러스터 생성하기

1. 터미널 실행을 클릭한다.

   Launch Terminal

2. (선택 사항) Minikube를 로컬로 설치한 경우 다음 명령을 실행한다.

   minikube start
   

인그레스 컨트롤러 활성화

1. NGINX 인그레스 컨트롤러를 활성화하기 위해 다음 명령을 실행한다.

   minikube addons enable ingress
   

2. NGINX 인그레스 컨트롤러가 실행 중인지 확인한다.

• minikube v1.19 or later
• minikube v1.18.1 or earlier

kubectl get pods -n ingress-nginx

NAME                                        READY   STATUS      RESTARTS    AGE
ingress-nginx-admission-create-g9g49        0/1     Completed   0          11m
ingress-nginx-admission-patch-rqp78         0/1     Completed   1          11m
ingress-nginx-controller-59b45fb494-26npt   1/1     Running     0          11m

kubectl get pods -n kube-system

NAME                                        READY     STATUS    RESTARTS   AGE
default-http-backend-59868b7dd6-xb8tq       1/1       Running   0          1m
kube-addon-manager-minikube                 1/1       Running   0          3m
kube-dns-6dcb57bcc8-n4xd4                   3/3       Running   0          2m
kubernetes-dashboard-5498ccf677-b8p5h       1/1       Running   0          2m
nginx-ingress-controller-5984b97644-rnkrg   1/1       Running   0          1m
storage-provisioner                         1/1       Running   0          2m

```shell
kubectl get pods -n ingress-nginx
```


  참고: 이 작업은 1분 정도 소요될 수 있다.


Output:

```shell
NAME                                        READY   STATUS      RESTARTS   AGE
ingress-nginx-admission-create-2tgrf        0/1     Completed   0          3m28s
ingress-nginx-admission-patch-68b98         0/1     Completed   0          3m28s
ingress-nginx-controller-59b45fb494-lzmw2   1/1     Running     0          3m28s
```

hello, world 앱 배포하기

1. 다음 명령을 사용하여 디플로이먼트(Deployment)를 생성한다.

   kubectl create deployment web --image=gcr.io/google-samples/hello-app:1.0
   

   Output:

   deployment.apps/web created
   

2. 디플로이먼트를 노출시킨다.

   kubectl expose deployment web --type=NodePort --port=8080
   

   Output:

   service/web exposed
   

3. 서비스(Service)가 생성되고 노드 포트에서 사용할 수 있는지 확인한다.

   kubectl get service web
   

   Output:

   NAME      TYPE       CLUSTER-IP       EXTERNAL-IP   PORT(S)          AGE
   web       NodePort   10.104.133.249   <none>        8080:31637/TCP   12m
   

4. 노드포트(NodePort)를 통해 서비스에 접속한다.

   minikube service web --url
   

   Output:

   http://172.17.0.15:31637
   

   참고: Katacoda 환경만 해당: 터미널 패널 상단에서 더하기 기호를 클릭한 다음 Select port to view on Host 1을 클릭한다. 노드포트(이 경우 '31637')를 입력한 다음 Display Port를 클릭한다.

   Output:

   Hello, world!
   Version: 1.0.0
   Hostname: web-55b8c6998d-8k564
   

   이제 Minikube IP 주소와 노드포트를 통해 샘플 앱에 액세스할 수 있다. 다음 단계에서는 인그레스 리소스를 사용하여 앱에 액세스할 수 있다.

인그레스 리소스 생성하기

다음 파일은 hello-world.info를 통해 서비스로 트래픽을 보내는 인그레스 리소스다.

1. 다음 파일을 통해 example-ingress.yaml을 만든다.

service/networking/example-ingress.yaml

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$1
spec:
  rules:
    - host: hello-world.info
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  number: 8080

1. 다음 명령어를 실행하여 인그레스 리소스를 생성한다.

   kubectl apply -f https://k8s.io/examples/service/networking/example-ingress.yaml
   

   Output:

   ingress.networking.k8s.io/example-ingress created
   

2. IP 주소가 설정되었는지 확인한다.

   kubectl get ingress
   

   참고: 이 작업은 몇 분 정도 소요될 수 있다.

   NAME              CLASS    HOSTS              ADDRESS        PORTS   AGE
   example-ingress   <none>   hello-world.info   172.17.0.15    80      38s
   

3. /etc/hosts 파일의 맨 아래에 다음 행을 추가한다.

   참고: Minikube를 로컬에서 실행하는 경우 'minikube ip'를 사용하여 외부 IP를 가져온다. 인그레스 목록에 표시되는 IP 주소는 내부 IP가 된다.

   172.17.0.15 hello-world.info
   

   이것은 hello-world.info에서 Minikube로 요청을 보낸다.

4. 인그레스 컨트롤러가 트래픽을 전달하는지 확인한다.

   curl hello-world.info
   

   Output:

   Hello, world!
   Version: 1.0.0
   Hostname: web-55b8c6998d-8k564
   

   참고: Minikube를 로컬에서 실행하는 경우 브라우저에서 hello-world.info에 접속할 수 있다.

두 번째 디플로이먼트 생성하기

1. 다음 명령을 사용하여 v2 디플로이먼트를 생성한다.

   kubectl create deployment web2 --image=gcr.io/google-samples/hello-app:2.0
   

   Output:

   deployment.apps/web2 created
   

2. 디플로이먼트를 노출시킨다.

   kubectl expose deployment web2 --port=8080 --type=NodePort
   

   Output:

   service/web2 exposed
   

인그레스 수정하기

1. 기존 example-ingress.yaml을 편집하여 다음 줄을 추가한다.

         - path: /v2
           pathType: Prefix
           backend:
             service:
               name: web2
               port:
                 number: 8080
   

2. 변경 사항을 적용한다.

   kubectl apply -f example-ingress.yaml
   

   Output:

   ingress.networking/example-ingress configured
   

인그레스 테스트하기

1. Hello World 앱의 첫 번째 버전에 액세스한다.

   curl hello-world.info
   

   Output:

   Hello, world!
   Version: 1.0.0
   Hostname: web-55b8c6998d-8k564
   

2. Hello World 앱의 두 번째 버전에 액세스한다.

   curl hello-world.info/v2
   

   Output:

   Hello, world!
   Version: 2.0.0
   Hostname: web2-75cd47646f-t8cjk
   

   참고: Minikube를 로컬에서 실행하는 경우 브라우저에서 hello-world.info 및 hello-world.info/v2에 접속할 수 있다.

다음 내용

• 인그레스에 대해 더 보기.
• 인그레스 컨트롤러에 대해 더 보기.
• 서비스에 대해 더 보기.