kubectl 실전 명령어 완벽 가이드 — 쿠버네티스 입문자가 외워야 할 30개

# 버전 확인 — 가장 먼저 치는 명령어
kubectl version --short

# 현재 연결된 클러스터 확인
kubectl cluster-info

kubectl <동사> <리소스> <이름> [옵션]

kubectl get pod nginx -o yaml
#        ──┬── ─┬─ ──┬── ───┬───
#         동사 리소스 이름   옵션

# 전체 Pod 상태
kubectl get pods
kubectl get pods -o wide          # IP·노드 정보까지
kubectl get pods -n kube-system   # 특정 네임스페이스
kubectl get pods -l app=nginx     # 라벨 필터
kubectl get pods -A               # 모든 네임스페이스
kubectl get pods --watch          # 실시간 변화 관찰

# 상세 정보 (이벤트·조건·연결 확인)
kubectl describe pod <pod-name>

# 로그
kubectl logs <pod-name>
kubectl logs -f <pod-name>              # 실시간 팔로우
kubectl logs --previous <pod-name>      # 직전 종료된 컨테이너 로그
kubectl logs --tail=100 <pod-name>      # 마지막 100줄
kubectl logs -l app=nginx --all-containers  # 라벨 기반 일괄 조회

# 리소스 사용량 (metrics-server 필요)
kubectl top pods
kubectl top nodes

# YAML 원본 추출
kubectl get deployment nginx -o yaml

# 선언적 배포 — YAML을 원천으로
kubectl apply -f deployment.yaml
kubectl apply -f ./k8s/              # 디렉토리 전체
kubectl apply -k ./overlays/prod     # Kustomize 오버레이

# 삭제
kubectl delete -f deployment.yaml
kubectl delete pod <name>
kubectl delete pods --all -n test    # 네임스페이스 내 Pod 일괄

# 즉석 편집 (배포본 수정 → 저장 시 반영)
kubectl edit deployment nginx

# 스케일
kubectl scale deployment nginx --replicas=5

# 이미지만 빠르게 교체 (CD 파이프라인에서 자주 사용)
kubectl set image deployment/nginx nginx=nginx:1.28

kubectl create deployment demo --image=nginx --dry-run=client -o yaml > demo.yaml

# 배포 진행 상태 확인 (CD 파이프라인 체크용)
kubectl rollout status deployment/nginx

# 배포 히스토리
kubectl rollout history deployment/nginx
kubectl rollout history deployment/nginx --revision=3  # 특정 리비전 상세

# 롤백
kubectl rollout undo deployment/nginx                  # 직전 버전
kubectl rollout undo deployment/nginx --to-revision=2  # 특정 버전

# 재시작 (ConfigMap 변경 후 Pod 재생성 강제)
kubectl rollout restart deployment/nginx

# 진행 중인 배포 일시정지 / 재개
kubectl rollout pause deployment/nginx
kubectl rollout resume deployment/nginx

# 컨테이너 안으로 진입
kubectl exec -it <pod-name> -- bash
kubectl exec -it <pod-name> -- sh   # bash 없는 이미지용
kubectl exec <pod-name> -- env      # 환경변수만 출력

# 로컬 포트 ↔ Pod/Service 연결 (브라우저에서 테스트)
kubectl port-forward svc/nginx 8080:80
kubectl port-forward pod/nginx-xxxx 8080:80

# 파일 전송
kubectl cp ./local.txt <pod>:/tmp/local.txt
kubectl cp <pod>:/var/log/app.log ./app.log

# 임시 디버그 컨테이너 붙이기 (K8S 1.25+)
kubectl debug -it <pod> --image=busybox --target=<container>

# 네임스페이스 이벤트 모아보기
kubectl get events --sort-by='.lastTimestamp' -n <ns>

# 현재 컨텍스트 / 전체 컨텍스트
kubectl config current-context
kubectl config get-contexts

# 컨텍스트 전환
kubectl config use-context prod-cluster

# 현재 컨텍스트의 기본 네임스페이스 변경
kubectl config set-context --current --namespace=production

# 컨텍스트 전환
kubectx prod

# 네임스페이스 전환
kubens production

alias k=kubectl
alias kg='kubectl get'
alias kd='kubectl describe'
alias kl='kubectl logs'

# bash
source <(kubectl completion bash)
echo 'source <(kubectl completion bash)' >> ~/.bashrc
complete -F __start_kubectl k   # alias에도 자동완성

# zsh
source <(kubectl completion zsh)

# 모든 Pod 이름
kubectl get pods -o jsonpath='{.items[*].metadata.name}'

# Pod별 노드 확인
kubectl get pods -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.spec.nodeName}{"\n"}{end}'

# 이미지 목록
kubectl get pods -o jsonpath='{.items[*].spec.containers[*].image}'

# 클라이언트 측 검증 (빠름)
kubectl apply -f app.yaml --dry-run=client

# 서버 측 검증 (admission webhook까지 검증됨, 더 정확)
kubectl apply -f app.yaml --dry-run=server

# 1. 현재 상태 확인
kubectl get pods

# 2. 상세 이벤트 확인 (가장 중요)
kubectl describe pod <pod-name>

# 3. 로그 확인 (컨테이너가 한 번이라도 떴다면)
kubectl logs <pod-name>
kubectl logs --previous <pod-name>   # 직전에 죽은 기록

# 4. 네임스페이스 전체 이벤트 스캔
kubectl get events --sort-by='.lastTimestamp' -n <ns>

# 5. 노드 상태 확인
kubectl top nodes
kubectl describe node <node-name>