☸️
Kubernetes (K8s) 치트시트

kubectl 필수 명령어, Pod/Deployment/Service/Ingress 관리, 롤링 업데이트 & 롤백, ConfigMap & Secret, 트러블슈팅 디버깅 및 YAML dry-run 완벽 가이드
#kubernetes#k8s#kubectl#container#docker#devops#cloud#orchestration최종 업데이트: 2026-09-27
Kubernetes (K8s) 치트시트 핵심 명령어 및 실전 가이드

kubectl 필수 명령어, Pod/Deployment/Service/Ingress 관리, 롤링 업데이트 & 롤백, ConfigMap & Secret, 트러블슈팅 디버깅 및 YAML dry-run 완벽 가이드
## 1. 클러스터 정보 & Context / Namespace 제어
```bash
# ☸️ [1] 클러스터 상태 및 엔드포인트 확인
kubectl cluster-info
kubectl get componentstatus          # 컨트롤 플레인 상태 점검
kubectl get nodes -o wide            # 전체 노드 목록 (IP, OS, K8s 버전)

# 🔄 [2] Kubeconfig Context (다중 클러스터) 전환
kubectl config get-contexts          # 등록된 클러스터 컨텍스트 목록
kubectl config current-context       # 현재 활성 컨텍스트 확인
kubectl config use-context prod-cluster # 특정 클러스터로 전환

# 🏷️ [3] 네임스페이스(Namespace) 관리
kubectl get namespaces               # 네임스페이스 목록 조회
kubectl create namespace my-app      # 네임스페이스 생성
# 현재 컨텍스트의 기본 네임스페이스를 영구 변경
kubectl config set-context --current --namespace=my-app
```

## 2. Pod & 워크로드 조회 (Get & Describe)
```bash
# 📦 [1] 파드(Pod) 기본 조회
kubectl get pods                     # 현재 네임스페이스의 Pod 목록
kubectl get pods -A                  # 전체 네임스페이스 Pod 조회 (--all-namespaces)
kubectl get pods -o wide             # 노드 IP, Pod IP 포함 상세 출력
kubectl get pods -w                  # 실시간 변경 감지 (Watch 모드)
kubectl get pods -l app=frontend     # 라벨 셀렉터 필터링

# 🔍 [2] 리소스 상세 분석 & 이벤트 확인 (에러 분석의 핵심)
kubectl describe pod <pod-name>
kubectl describe node <node-name>
kubectl get events --sort-by=.metadata.creationTimestamp # 최근 클러스터 이벤트

# 📄 [3] JSON/YAML 포맷 출력 & 리소스 정의 조회
kubectl get deployment my-web -o yaml
kubectl explain pod.spec.containers  # API 스키마 필드 설명서 즉시 확인
```

## 3. Pod & Deployment 생성 및 스케일링
```bash
# 🚀 [1] 임시 테스트 Pod 즉시 실행
kubectl run test-curl --image=curlimages/curl --rm -it -- sh

# ⚙️ [2] Deployment 생성
kubectl create deployment web-api --image=nginx:alpine --replicas=3

# 📈 [3] 파드 인스턴스 수동 스케일링
kubectl scale deployment web-api --replicas=5

# 🤖 [4] HPA (오토스케일러) 설정 (CPU 사용률 70% 초과 시 자동 확장)
kubectl autoscale deployment web-api --min=2 --max=10 --cpu-percent=70
kubectl get hpa
```

## 4. 롤링 업데이트 & 무중단 배포 & 롤백 (Rollout)
```bash
# 🔄 [1] 이미지 버전 업데이트 (롤링 배포 시작)
kubectl set image deployment/web-api nginx=nginx:1.25.4-alpine

# 📊 [2] 롤아웃 진행 상태 모니터링
kubectl rollout status deployment/web-api

# 📜 [3] 배포 히스토리(리비전) 조회
kubectl rollout history deployment/web-api

# ⏪ [4] 이전 버전으로 즉시 롤백 (Rollback)
kubectl rollout undo deployment/web-api
# 특정 리비전 번호로 롤백
kubectl rollout undo deployment/web-api --to-revision=2

# 🔁 [5] 무중단 재시작 (환경설정 변경 적용 시 파드 순차 재기동)
kubectl rollout restart deployment/web-api
```

