쿠버네티스 명령적 접근방식 이용
시작
쿠버네티스는 인프라를 관리하지 않는다.
쿠버네티스는 클러스터, 마스턴 노드, 워커 노드를 구성하고 리소스를 생산하지만 파드 모니터링, 파드 컨테이너 모니터링, 파드 교체 및 스케일링, 파드 내부 컨테이너 오케스트레이션, 워커 노드 간 컨테이너 이동 등이 주된 일입니다. 인프라 환경은 직접 구성해야합니다.
또한 클라우드 프로바이더가 아니며 컨테이너화된 앱을 배포하는 프레임워크일 뿐입니다. 보안, 시스템 관리, 인스턴스 및 운영 체제 관리 등 쿠버네티스의 역할이 아닙니다. 서버 관리 도구도 아니고 클라우드 프로바이더도 아닌 그저 파드 컨테이너 오케스트레이션 관리 도구입니다.
AWS와 같은 클라우드 프로바이더는 EKS와 같은 전용 서비스가 있어 자체 쿠버네티스 구성을 불러올 수 있습니다. ECS를 사용하지 않아도 됩니다. 이와 비슷하게 제공되는 도구인 Kubermatic
으로 이 인프라 부분은 어느정도 보조할 수 있습니다.
즉 파드와 컨테이너 모니터링 스케일링, 프록시 관리
가 주된 쿠버네티스의 역할입니다.
인프라 환경을 로컬 환경으로 모방하기
클러스터를 구성하고 마스터 노드를 구성하고 하나 이상의 워커노드를 둔다. 마스터 노드에는 API서버, 스케줄러를 설치하고 워커노드에는 kubelet, 도커가 설치되어 있어야 합니다. 이것이 전반적인 환경입니다.
로컬에는 kubectl
도구가 필요합니다. 배포 변경과 같은 명령을 클러스터에 보내는 역할입니다. 마스터 노드는 워커 노드와 관련해 필요 작업을 수행하고(파드 생성 명령 등) kubectl 도구를 이용해 실제로 클러스터 내부로 명령을 발송하게 됩니다.
이제 더미 클러스터를 생성해 이 과정이 수행되는지 확인을 위해 minikube
도구를 사용해보겠습니다. 이 도구는 주로 테스트 용도로 사용하는 도구입니다. 가상 머신을 사용해 다른 가상 머신을 제어하고 머신에 마스터 노드, 워커 노드 역할을 부여하죠
Windows 설치
윈도우로 시작하는 경우에 Pro버전이 아니라면 WSL을 우선 설치합니다. WSL
이어서 Docker Desktop도 같이 설치합니다. 설치시 WSL2를 이용하도록 설정합니다.
kubectl
minikube를 설치하기 이전에 Hypervisor를 설치해야합니다. virtualBox와 같은 드라이버를 이용할 수 있겠죠.
이후 드라이버 설치 후 클러스터에 명령할 kubectl를 우선 설치해야합니다.
관련 패키지 설치를 위한 툴 Chocolatey을 설치합니다.
아래 명령을 Powershell -> 관리자 권한으로 실행 후 사용합니다.
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
이후 kubernetes-cli 를 설치합니다.
choco install kubernetes-cli
버전을 확인합니다.
kubectl version --client
이어서 가상머신 실행을 위한 virtualBox를 설치합니다.
클러스터로 구성하기 위해 minikube를 설치합니다.
choco install minikube
드라이버를 설정하여 minikube를 실행합니다. 드라이버 목록 에서 어떤 드라이브가 존재하는지 확인할 수 있습니다.
minikube start --driver=virtualbox
클러스터를 구성하고 마스터 노드, 워커 노드를 구성합니다. 실제로 워커와 마스터 노드가 리소스를 공유하는 하나의 노드만 설정합니다. 개발용이기 때문이죠. 쿠버네티스 소프트웨어, API서버, kubelet도 설치하여 캡슐화된 가상 머신 내부에 모든 것을 설정해줍니다.
실행과정에서 다음과 같은 트러블슈팅이 발생할 수 있습니다.
* virtualbox VM (CPUs=2, Memory=6000MB, Disk=20000MB) 를 생성하는 중 ...
* Failed to start virtualbox VM. Running "minikube delete" may fix it: creating host: create: precreate: This computer is running Hyper-V. VirtualBox won't boot a 64bits VM when Hyper-V is activated. Either use Hyper-V as a driver, or disable the Hyper-V hypervisor. (To skip this check, use --virtualbox-no-vtx-check)
X Exiting due to PR_VBOX_HYPERV_64_BOOT: Failed to start host: creating host: create: precreate: This computer is running Hyper-V. VirtualBox won't boot a 64bits VM when Hyper-V is activated. Either use Hyper-V as a driver, or disable the Hyper-V hypervisor. (To skip this check, use --virtualbox-no-vtx-check)
* 권장: VirtualBox and Hyper-V are having a conflict. Use '--driver=hyperv' or disable Hyper-V using: 'bcdedit /set hypervisorlaunchtype off'
* 관련 이슈들:
- https://github.com/kubernetes/minikube/issues/4051
- https://github.com/kubernetes/minikube/issues/4783
Hypervisor가 활성화된 경우 virtualBox와 충돌되기 때문입니다. 내장 Hypervisor가 있는 경우 드라이버를 --driver=hyperv
로 사용해도 되지만, 이 기능이 없는 경우에는 VirtaulBox를 사용할 수 있습니다.
이전 설정은 제거하고 hyperv로 실행합니다. 이 과정에서 명령 프롬프트 환경은 관리자 권한으로 실행한 상태여야 합니다.
M1 실리콘 칩의 경우는 docker
드라이버만 지원합니다.
minikube delete
minikube start --driver=hyperv
실행 확인을 위해 상태 정보를 조회합니다.
minikube status
아래와 같은 정보가 조회되면 정상적인 상태입니다.
type: Control Plane
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured
아래 명령으로 클러스터의 대시보드를 확인할 수 있습니다.
minikube dashboard
kubernetes 내부 동작 이해하기
쿠버네티스는 몇 가지 객체를 가지고 있습니다. 파드, 디플로이먼트, 서비스, 볼륨 ... 등의 객체 입니다. 특정 명령으로 이 객체들을 생성하고 작업을 수행할 수 있습니다.
Pod
파드는 쿠버네티스의 가장 작은 단위입니다. 여러 컨테이너를 포함하고 실행합니다. 하나 혹은 복수의 컨테이너를 가질 수 있죠. 특정워커노드에서요. Pod는 하나 또는 여러 컨테이너를 실행할 뿐 아니라 볼륨 같은 리소스도 공유합니다. 파드에는 클러스터 IP를 가지고 있습니다. 이 IP를 통해 외부 파드와도 통신할 수 있습니다.
동일 클러스터내 여러 파드가 존재하는 경우 localhost를 통해 통신할 수 있습니다.
Pod는 영구적이지 않습니다. 쿠버네티스에 의해 제거되면 저장되는 데이터는 제거됩니다. 볼륨 처럼 데이터를 유지할 수 있지만 기본적으로 제거되니 이 점을 염두해 두어야합니다. 컨테이너 또한 파드의 컨셉과 동일하죠.
Deployment
Deployment 객체는 주요 객체로, 수동으로 pod를 생성해 특정 워커노드로 이동시키지 않습니다. deployment가 우선 동작하여 생성 및 관리해야하는 pod 수, 컨테이너 수에 대한 지침을 제공합니다. deployment는 하나 이상의 파드를 관리합니다. 내부적으로 컨트롤러 객체를 구성하는데, 이를 포함하는 것이 deployment객체입니다. 컨테이너를 생성하고 컨테이너를 생성할 파드, 이 파드를 워커 노드에 배치합니다. 메모리, cpu등도 할당하겠죠. 쿠버네티스가 이 작업을 수행합니다.
deployment가 실패해도 롤백 혹은 이전에 작동한 상태로 되돌릴 수 있습니다. 새 deployment만 시작하면 됩니다. 또한 스케일링도 가능합니다. 더 많고 적은 파드를 생성할 수 있고, cpu메트릭을 수신해 트래픽이 증가하면 추가 파드를 생성하기도 하겠죠. 이것이 deployment객체의 모든 역할 입니다. 기본적으로 deployment객체를 구성하고 쿠버네티스 클러스터에 전송해 요구 사항을 수행합니다.
명령적 접근 방식으로 구성하기
우선 컨테이너를 실행하기 위해 이미지를 생성합니다.
docker build -t 이름 빌드컨텍스트
클러스터로 명령을 보내기 이전 활성 상태인지 확인합니다.
type: Control Plane
host: Nonexistent
kubelet: Nonexistent
apiserver: Nonexistent
kubeconfig: Nonexistent
클러스터로 명령을 보내는 경우, 예로 마스터 노드, 컨트롤 플레인의 경우 kubectl
명령을 사용합니다.
아래 명령 및 docs를 이용해 사용법을 익혀둡시다.
$ kubectl help
이제 deployment를 생성해봅시다.
$ kubectl create deployment first-app --image=kub-first-app
deployment.apps/first-app created
$ kubectl get deployments
NAME READY UP-TO-DATE AVAILABLE AGE
first-app 0/1 1 0 2m12
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
first-app-6897769c85-t69pv 0/1 ErrImagePull 0 73s
이미지 pull에러로 파드가 생성되지 않은 것을 볼 수 있습니다. 컨테이너가 실행되는 공간은 가상 공간입니다. 로컬에 있는 이미지를 가져올 수 없기 때문에 위와 같은 에러가 발생합니다.
로컬에서는 찾을 수 없어서 dockerHub에서 가져오려하지만 Hub에도 이미지가 없는 경우입니다. 이 경우 Hub에 이미지를 업로드해야합니다.
다시 생성이 필요하므로 기존 deployment는 제거합니다.
$ kubectl delete deployment first-app
deployment.apps "first-app" deleted
이미지의 태그를 변경합니다.
docker tag kub-first-app 레포명/kub-first-ap
docker push 레포명/kub-first-app
다시 deployment를 생성합니다.
kubectl create deployment first-app --image=레포명/kub-first-app
deployment.apps/first-app created
$ kubectl get deployments
NAME READY UP-TO-DATE AVAILABLE AGE
first-app 1/1 1 1 21s
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
first-app-77c589c8b6-k5pln 1/1 Running 0 58s
정상적으로 앱이 실행중인 결과를 볼 수 있습니다.
kubectl의 작동 배경 되짚어보기
먼저 디플로이먼트 객체를 생성합니다. 이 내용을 현재는 명령적 접근 방식으로 진행해 컨트롤 플레인으로 전송합니다. (minikube status를 확인했을때, type은 마스터 노드(컨트롤 플레인)으로 실행되고 있었습니다.)
마스터 노드는 클러스터에 필요한 모든 것을 생성합니다. 워커 노드에 파드를 배포하는 일을 주로 담당하죠 마스터 노드의 스케쥴러가 실행 중인 파드를 분석해 이에 적합한 노드를 찾고 deployment 기반으로 생성합니다.
파드는 워커 노드 중 하나로 보내집니다. 보통 라벨을 선택하지 않는한 가장 적은 작업을 하는 워커노드에 생성합니다.
이 워커 노드에서는 kubelet서비스를 얻습니다. 파드를 관리하고 컨테이너를 생성하고 파드를 모니터링 합니다. 파드내 컨테이너는 deployment를 생성할 당시 이미지를 기반으로 실행됩니다.
이번엔 클러스터 외부에서 접근할 수 있는 방법을 알아봅시다.
Service 객체
클러스터의 파드를 외부에서 접근 가능하도록 하는 객체입니다.
파드는 기본적으로 내부 IP주소가 있습니다. minikube 구동 시 대시보드에서 확인할 수 있습니다. 이 IP는 외부에서 접근 불가능하며 파드가 교체될 때마다 유동적입니다. 그러므로 IP로 파드에 접근하는 방식은 알맞지 않습니다. 이는 클러스터 내부라도 동일합니다.
service는 파드를 그룹화하고 공유 주소, 공유 IP를 제공하며 정보는 변경되지 않습니다. 또한 클러스터 외부에서 접근 가능하도록 IP를 노출할 수 있습니다.
service로 deployment 노출하기
아래 명령은 service를 생성하고 deployment에 의해 생성된 파드를 노출하는 명령입니다.
$ kubectl expose deployment first-app --type=LoadBalancer --port=8080
service/first-app exposed
# type
# ClusterIP : 클러스터 내부에서만 연결 가능
# NodePort : deployment가 실행 중인 워커 노드의 IP주소를 통해 노출
# LoadBalancer : 클러스터가 실행되는, 인프라에 존재해야할 LoadBalancer를 이용.
# service에 대한 고유 주소를 생성하고 트래픽을 service의 일부인 모든 파드에 고르게 분산
# 파드에 여러 인스턴스를 실행하는 경우 중요. aws, minikube는 이 기능이 동작하도록 클러스터내 만들어줌.
$ kubectl get services
# 클러스터 내부 IP, 외부 IP가 보이지 않는 이유는 minikube가 로컬 머신에서 실행되는 가상 머신이기 때문.
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
first-app LoadBalancer 10.101.202.188 <pending> 8080:30113/TCP 24s
kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 39h
현재로서는 로컬의 가상머신이므로 외부에서 접속은 못하지만 minukube를 이용해 로컬 머신에서 접근할 수 있는 방법이 있습니다.
단, 로드밸런서를 지원하는 클라우드 프로바이더(AWS, minikube)에서 서비스를 만든 경우에 한함.
minikube service first-app
만일 의도적으로 first-app 이미지 컨테이너에 충돌을 발생시켜 파드앱 상태가 Error로 변경되는 경우 이를 감지하고 재실행하게 됩니다. 재실행 횟수 또한 카운트되어 표시됩니다.
kubectl get pods
NAME READY STATUS RESTARTS AGE
first-app-77c589c8b6-pkr6h 1/1 Running 2 (19s ago) 35m
파드와 파드내 컨테이너가 모니터링 되는 중이고, 실패하면 재시작됩니다. 이 정보 또한 minikube dashboard를 통해 확인해볼 수 있습니다.
컨테이너 다수 실행하기
번외로, 파드와 컨테이너를 한 번만 생성하는 것이 아니라 세번으로 생성할 수도 있습니다.
# 스케일 항목 지정
# relicas는 파드의 인스턴스로, 3 replicas는 동일 파드/컨테이너가 3번 생성
$ kubectl scale deployment/frist-app --replicas=3
deployment.apps/first-app scaled
# 3개의 파드가 동일 컨테이너 실행
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
first-app-77c589c8b6-mftzw 1/1 Running 0 102s
first-app-77c589c8b6-mt2lc 1/1 Running 0 102s
first-app-77c589c8b6-pkr6h 1/1 Running 2 (8m43s ago) 43m
이 경우 service를 LoadBalancer로 적용해주었기 때문에 트래픽이 동일 컨테이너를 실행하는 파드로 고르게 분산시켜 줍니다.
복사본은 언제 든지 축소/확장할 수 있습니다.
deployment 수정하고 롤백하기
코드를 변경하고 deployment를 수정한 다음 다른 deployment로 롤백하는 방법 또한 지원됩니다.
다시 이미지를 빌드하기 전으로 돌아가 소스코드를 변경하고 이미지로 빌드합니다. 그리고 허브에 업로드합니다.
docker build -t 레포/이름:v2 .
docker push 업로드할 이미지
그리고 deployment가 실행중인지 확인합니다.
$ kubectl get deployments
NAME READY UP-TO-DATE AVAILABLE AGE
first-app 1/1 1 1 56m
# deployment 중 first-app의 실행중인 컨테이너의 이미지를 변경
$ kubectl set image deployment/first-app kub-first-app=wooglim/kube-first-app:v2
deployment.apps/first-app image updated
# 기존 레플리카는 롤아웃 하여 새로 실행되는 파드로 교체
$ kubectl rollout status deployment/first-app
이 경우 의도적으로 이미지의 태그에 오타를 발생시켜 이미지 업로드를 못하게하여 파드가 정상적으로 실행되지 않는 상태로 두는 경우에는 아래와 같은 상태가 됩니다.
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
first-app-77c589c8b6-m6mnr 1/1 Running 0 6m30s
first-app-c979c6fdf-g6bfw 0/1 ImagePullBackOff 0 4m11s
이 경우 문제가 발생하는 deployment를 롤백하여 이전 상태로 되돌릴 수 있습니다.
# 최근 deployment가 undo
$ kubectl rollout undo deployment/first-app
deployment.apps/first-app rolled back
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
first-app-77c589c8b6-m6mnr 1/1 Running 0 8m18s
만일 더 이전의 deployment 로 돌아가려면 아래 수순을 진행합니다.
# 히스토리 확인
$ kubectl rollout history deployment/first-app
deployment.apps/first-app
REVISION CHANGE-CAUSE
2 <none>
3 <none>
# 상세 내용 확인
$ kubectl rollout history deployment/first-app --revision=2
deployment.apps/first-app with revision #2
Pod Template:
Labels: app=first-app
pod-template-hash=c979c6fdf
Containers:
kub-first-app:
Image: wooglim/kube-first-app:v2
Port: <none>
Host Port: <none>
Environment: <none>
Mounts: <none>
Volumes: <none>
# 특정 버전으로 rollback
$ kubectl rollout history deployment/first-app --to-revision=3
이 기능들을 보면 대규모 서비스를 특정 클러스터에서 운용하기에 적합하다는 것을 알 수 있었습니다.
다음은 기존 서비스 및 디플로이먼트를 제거하는 명령입니다.
$ kubectl delete service first-app
service "first-app" deleted
$ kubectl delete deployment first-app
deployment.apps "first-app" deleted