Kubernetes 클러스터 구조와 핵심 오브젝트 이해하기

┌─────────────────────────────────────────────┐
│                 Control Plane                │
│  API Server / Scheduler / Controller / etcd  │
└──────────────────────┬──────────────────────┘
                       │ 명령 전달
       ┌───────────────┼───────────────┐
       ▼               ▼               ▼
┌────────────┐  ┌────────────┐  ┌────────────┐
│   Node 1   │  │   Node 2   │  │   Node 3   │
│  (워커 노드) │  │  (워커 노드) │  │  (워커 노드) │
│  Pod Pod   │  │  Pod Pod   │  │  Pod Pod   │
└────────────┘  └────────────┘  └────────────┘

# 클러스터 정보 확인
kubectl cluster-info

# 노드 목록과 상태
kubectl get nodes

# 노드 상세 정보 (CPU/메모리 할당 현황 등)
kubectl describe node <노드이름>

apiVersion: v1
kind: Pod
metadata:
  name: my-app
  labels:
    app: web
spec:
  containers:
    - name: web
      image: nginx:1.25
      ports:
        - containerPort: 80

# Pod 목록
kubectl get pods

# Pod 상세 정보 (이벤트, 상태, IP 등)
kubectl describe pod <pod이름>

# Pod 로그 보기
kubectl logs <pod이름>

# Pod 안에 들어가기 (디버깅)
kubectl exec -it <pod이름> -- /bin/sh

# Pod 삭제
kubectl delete pod <pod이름>

Pending → Running → Succeeded / Failed
                    (노드와 통신 불가 시 Unknown)

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-app
spec:
  replicas: 3              # Pod 3개 유지
  selector:
    matchLabels:
      app: web
  template:                # Pod 템플릿
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: web
          image: myapp:1.0
          ports:
            - containerPort: 8080
          resources:
            requests:
              memory: "128Mi"
              cpu: "100m"
            limits:
              memory: "256Mi"
              cpu: "500m"

# Deployment 생성 (YAML 적용)
kubectl apply -f deployment.yaml

# Deployment 목록
kubectl get deployments

# Pod 수 변경 (스케일링)
kubectl scale deployment web-app --replicas=5

# 이미지 업데이트 (롤링 업데이트 자동 실행)
kubectl set image deployment/web-app web=myapp:2.0

# 업데이트 상태 확인
kubectl rollout status deployment/web-app

# 문제 시 롤백
kubectl rollout undo deployment/web-app

# 배포 히스토리
kubectl rollout history deployment/web-app

Deployment (버전 관리 + 롤링 업데이트)
  └── ReplicaSet (Pod 개수 유지)
         └── Pod (실제 실행 단위)

apiVersion: v1
kind: Service
metadata:
  name: web-service
spec:
  selector:
    app: web          # label이 app=web인 Pod들에 연결
  ports:
    - port: 80        # Service 포트
      targetPort: 8080  # Pod의 컨테이너 포트
  type: ClusterIP

# Service 목록
kubectl get services

# Service 상세 (연결된 Pod IP 목록 = Endpoints)
kubectl describe service web-service

# 외부 노출 (빠른 테스트)
kubectl expose deployment web-app --type=NodePort --port=80

# 네임스페이스 목록
kubectl get namespaces

# 특정 네임스페이스의 Pod 보기
kubectl get pods -n kube-system

# 네임스페이스 생성
kubectl create namespace dev

# 기본 네임스페이스 변경 (매번 -n 안 붙이려면)
kubectl config set-context --current --namespace=dev

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  DATABASE_HOST: "db.example.com"
  LOG_LEVEL: "info"

apiVersion: v1
kind: Secret
metadata:
  name: app-secret
type: Opaque
data:
  DB_PASSWORD: cGFzc3dvcmQxMjM=    # base64 인코딩 (echo -n 'password123' | base64)

spec:
  containers:
    - name: app
      image: myapp:1.0
      envFrom:
        - configMapRef:
            name: app-config
        - secretRef:
            name: app-secret

