kubectl 명령어 치트시트

모든 컨텍스트 목록, 클러스터 혼동은 흔한 사고

kubectl config get-contexts

현재 컨텍스트 전환, 변경 전 반드시 확인

kubectl config use-context prod-cn

현재 클러스터 확인, 스크립트 사전 검증에 유용

kubectl config current-context

기본 네임스페이스 고정, 매번 -n 생략

kubectl config set-context --current --namespace=staging

네임스페이스 목록

kubectl get ns

네임스페이스의 주요 리소스 한 번에 조회

kubectl get all -n app

IP와 노드 열 추가, 스케줄링과 네트워크 확인에 필수

kubectl get pods -o wide -n app

모든 네임스페이스의 Pod 조회

kubectl get pods -A --field-selector=status.phase!=Running

목록 변화를 계속 지켜봄, 롤아웃 관찰에 유용

kubectl get pods -w -n app

리소스의 전체 YAML 출력(런타임 상태 포함)

kubectl get pod web-0 -o yaml > pod-backup.yaml

클러스터 생성 필드 제거, 재적용에 편리

kubectl get deploy web -o yaml -n app

터미널에서 필드 의미와 허용 값 확인

kubectl explain deploy.spec.strategy --recursive

클러스터가 지원하는 모든 리소스 종류와 약어

kubectl api-resources --namespaced=true

선언형 적용, 반복 실행해도 안전

kubectl apply -f k8s/ -n app

매니페스트에 정의된 리소스 삭제

kubectl delete -f k8s/ -n app

네임스페이스 생성

kubectl create ns staging

Pod 상세 정보, 마지막 Events 섹션이 핵심

kubectl describe pod web-0 -n app

컨테이너 로그 조회

kubectl logs web-0 -n app --tail=200

특정 컨테이너 로그 추적, 다중 컨테이너 Pod는 -c 필요

kubectl logs -f web-0 -c app -n app

직전 크래시 로그 확인, CrashLoopBackOff에 필수

kubectl logs web-0 --previous -n app

최근 10분 로그만 조회

kubectl logs web-0 --since=10m --timestamps -n app

컨테이너 접속, 경량 이미지에는 대개 bash 없음

kubectl exec -it web-0 -n app -- /bin/sh

컨테이너에 실제 적용된 환경변수 확인

kubectl exec web-0 -n app -- printenv

로컬과 Pod 간 파일 복사

kubectl cp ./dump.sql app/web-0:/tmp/dump.sql

Pod 포트를 로컬로 포워딩, 노출되지 않은 서비스 디버깅

kubectl port-forward pod/web-0 8080:80 -n app

일회용 디버그 파드, 종료 시 정리

kubectl run tmp --rm -it --image=busybox:1.36 --restart=Never -- sh

Pod IP 추출, 스크립트에 활용

kubectl get pod web-0 -o jsonpath="{.status.podIP}" -n app

Pod 삭제, 컨트롤러 관리 대상은 자동 재생성

kubectl delete pod web-0 -n app

Terminating에 멈춘 Pod 강제 삭제

kubectl delete pod web-0 --grace-period=0 --force -n app

재시작 횟수 확인, 반복 크래시 판단

kubectl get pod web-0 -o jsonpath="{.status.containerStatuses[*].restartCount}" -n app

Deployment 목록과 레플리카 준비 상태

kubectl get deploy -n app -o wide

레플리카 수 조정, 가장 직접적인 확장 방법

kubectl scale deploy/web --replicas=3 -n app

이미지 버전 롤링 업데이트

kubectl set image deploy/web web=registry.example.com/app:1.1 -n app

운영 중 설정 직접 편집, 저장 즉시 반영

kubectl edit deploy/web -n app

한 줄 JSON으로 필드 수정, 스크립트에 적합

kubectl patch deploy/web --type=merge -p "{\"spec\":{\"replicas\":2}}" -n app

수평 자동 확장 설정

kubectl autoscale deploy/web --min=2 --max=10 --cpu-percent=70 -n app

ReplicaSet 목록, 이전 버전 확인

kubectl get rs -n app

운영 중 실제 이미지 확인

kubectl get deploy web -o jsonpath="{.spec.template.spec.containers[*].image}" -n app

주석 추가, 릴리스 정보 기록

kubectl annotate deploy/web note="release-1.1" --overwrite -n app

레이블 추가, Service 셀렉터와 조회에 사용

kubectl label deploy/web tier=web --overwrite -n app

롤아웃 진행 상황 확인, 배포 후 필수

kubectl rollout status deploy/web -n app --timeout=120s

이전 버전과 변경 사유 확인

kubectl rollout history deploy/web -n app

이전 버전으로 롤백, 장애 시 가장 빠른 복구

kubectl rollout undo deploy/web -n app

특정 버전으로 롤백, history 확인 후 결정

kubectl rollout undo deploy/web --to-revision=2 -n app

