Kubernetes 기본 용어 사용방법

시작하기전에...

해당 문서는 쿠버네티스 공식 홈페이지를 참고하여 작성하였습니다.

https://kubernetes.io/ko/

운영 수준의 컨테이너 오케스트레이션

 

Kubectl 명령어

kubectl 명령어 중 가장 많이 사용되는 명령어만 정리 해 보았다.

명령어	설명
create	리소스를 생성하는데 사용한다.
apply	create와 비슷하나 이미 존재하는것은 변경해준다.
get	리소스의 상태를 보여준다.
describe	리소스의 상태를 상세하게 보여준다.
delete	리소스를 제거하는데 사용한다.
logs	컨테이너의 로그를 확인.
exec	컨테이너에 명령어를 전달. 컨테이너에 접근할 때 주로 사용한다.
config	kubectl 설정을 관리한다.

 

리소스 생성 (apply or create)

YAML로 작성하고 apply 명령어로 선언하면 원하는 리소스를 생성 할 수 있다.

파일명 뿐 아니라 URL도 입력 가능하다.

kubectl apply -f [파일명 또는 URL]

아래와 같이 실행 할 수 있다.

# URL로 배포하는 경우
kubectl apply -f https://subicura.com/k8s/code/guide/index/wordpress-k8s.yml

 

리소스 목록보기 (get)

쿠버네티스에 선언된 리소스를 확인하는 명령어는 아래와 같다.

kubectl get [TYPE]

다양한 옵션들이 있는데 여기서는 출력 형태를 변경할 수 있는 -o와 레이블을 확인할 수 있는 --show-labels은 아래와 같다.

# Pod 조회
kubectl get pod

# 줄임말(Shortname)과 복수형 사용가능
kubectl get pods
kubectl get po

# 여러 TYPE 입력
kubectl get pod,service
kubectl get po,svc

# Pod, ReplicaSet, Deployment, Service, Job 조회 => all
kubectl get all

# 결과 포멧 변경
kubectl get pod -o wide
kubectl get pod -o yaml
kubectl get pod -o json

# Label 조회
kubectl get pod --show-labels

 

리소스 상세 상태보기 (describe)

쿠버네티스에 선언된 리소스의 상세한 상태를 확인하는 명령어는 아래와 같다.

kubectl describe [TYPE]/[NAME] 또는 [TYPE] [NAME]

특정 리소스의 상태가 궁금하거나 생성이 실패한 이유를 확인할 때 주로 사용한다.

 # Pod 조회로 이름 검색
kubectl get pod

# 조회한 이름으로 상세 확인
kubectl describe pod/wordpress-5f59577d4d-8t2dg # 환경마다 이름이 다르다

 

리소스 제거 (delete)

쿠버네티스에 선언된 리소스를 제거하는 명령어는 다음과 같다.

kubectl delete [TYPE]/[NAME] 또는 [TYPE] [NAME]

# Pod 조회로 이름 검색
kubectl get pod

# 조회한 Pod 제거
kubectl delete pod/wordpress-5f59577d4d-8t2dg

Pod을 제거해도 ReplicaSet이 Pod의 개수를 유지해 주기 때문에 계속 다시 살아난다.

 

컨테이너 로그 조회 (logs)

컨테이너의 로그를 확인하는 명령어는 다음과 같다.

kubectl logs [POD_NAME]

실시간 로그를 보고 싶다면 -f 옵션을 이용하고 하나의 Pod에 여러 개의 컨테이너가 있는 경우는 -c 옵션으로 컨테이너를 지정해야 한다.

# Pod 조회로 이름 검색
kubectl get pod

# 조회한 Pod 로그조회
kubectl logs wordpress-5f59577d4d-8t2dg

# 실시간 로그 보기
kubectl logs -f wordpress-5f59577d4d-8t2dg

 

컨테이너 명령어 전달 (exec)

컨테이너에 접속하는 명령어는 다음과 같다.

kubectl exec [-it] [POD_NAME] -- [COMMAND]

쉘로 접속하여 컨테이너 상태를 확인하는 경우에 -it 옵션을 사용하고 여러 개의 컨테이너가 있는 경우엔 -c 옵션으로 컨테이너를 지정한다.

# Pod 조회로 이름 검색
kubectl get pod

# 조회한 Pod의 컨테이너에 접속
kubectl exec -it wordpress-5f59577d4d-8t2dg /bin/bash

 

설정 관리 (config)

kubectl은 여러 개의 쿠버네티스 클러스터를 컨텍스트(context)로 설정하고 필요에 따라 선택할 수 있다. 현재 어떤 컨텍스트로 설정되어 있는지 확인하고 원하는 컨텍스트를 지정한다.

# 현재 컨텍스트 확인
kubectl config current-context

# 컨텍스트 설정
kubectl config use-context minikube

 

기타

# 전체 오브젝트 종류 확인
kubectl api-resources

# 특정 오브젝트 설명 보기
kubectl explain pod