[Kubernetes] 2. Pod, Deployment, YAML

1. Pod

간단한 파드 실행(YAML없이)은 아래 명령어로 가능하다.

# 파드 실행 (컨테이너 하나)
$ kubectl run {파드이름} --image={컨테이너이미지}

# 모든 파드 확인
$ kubectl get pods

# 파드 정보 확인
$ kubectl get pod {파드이름}

# 파드 상세 정보 확인
$ kubectl describe pod {파드이름}

# 파드 삭제
$ kubectl delete pod {파드이름}

# 모든 파드 삭제
$ kubectl delete pods --all

위 명렁어로 파드를 실행하고, 정보를 확인할 수 있다.

각 파드들은 한 노드에 배정된다.

파드 두 개를 생성하고, 아래 명령어를 실행해보면 노드 내에 파드가 생성된 것을 볼 수 있다.

$ kubectl describe node {노드 이름}

$ kubectl describe node docker-desktop

 

 

쿠버네티스 내에는 파드 내에 컨테이너 개수를 한 개 이상 유지한다.

그렇다면, 컨테이너를 삭제하게 되면 어떻게 될까?

 

실행중인 컨테이너를 삭제하고 다시 조회해보니, 식별자가 다른 컨테이너가 다시 실행된 것을 볼 수 있다.

 

쿠버네티스가 새로운 컨테이너로 파드를 복원한 것이다.

 

앞선 포스팅에서 설명했던 자기수복성(self-healing)의 성격이 드러난다.

 

 

 

2. Port-Forwarding

 

앞서 실행했던 애플리케이션을 포트포워딩하여 접속해 보겠다.

 

$ kubectl port-forward pod/{파드 이름} {들어오는 포트}:{파드의 포트}

$ kubectl port-forward pod/hello-kiamol 8080:80

 

파드의 포트포워딩이 된 것을 확인할 수 있다.

 

 

 

3. Deployment

 

# 디플로이먼트 생성
$ kubectl create deployment {디플로이먼트이름} --image={이미지이름}

# 디플로이먼트 출력
$ kubectl get deploy

# 디플로이먼트 삭제
$ kubectl delete deploy {디플로이먼트이름}

# 디플로이먼트 모두 삭제
$ kubectl delete deploy --all

위 명령어로 deployment를 생성할 수 있다.

 

디플로이먼트를 생성하면, 자동으로 디플로이먼트 이름 뒤에 무작위 문자열이 붙은 파드가 생성된다.

 

여기서 중요한 점은, 디플로이먼트가 파드의 '이름'을 통해서 관리한다.

 

따라서 이름을 변경하게 되면, 디플로이먼트의 관리에서 벗어나게 된다.

 

 

디플로이먼트의 포트포워딩은 아래와 같다.

$ kubectl port-forward deploy/{디플로이먼트이름} 8080:80

뒤에 생긴 무작위 문자열을 입력할 필요는 없고, 디플로이먼트가 가진 파드 중 하나를 대상으로 지정하게 된다.

 

 

 

 

 

4. Application Menifest

 

위에서 살펴본 파드와 디플로이먼트는 간단한 애플리케이션 배포에서 사용할 수 있겠다.

 

조금 더 복잡한 애플리케이션 배포를 위해, 쿠버네티스 YAML파일을 이용해야 한다.

 

- pod.yml

# 쿠버네티스 API 버전 & 리소스 유형
apiVersion: v1
kind: Pod

#리소스의 이름(필수) & 레이블(필수X)
metadata:
  name: hello-kiamol-3

#리소싀 정의 내용
#실행할 컨테이너 : 이름, 이미지
spec:
  containers:
    - name: web
      image: kiamol/ch02-hello-kiamol

 

YAML파일을 작성했으면, 아래 명령어로 애플리케이션을 배포할 수 있다.

 

$ kubectl apply -f {yaml경로}
pod/hello-kiamol-3 created


$ kubectl apply -f pod.yaml
NAME                              READY   STATUS    RESTARTS   AGE
hello-kiamol                      1/1     Running   2          3h35m
hello-kiamol-2-5dbf59b864-wjllt   1/1     Running   0          18m
hello-kiamol-3                    1/1     Running   0          9s

새로운 파드 hello-kiamol-3가 생성된 것을 볼 수 있다.

 

선언적 스크립트를 통해 여러 환경에서도 실행할 수 있는 환경을 구축할 수 있다.

 

만약 yaml이 외부에 있어도 실행할 수 있다.

 

$ kubectl apply -f https://raw.githubusercontent.com/sixeyed/kiamol/master/ch02/pod.yaml

 

yaml파일에 대한 정보는 공식 문서에서 추가로 확인해보자.

https://kubernetes.io/ko/docs/tasks/manage-kubernetes-objects/declarative-config/

구성 파일을 이용한 쿠버네티스 오브젝트의 선언형 관리

 

 

 

 

5. 애플리케이션 관리

 

실행중인 애플리케이션에 접근하는 방법을 알아보자.

 

# 애플리케이션 대화형 셸 생성
$ kubectl exec -it {파드이름} sh

위 명령어를 통해 애플리케이션 내에 접속할 수 있다.

 

 

셸 안에선 다음 명령어로 테스트해볼 수 있다.

 

#IP 확인
$ hostname -i

# 웹 애플리케이션 동작 확인
$ wget -O - http://localhost | head -n 4

# 종료
$ exit

 

 

아래 명령어는 쿠버네티스 컨테이너의 로그를 출력할 수 있다.

 

# 전체 로그 출력
$ kubectl logs {파드이름}

# 마지막 두 줄 로그 출력
$ kubectl logs --tail=2 {파드이름}

 

 

 

참고
Learn Kubernetes in a Month of Lunches: Stoneman, Elton
https://kubernetes.io/docs/reference/kubectl/