# ConfigMap 생성 (명령어)
kubectl create configmap app-config --from-literal=LOG_LEVEL=info

# Secret 생성
kubectl create secret generic app-secret --from-literal=DB_PASSWORD=password123

# ConfigMap/Secret 확인
kubectl get configmaps
kubectl get secrets

# Secret 내용 보기 (base64 디코딩 필요)
kubectl get secret app-secret -o jsonpath='{.data.DB_PASSWORD}' | base64 -d

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: data-storage
spec:
  accessModes:
    - ReadWriteOnce       # 단일 노드에서 읽기/쓰기로 마운트
  resources:
    requests:
      storage: 10Gi       # 10GiB 요청 (Gi는 2의 거듭제곱 단위)

spec:
  containers:
    - name: app
      image: myapp:1.0
      volumeMounts:
        - mountPath: /data
          name: storage
  volumes:
    - name: storage
      persistentVolumeClaim:
        claimName: data-storage

# PV, PVC 확인
kubectl get pv
kubectl get pvc

# PVC 상태 확인 (Bound = 정상 연결됨)
kubectl describe pvc data-storage

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: log-collector
spec:
  selector:
    matchLabels:
      app: log-collector
  template:
    metadata:
      labels:
        app: log-collector
    spec:
      containers:
        - name: fluentd
          image: fluentd:latest

apiVersion: batch/v1
kind: CronJob
metadata:
  name: daily-backup
spec:
  schedule: "0 2 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: backup
              image: backup-tool:1.0
          restartPolicy: OnFailure

# 각 워크로드 확인
kubectl get statefulsets
kubectl get daemonsets
kubectl get jobs
kubectl get cronjobs

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-ingress
spec:
  rules:
    - host: api.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: api-service
                port:
                  number: 80
    - host: web.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web-service
                port:
                  number: 80

# Ingress 목록
kubectl get ingress

# 상세 확인
kubectl describe ingress my-ingress

# 리소스 목록 (pods, services, deployments 등)
kubectl get <리소스>

# 모든 네임스페이스에서 조회
kubectl get pods --all-namespaces
kubectl get pods -A    # 위와 같음 (축약)

# 상세 정보
kubectl describe <리소스> <이름>

# YAML로 현재 상태 보기
kubectl get deployment web-app -o yaml

# YAML 파일로 생성 또는 업데이트
kubectl apply -f <파일.yaml>

# 폴더 안의 YAML 전부 적용
kubectl apply -f ./k8s/

# 빠른 생성 (간단한 테스트용)
kubectl run test-pod --image=nginx
kubectl create deployment test --image=nginx --replicas=2

# 리소스 삭제
kubectl delete <리소스> <이름>

# YAML로 만든 것 삭제
kubectl delete -f <파일.yaml>

# 네임스페이스 통째로 삭제 (안의 모든 리소스 포함)
kubectl delete namespace dev

# 로그 보기
kubectl logs <pod이름>

# 실시간 로그 (tail -f처럼)
kubectl logs -f <pod이름>

# 이전 크래시 로그 (CrashLoopBackOff일 때)
kubectl logs <pod이름> --previous

# Pod 안에 접속
kubectl exec -it <pod이름> -- /bin/sh

# Pod 상태/이벤트 확인 (왜 안 뜨는지 원인 파악)
kubectl describe pod <pod이름>

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

# 롤링 업데이트
kubectl set image deployment/<이름> <컨테이너>=<새이미지>

# 롤백
kubectl rollout undo deployment/<이름>

# 스케일링
kubectl scale deployment/<이름> --replicas=<수>

# 재시작 (이미지 그대로, Pod만 재생성)
kubectl rollout restart deployment/<이름>

# 자동완성 설정 (매번 긴 이름 안 쳐도 됨)
source <(kubectl completion zsh)

# 축약어 사용
kubectl get po        # pods
kubectl get svc       # services
kubectl get deploy    # deployments
kubectl get ns        # namespaces
kubectl get no        # nodes

# 라벨로 필터링
kubectl get pods -l app=web

# 여러 리소스 한번에 보기
kubectl get pods,services,deployments