Edit This Page

포트 포워딩을 사용해서 클러스터 내 애플리케이션에 접근하기

이 페이지는 kubectl port-forward 를 사용해서 쿠버네티스 클러스터 내에서 실행중인 Redis 서버에 연결하는 방법을 보여준다. 이 유형의 연결은 데이터베이스 디버깅에 유용할 수 있다.

• 시작하기 전에
• Redis 디플로이먼트와 서비스 생성하기
• 파드의 포트를 로컬 포트로 포워딩하기
• 토의
• 다음 내용

시작하기 전에

• 쿠버네티스 클러스터가 필요하고, kubectl 커맨드-라인 툴이 클러스터와 통신할 수 있도록 설정되어 있어야 합니다. 만약, 아직 클러스터를 가지고 있지 않다면, Minikube를 사용해서 만들거나, 다음의 쿠버네티스 플레이그라운드 중 하나를 사용할 수 있습니다:

• Katacoda
• Play with Kubernetes

버전 확인을 위해서, 다음 커맨드를 실행 kubectl version.

• redis-cli를 설치한다.

Redis 디플로이먼트와 서비스 생성하기

1. Redis 디플로이먼트를 생성한다.

   kubectl apply -f https://k8s.io/examples/application/guestbook/redis-master-deployment.yaml
   

   성공적인 명령어의 출력은 디플로이먼트가 생성됐다는 것을 확인해준다.

   deployment.apps/redis-master created
   

   파드 상태를 조회하여 파드가 준비되었는지 확인한다.

   kubectl get pods
   

   출력은 파드가 생성되었다는 것을 보여준다.

   NAME                            READY     STATUS    RESTARTS   AGE
   redis-master-765d459796-258hz   1/1       Running   0          50s
   

   디플로이먼트 상태를 조회한다.

   kubectl get deployment
   

   출력은 디플로이먼트가 생성되었다는 것을 보여준다.

   NAME         READY   UP-TO-DATE   AVAILABLE   AGE
   redis-master 1/1     1            1           55s
   

   아래의 명령어를 사용하여 레플리카셋 상태를 조회한다.

   kubectl get rs
   

   출력은 레플리카셋이 생성되었다는 것을 보여준다.

   NAME                      DESIRED   CURRENT   READY     AGE
   redis-master-765d459796   1         1         1         1m
   

2. Redis 서비스를 생성한다.

   kubectl apply -f https://k8s.io/examples/application/guestbook/redis-master-service.yaml
   

   성공적인 커맨드의 출력은 서비스가 생성되었다는 것을 확인해준다.

   service/redis-master created
   

   서비스가 생성되었는지 확인한다.

   kubectl get svc | grep redis
   

   출력은 서비스가 생성되었다는 것을 보여준다.

   NAME           TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)    AGE
   redis-master   ClusterIP   10.0.0.213   <none>        6379/TCP   27s
   

3. Redis 서버가 파드 안에서 실행되고 있고, 6379번 포트에서 수신하고 있는지 확인한다.

   kubectl get pods redis-master-765d459796-258hz --template='{{(index (index .spec.containers 0).ports 0).containerPort}}{{"\n"}}'
   

   출력은 포트 번호를 보여준다.

   6379
   

파드의 포트를 로컬 포트로 포워딩하기

1. 쿠버네티스 1.10 버전부터, kubectl port-forward 명령어는 파드 이름과 같이 리소스 이름을 사용하여 일치하는 파드를 선택해 포트 포워딩하는 것을 허용한다.

   kubectl port-forward redis-master-765d459796-258hz 7000:6379
   

   이것은

   kubectl port-forward pods/redis-master-765d459796-258hz 7000:6379
   

   또는

   kubectl port-forward deployment/redis-master 7000:6379
   

   또는

   kubectl port-forward rs/redis-master 7000:6379
   

   또는 다음과 같다.

   kubectl port-forward svc/redis-master 7000:6379
   

   위의 명령어들은 모두 동일하게 동작한다. 이와 유사하게 출력된다.

   I0710 14:43:38.274550    3655 portforward.go:225] Forwarding from 127.0.0.1:7000 -> 6379
   I0710 14:43:38.274797    3655 portforward.go:225] Forwarding from [::1]:7000 -> 6379
   

2. Redis 커맨드라인 인터페이스를 실행한다.

   redis-cli -p 7000
   

3. Redis 커맨드라인 프롬프트에 ping 명령을 입력한다.

   127.0.0.1:7000>ping
   

   성공적인 핑 요청은 PONG을 반환한다.

토의

로컬 7000 포트에 대한 연결은 Redis 서버가 실행중인 파드의 6379 포트로 포워딩된다. 이 연결로 로컬 워크스테이션에서 파드 안에서 실행 중인 데이터베이스를 디버깅하는데 사용할 수 있다.

경고: 알려진 제한사항으로 인해, 오늘날 포트 포워딩은 TCP 프로토콜에서만 작동한다. UDP 프로토콜에 대한 지원은 이슈 47862 에서 추적되고 있다.

다음 내용

kubectl port-forward에 대해 더 알아본다.

피드백

이 페이지가 도움이 되었나요?

피드백 감사합니다. 쿠버네티스 사용 방법에 대해서 구체적이고 답변 가능한 질문이 있다면, 다음 링크에서 질문하십시오. Stack Overflow. 원한다면 GitHub 리포지터리에 이슈를 열어서 문제 리포트 또는 개선 제안이 가능합니다..