모든 Pod 재시작, 설정 변경 후 자주 사용

kubectl rollout restart deploy/web -n app

롤아웃 일시 중지, 확인 후 재개 가능

kubectl rollout pause deploy/web -n app

중지된 롤아웃 재개

kubectl rollout resume deploy/web -n app

Service 목록과 ClusterIP, 포트

kubectl get svc -n app -o wide

Service 뒤의 실제 Pod IP 확인, 비어 있으면 셀렉터 불일치

kubectl get endpoints web -n app

Service 상세, 셀렉터와 포트 매핑 포함

kubectl describe svc web -n app

Deployment를 Service로 노출

kubectl expose deploy/web --port=80 --target-port=8080 --type=ClusterIP -n app

Service 포트 포워딩, Ingress 없이 로컬 검증

kubectl port-forward svc/web 8080:80 -n app

Ingress 목록과 노출 도메인

kubectl get ingress -n app

Ingress 규칙과 백엔드 해석 결과

kubectl describe ingress web -n app

네트워크 정책 목록, Pod 간 통신 문제 시 확인

kubectl get netpol -n app

ClusterIP 추출, 설정이나 스크립트에 사용

kubectl get svc web -o jsonpath="{.spec.clusterIP}" -n app

ConfigMap 목록

kubectl get cm -n app

파일로 ConfigMap 생성

kubectl create cm app-config --from-file=config/app.yaml -n app

ConfigMap 내용 확인

kubectl describe cm app-config -n app

Secret 목록, 값은 암호화가 아닌 base64

kubectl get secret -n app

리터럴로 Secret 생성

kubectl create secret generic db --from-literal=password=changeit -n app

Secret 평문 디코딩, 설정 미반영 디버깅

kubectl get secret db -o jsonpath="{.data.password}" -n app | base64 -d

ServiceAccount 목록, Pod의 API 접근 신원

kubectl get sa -n app

특정 신원의 권한 확인, RBAC 디버깅

kubectl auth can-i get pods --as=system:serviceaccount:app:web -n app

노드와 상태 목록

kubectl get nodes -o wide

노드 상세, 할당된 리소스와 테인트 포함

kubectl describe node node-1

노드 실제 리소스 사용량, metrics-server 필요

kubectl top nodes

Pod 리소스 사용량, 메모리 과다 사용 확인

kubectl top pods -n app --sort-by=memory

노드 스케줄 불가 표시, 기존 Pod는 유지

kubectl cordon node-1

노드의 Pod 축출, 유지보수 전 필수

kubectl drain node-1 --ignore-daemonsets --delete-emptydir-data

노드 스케줄 가능 상태로 복구

kubectl uncordon node-1

노드 테인트 추가, 톨러레이션이 있는 Pod만 스케줄

kubectl taint nodes node-1 dedicated=gpu:NoSchedule

시간 역순 이벤트 조회, 클러스터 수준 문제 확인

kubectl get events --sort-by=.lastTimestamp -n app | tail -30

이벤트 스트림 실시간 관찰, 재현 시 유용

kubectl get events -w -n app

실패 상태 Pod 필터링

kubectl get pod --field-selector=status.phase=Failed -A

준비되지 않은 이유 조회, describe보다 빠름

kubectl get pod web-0 -o jsonpath="{.status.conditions[?(@.type==\"Ready\")].reason}" -n app

기존 Pod에 임시 컨테이너 주입, 프로세스 네임스페이스 공유

kubectl debug -it web-0 --image=busybox:1.36 --target=app -n app

노드에서 디버그 Pod 실행, 호스트 파일시스템 접근

kubectl debug node/node-1 -it --image=busybox:1.36

Pod 내 모든 컨테이너 로그 조회

kubectl logs web-0 --all-containers --prefix -n app

Pod 준비 대기, 스크립트 동기화 지점

kubectl wait --for=condition=Ready pod/web-0 --timeout=60s -n app

jq로 상태 필드 정밀 조회, jsonpath보다 작성 편함

kubectl get pod web-0 -o json -n app | jq .status

필드를 누가 변경했는지 확인

kubectl get pod web-0 -o yaml --show-managed-fields -n app

컨트롤 플레인 주소와 애드온 위치

kubectl cluster-info

클라이언트와 서버 버전 확인, 버전 차이 주의

kubectl version --short

서버 측 드라이런, 실제 검증만 하고 반영 안 함

kubectl apply --dry-run=server -f deploy.yaml -n app

apply가 바꿀 필드 미리 확인

kubectl diff -f deploy.yaml -n app

볼륨과 클레임 조회, Pending은 대개 스토리지 클래스 문제

kubectl get pv,pvc -n app

자동 확장 상태와 현재 지표 확인

kubectl get hpa -n app

클러스터에 설치된 CRD 목록

kubectl get crd | head -30

조회 가능한 네임스페이스 리소스 목록, 백업 스크립트에 유용

kubectl api-resources --verbs=list --namespaced -o name