[쿠버네티스] 쿠버네티스(kubectl) 명령어 옵션 정리

 

1. 주요 옵션 정리

옵션	약자	설명	예제
-f	File의 약자	파일이나 URL로 리소스를 정의하고 적용	kubectl apply -f pod.yaml
-o	Output의 약자	출력 형식 지정(JSON, YAML, wide 등)	kubectl get pods -o yaml
-l	Label의 약자	레이블을 기준으로 리소스를 필터링	kubectl get pods -l app=my-app
--all	-	모든 네임스페이스의 리소스를 대상으로 실행	kubectl get pods --all
-n	Namespace의 약자	특정 네임스페이스에서 실행	kubectl get pods -n my-namespace
--field-selector	-	특정 필드 조건으로 리소스를 필터링	kubectl get pods --field-selector=status.phase=Running
--dry-run	-	실제 적용하지 않고, 리소스가 적용될지 확인	kubectl apply -f pod.yaml --dry-runt=client
--watch	-	리소스 상태 변화를 실시간으로 관찰	kubectl get pod --watch
--force	-	강제로 작업 실행(예, 강제 삭제)	kubectl delete pod my-pod --force
--grace-period	-	리소스를 삭제하기 전에 기다리는 시간 설정	kubectl delete pod my-pod --grace-period=0
--recursive	-	디렉토리 내의 모든 YAML 파일을 적용	kubectl apply -f ./mainfests --recursive

 

 

 

2. 리소스 조회

명령어	설명	예제
kubectl get	리소스 목록 조회, 기본적으로 요약된 정보를 출력	kubectl get pods
kubectl describe	리소스의 상세 정보(이벤트 포함) 조회	kubectl describe pod my-pod
kubectl logs	Pod의 컨테이너 로그 출력	kubectl logs my-pod
kubectl get events	클러스터의 이벤트 조회	kubectl get events
kubectl top	CPU, 메모리 사용량 조회	kubectl top pod my-pod

 

 

 

3. 리소스 생성

명령어	설명	예제
kubectl apply -f <file>	YAML/JSON 파일을 사용하여 리소스를 생성/업데이트	kubectl apply -f pod.yaml
kubectl create	리소스를 명령어로 직접 생성	kubectl create deployment my-deploy --image=nginx
kubectl run	단일 Pod를 빠르게 생성	kubectl run my-pod --image=nginx
kubectl expose	리소스를 Service로 노출	kubectl expose pod my-pod --port=80

 

4. 리소스 업데이트

명령어	설명	예제
kubectl edit	YAML 파일을 편집하여 리소스 업데이트	kubectl edit deployment my-deploy
kubectl set imgae	Deployment의 컨테이너 이미지 업데이트	kubectl set image deployment my-deploy nginx=nginx:1.19
kubectl scale	리소스의 복제본 수 조정	kubectl scale deployment my-deploy --replicas=3
kubectl rollout status	롤링 업데이트 상태 확인	kubectl rollout status deployment my-deploy
kubectl rollout undo	이전 버전으로 롤백	kubectl rollout undo deployment my-deploy

 

5. 리소스 삭제

명령어	설명	예제
kubectl delete	리소스를 삭제	kubectl delete pod my-pod
kubectl delete -f <file>	YAML/JSON 파일에 정의된 리소스 삭제	kubectl delete -f pod.yaml
kube delete --all	모든 리소스 삭제	kubectl delete pods --all

 

6. 디버깅 및 문제 해결

명령어	설명	예제
kubectl logs	Pod의 로그 출력	kubectl logs my-pod
kubectl logs -f	로그를 실시간으로 스트리밍	kubectl logs my-pod -f
kubectl exec	Pod 내부에서 명령어 실행	kubectl exec -it my-pod -- /bin/bash
kubectl debug	디버깅용 임시 Pod 생성	kubectl debug pod/my-pod
kubectl get events	클러스터에서 발생한 이벤트 조회	kubectl get events

 

 

 

7. 네임스페이스 관리

명령어	설명	예제
kubectl get namespaces	네임스페이스 목록 조회	kubectl get namespaces
kubectl create namespace	새로운 네임스페이스 생성	kubectl create namespace my-namespace
kubectl delete namespace	네임 스페이스 삭제	kubectl delete namespace my-namespace
kubectl config set-context	특정 네임스페이스를 기본으로 설정	kubectl config set-context --current --namespace=my-namespace

 

 

 

8. 클러스터 관리

명령어	설명	예제
kubectl cluster-info	클러스터 정보 출력	kubectl cluster-info
kubectl version	클라이언트 및 서버 버전 정보 확인	kubectl version
kubectl config get-contexts	사용 가능한 컨텍스트 조회	kubectl config get-contexts
kubectl config use-contexts	특정 컨텍스트로 전환	kubectl config use-context my-context
kubectl  proxy	API 서버에 접근할 수 있는 프록시 실행	kubectl proxy

 

 

 

9. 작업 자동화 및 스케줄링

명령어	설명	예제
kubectl get jobs	Job 리소스 조회	kubectl get jobs
kubectl apply -f job.yaml	YAML로 정의된 Job 생성	kubectl apply -f job.yaml
kubectl get cronjobs	CronJob 리소스 조회	kubectl get cronjobs
kubectl apply -f cronjob.yaml	YAML로 정의된 CronJob 생성	kubectl apply -f cronjob.yaml

 

 

 

10. 리소스 백업 및 복구

명령어	설명	예제
kubectl get	리소스를 YAML/JSON 형식으로 백업	kubectl get pod my-pod -o yaml > backup.yaml
kubectl apply	YAML 파일을 이용하여 리소스 복구	kubectl apply -f backup.yaml