Information in this document may be out of date
This document has an older update date than the original, so the information it contains may be out of date. If you're able to read English, see the English version for the most up-to-date information: Hello Minikube
Hello Minikube
이 튜토리얼에서는 Minikube를 이용하여 쿠버네티스에서 샘플 애플리케이션을 어떻게 실행하는지 살펴본다. 이 튜토리얼은 NGINX를 통해 모든 요청을 그대로 되돌려 주는 (echo back) 컨테이너 이미지를 제공한다.
목적
- 샘플 애플리케이션을 minikube에 배포한다.
- 배포한 애플리케이션을 실행한다.
- 애플리케이션의 로그를 확인한다.
시작하기 전에
이 튜토리얼은 이미 minikube가 이미 구축되어 있다고 가정한다.
설치 방법은 minikube 시작의 Step 1, Installation 을 참고한다.
참고:
Step 1, Installation의 지침만 실행한다. 나머지 내용은 이 페이지에서 다룬다.또한, kubectl 을 설치해야 한다.
설치 방법은 도구 설치를 참고한다.
minikube 클러스터 만들기
minikube start
대시보드 접속하기
쿠버네티스 대시보드를 여는 방법은 두 가지 방법이 있다.
새 터미널을 열고 다음 명령어를 실행한다.
# 새 터미널에서 시작하고, 해당 터미널은 실행 상태로 두어야 함.
minikube dashboard
이제 minikube start를 실행했던 터미널로 다시 전환한다.
참고:
dashboard 명령어는 대시보드 애드온을 활성화하고 기본 웹 브라우저에서 프록시를 연다.
대시보드에서 디플로이먼트(Deployment), 서비스와 같은 쿠버네티스 리소스를 생성할 수 있다.
브라우저를 터미널에서 직접 호출하지 않고 웹 대시보드에 접속하기 위한 URL을 얻는 방법을 알아보려면, "URL 복사 및 붙여넣기" 탭을 참고한다.
기본적으로 대시보드는 쿠버네티스 내부 가상 네트워크 내에서만 접근할 수 있다.
dashboard 명령어는 대시보드가 쿠버네티스 가상 네트워크 외부에서 접근할 수 있도록 임시 프록시를 생성한다.
프록시를 중지하려면 Ctrl+C를 실행하여 프로세스를 종료한다.
명령이 종료된 후에도 대시보드는 쿠버네티스 클러스터에서 계속 실행된다.
대시보드에 접근하기 위한 또 다른 프록시를 생성하려면 dashboard 명령어를 다시 실행하면 된다.
minikube가 자동으로 웹 브라우저를 열지 않게 하려면, dashboard 서브커맨드를
--url 플래그와 함께 실행한다. minikube는 사용자가 선호하는 브라우저를 사용할 수 있도록 URL을 출력한다.
새 터미널을 열고 다음 명령어를 실행한다.
# 새 터미널에서 시작하고, 해당 터미널은 실행 상태로 두어야 함.
minikube dashboard --url
이제 이 URL을 사용하여 minikube start를 실행했던 터미널로 다시 전환할 수 있다.
디플로이먼트 만들기
쿠버네티스 파드는 관리와 네트워킹 목적으로 함께 묶여 있는 하나 이상의 컨테이너 그룹이다. 이 튜토리얼의 파드에는 단 하나의 컨테이너만 있다. 쿠버네티스 디플로이먼트는 파드의 상태를 확인하고, 파드의 컨테이너가 종료되었다면 재시작한다. 파드의 생성 및 스케일링을 관리하는 방법으로 디플로이먼트를 권장한다.
kubectl create명령어를 실행하여 파드를 관리할 디플로이먼트를 만든다. 이 파드는 제공된 Docker 이미지를 기반으로 한 컨테이너를 실행한다.# 테스트용 웹 서버 컨테이너 이미지를 실행한다. kubectl create deployment hello-node --image=registry.k8s.io/e2e-test-images/agnhost:2.39 -- /agnhost netexec --http-port=8080디플로이먼트 보기
kubectl get deployments다음과 유사하게 출력된다.
NAME READY UP-TO-DATE AVAILABLE AGE hello-node 1/1 1 1 1m(파드가 준비되는 데 시간이 걸릴 수 있다. "0/1"이 표시되면 몇 초 후에 다시 시도해본다.)
파드 보기
kubectl get pods다음과 유사하게 출력된다.
NAME READY STATUS RESTARTS AGE hello-node-5f76cf6ccf-br9b5 1/1 Running 0 1m클러스터 이벤트 보기
kubectl get eventskubectl환경설정 보기kubectl config view파드 내 컨테이너의 애플리케이션 로그를 확인한다. (파드 이름을
kubectl get pods명령어로 얻은 이름으로 교체한다)참고:
아래 `kubectl logs` 명령어에서 `hello-node-5f76cf6ccf-br9b5` 부분을 `kubectl get pods` 명령어 출력에서 얻은 파드 이름으로 교체한다.kubectl logs hello-node-5f76cf6ccf-br9b5출력은 다음과 유사하다.
I0911 09:19:26.677397 1 log.go:195] Started HTTP server on port 8080 I0911 09:19:26.677586 1 log.go:195] Started UDP server on port 8081
서비스 만들기
기본적으로 파드는 쿠버네티스 클러스터 내부의 IP 주소로만
접근할 수 있다. hello-node 컨테이너를 쿠버네티스 가상 네트워크
외부에서 접근하려면 파드를 쿠버네티스
서비스로 노출해야 한다.
경고:
agnhost 컨테이너에는 디버깅에 유용한/shell 엔드포인트가 있지만, 이는
공용 인터넷에 노출하기에 위험하다. 이 컨테이너를 인터넷에 연결된 클러스터나
프로덕션 클러스터에서 실행하지 않는다.kubectl expose명령어로 퍼블릭 인터넷에 파드 노출하기kubectl expose deployment hello-node --type=LoadBalancer --port=8080--type=LoadBalancer플래그는 클러스터 밖의 서비스로 노출하기 원한다는 뜻이다.registry.k8s.io/echoserver이미지 내의 애플리케이션 코드는 TCP 포트 8080에서만 수신한다.kubectl expose를 사용하여 다른 포트를 노출한 경우, 클라이언트는 다른 포트에 연결할 수 없다.생성한 서비스 살펴보기
kubectl get services다음과 유사하게 출력된다.
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE hello-node LoadBalancer 10.108.144.78 <pending> 8080:30369/TCP 21s kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 23m로드 밸런서를 지원하는 클라우드 공급자의 경우에는 서비스에 접근할 수 있도록 외부 IP 주소가 프로비저닝 한다. minikube에서
LoadBalancer타입은minikube service명령어를 통해서 해당 서비스를 접근할 수 있게 한다.다음 명령어를 실행한다
minikube service hello-node이 명령은 브라우저 창을 열어 앱을 보여주고, 그 응답을 표시한다.
애드온 사용하기
minikube 툴은 활성화하거나 비활성화할 수 있고 로컬 쿠버네티스 환경에서 접속해 볼 수 있는 내장 애드온 셋이 포함되어 있다.
현재 지원하는 애드온 목록을 확인한다.
minikube addons list다음과 유사하게 출력된다.
addon-manager: enabled dashboard: enabled default-storageclass: enabled efk: disabled freshpod: disabled gvisor: disabled helm-tiller: disabled ingress: disabled ingress-dns: disabled logviewer: disabled metrics-server: disabled nvidia-driver-installer: disabled nvidia-gpu-device-plugin: disabled registry: disabled registry-creds: disabled storage-provisioner: enabled storage-provisioner-gluster: disabled애드온을 활성화 한다. 여기서는
metrics-server를 예시로 사용한다.minikube addons enable metrics-server다음과 유사하게 출력된다.
The 'metrics-server' addon is enabled생성한 파드와 서비스를 확인한다.
kubectl get pod,svc -n kube-system다음과 유사하게 출력된다.
NAME READY STATUS RESTARTS AGE pod/coredns-5644d7b6d9-mh9ll 1/1 Running 0 34m pod/coredns-5644d7b6d9-pqd2t 1/1 Running 0 34m pod/metrics-server-67fb648c5 1/1 Running 0 26s pod/etcd-minikube 1/1 Running 0 34m pod/influxdb-grafana-b29w8 2/2 Running 0 26s pod/kube-addon-manager-minikube 1/1 Running 0 34m pod/kube-apiserver-minikube 1/1 Running 0 34m pod/kube-controller-manager-minikube 1/1 Running 0 34m pod/kube-proxy-rnlps 1/1 Running 0 34m pod/kube-scheduler-minikube 1/1 Running 0 34m pod/storage-provisioner 1/1 Running 0 34m NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/metrics-server ClusterIP 10.96.241.45 <none> 80/TCP 26s service/kube-dns ClusterIP 10.96.0.10 <none> 53/UDP,53/TCP 34m service/monitoring-grafana NodePort 10.99.24.54 <none> 80:30002/TCP 26s service/monitoring-influxdb ClusterIP 10.111.169.94 <none> 8083/TCP,8086/TCP 26smetrics-server의 출력 결과를 확인한다.kubectl top pods다음과 유사하게 출력된다.
NAME CPU(cores) MEMORY(bytes) hello-node-ccf4b9788-4jn97 1m 6Mi만약 다음의 메시지가 보인다면, 잠시 기다렸다가 다시 시도한다.
error: Metrics API not availablemetrics-server를 비활성화한다.minikube addons disable metrics-server다음과 유사하게 출력된다.
metrics-server was successfully disabled
제거하기
이제 클러스터에서 만들어진 리소스를 제거할 수 있다.
kubectl delete service hello-node
kubectl delete deployment hello-node
Minikube 클러스터를 종료한다.
minikube stop
필요하면 minikube VM을 삭제한다.
# 선택사항
minikube delete
쿠버네티스를 더 배우기 위해 minikube를 다시 사용할 계획이라면, 굳이 삭제하지 않아도 된다.
결론
이 페이지에서는 minikube 클러스터를 실행하고 애플리케이션을 배포하기 위한 기본적인 내용을 다루었다. 이제 애플리케이션을 배포할 준비가 되었다.
다음 내용
- kubectl을 사용해 쿠버네티스에 첫 번째 애플리케이션 배포하기 에 대한 튜토리얼.
- 디플로이먼트 오브젝트에 대해서 더 배워 본다.
- 애플리케이션 배포에 대해서 더 배워 본다.
- 서비스 오브젝트에 대해서 더 배워 본다.