## 5. 네트워킹 & 서비스 (Service & Ingress)
```bash
# 🌐 [1] Service 생성 (Deployment 노출)
# ClusterIP (클러스터 내부 통신용, 기본값)
kubectl expose deployment web-api --port=80 --target-port=80 --type=ClusterIP

# NodePort (워커노드 외부 IP:포트로 노출 30000~32767)
kubectl expose deployment web-api --port=80 --target-port=80 --type=NodePort

# LoadBalancer (클라우드 AWS ELB/GCP LB 자동 연동)
kubectl expose deployment web-api --port=80 --target-port=80 --type=LoadBalancer

# 서비스 및 엔드포인트 목록 확인
kubectl get svc,endpoints
```

```yaml
# 🌍 [2] Ingress 라우팅 YAML 표준 예시 (Nginx Ingress)
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: web-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: api.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: web-api
            port:
              number: 80
```

## 6. ConfigMap & Secret (환경설정 & 민감정보 분리)
```bash
# 📝 [1] ConfigMap 생성 (일반 환경변수 / 설정파일)
kubectl create configmap app-config --from-literal=APP_ENV=production --from-literal=LOG_LEVEL=info
kubectl create configmap nginx-conf --from-file=default.conf

# 🔒 [2] Secret 생성 (비밀번호 / API Token Base64 암호화)
kubectl create secret generic db-secret \
  --from-literal=DB_PASSWORD='MySecretPass123!' \
  --from-file=tls.key=./server.key

# 조회 및 디코딩 확인
kubectl get configmaps,secrets
kubectl get secret db-secret -o jsonpath="{.data.DB_PASSWORD}" | base64 -d
```

## 7. 트러블슈팅, 로그 & 원격 쉘 디버깅
```bash
# 📋 [1] 실시간 로그 스트리밍 (Tail Logs)
kubectl logs -f <pod-name>
# 다중 컨테이너 Pod인 경우 특정 컨테이너 지정 (-c)
kubectl logs -f <pod-name> -c app-container
# 직전에 비정상 크래시(CrashLoopBackOff)된 이전 인스턴스 로그 확인
kubectl logs <pod-name> --previous

# 💻 [2] 실행 중인 Pod에 대화형 쉘 접속
kubectl exec -it <pod-name> -- /bin/sh
kubectl exec -it <pod-name> -- /bin/bash

# 🔌 [3] 로컬 포트 포워딩 (방화벽 통과 로컬 테스트)
# 로컬 8080 ➔ Pod 80 포트로 터널링
kubectl port-forward pod/<pod-name> 8080:80
# Service 포트 포워딩
kubectl port-forward svc/web-api 8080:80

# 📁 [4] 파일 복사 (Local ⇄ Pod)
kubectl cp ./app.jar <pod-name>:/usr/app/app.jar
kubectl cp <pod-name>:/var/log/app.log ./app.log

# 📈 [5] 리소스 실시간 사용량 측정 (Metrics Server 필요)
kubectl top nodes
kubectl top pods --sort-by=memory
```

## 8. 생산성 치트: YAML Dry-Run 템플릿 & 리소스 삭제
```bash
# 💡 [1] 손으로 작성하지 않고 YAML 뼈대 즉시 생성 (--dry-run=client -o yaml)
# Pod YAML 생성
kubectl run my-nginx --image=nginx:alpine --dry-run=client -o yaml > pod.yaml

# Deployment YAML 생성
kubectl create deployment my-deploy --image=nginx --replicas=3 --dry-run=client -o yaml > deploy.yaml

# Service YAML 생성
kubectl expose deployment my-deploy --port=80 --target-port=8080 --dry-run=client -o yaml > svc.yaml

# 🚀 [2] YAML 매니페스트 적용 (Declarative Apply)
kubectl apply -f deploy.yaml
kubectl apply -f ./k8s-manifests/     # 디렉토리 내 모든 yaml 일괄 적용
kubectl diff -f deploy.yaml          # 클러스터 실상태와 YAML 변경사항 비교

# 🧹 [3] 리소스 안전 삭제
kubectl delete -f deploy.yaml        # YAML 정의 파일 기반 삭제
kubectl delete pod <pod-name> --grace-period=0 --force # 강제 즉시 삭제
kubectl delete pods --field-selector=status.phase=Failed # 실패한 Pod 일괄 정리
```
💬
Kubernetes (K8s) 치트시트

의견 및 질문

댓글 수정

댓글 삭제
