[2026] Kubernetes 실전 가이드 | Pod·Deployment·Service·Ingress·ConfigMap·Helm

· 22분 읽기 · 수정 고급
[2026] Kubernetes 실전 가이드 | Pod·Deployment·Service·Ingress·ConfigMap·Helm

이 글의 핵심

Kubernetes로 컨테이너를 오케스트레이션하는 실전 가이드입니다. Pod, Deployment, Service, Ingress, ConfigMap, Secret, Helm까지 실무 예제로 정리했습니다.

실무 경험 공유: 마이크로서비스 아키텍처를 Kubernetes로 구축하면서, 배포 시간을 1시간에서 5분으로 단축하고 무중단 배포를 구현한 경험을 공유합니다.

들어가며: “Docker만으로는 부족해요”

실무 문제 시나리오

시나리오 1: 컨테이너가 죽으면 수동 재시작해야 해요
Docker만으로는 자동 복구가 안 됩니다. Kubernetes는 자동으로 재시작합니다. 시나리오 2: 로드 밸런싱이 필요해요
여러 컨테이너에 트래픽을 분산해야 합니다. Kubernetes Service가 자동으로 처리합니다. 시나리오 3: 무중단 배포가 어려워요
배포 중 다운타임이 발생합니다. Kubernetes Rolling Update로 해결합니다.

1. Kubernetes란?

핵심 특징

Kubernetes (K8s)는 컨테이너 오케스트레이션 플랫폼입니다. 주요 기능:

  • 자동 복구: 컨테이너 장애 시 재시작
  • 로드 밸런싱: 트래픽 자동 분산
  • 스케일링: 자동 확장/축소
  • 무중단 배포: Rolling Update
  • 서비스 디스커버리: 자동 DNS

2. 설치

Minikube (로컬)

아래 코드는 bash를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# Windows (Chocolatey)
choco install minikube
# macOS
brew install minikube
# 시작
minikube start
# kubectl 설치
minikube kubectl -- get pods

kubectl 명령어

아래 코드는 bash를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# 클러스터 정보
kubectl cluster-info
# 노드 확인
kubectl get nodes
# 모든 리소스 확인
kubectl get all

3. Pod

기본 Pod

아래 코드는 yaml를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# pod.yaml
apiVersion: v1
kind: Pod
metadata:
  name: nginx-pod
  labels:
    app: nginx
spec:
  containers:
  - name: nginx
    image: nginx:latest
    ports:
    - containerPort: 80

아래 코드는 bash를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# 생성
kubectl apply -f pod.yaml
# 확인
kubectl get pods
# 로그 확인
kubectl logs nginx-pod
# 삭제
kubectl delete pod nginx-pod

4. Deployment

기본 Deployment

다음은 yaml를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.25
        ports:
        - containerPort: 80
        resources:
          requests:
            memory: "64Mi"
            cpu: "250m"
          limits:
            memory: "128Mi"
            cpu: "500m"

다음은 bash를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# 생성
kubectl apply -f deployment.yaml
# 확인
kubectl get deployments
kubectl get pods
# 스케일링
kubectl scale deployment nginx-deployment --replicas=5
# 롤링 업데이트
kubectl set image deployment/nginx-deployment nginx=nginx:1.26
# 롤백
kubectl rollout undo deployment/nginx-deployment

5. Service

ClusterIP (내부 통신)

아래 코드는 yaml를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# service-clusterip.yaml
apiVersion: v1
kind: Service
metadata:
  name: nginx-service
spec:
  type: ClusterIP
  selector:
    app: nginx
  ports:
  - port: 80
    targetPort: 80

LoadBalancer (외부 노출)

아래 코드는 yaml를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# service-lb.yaml
apiVersion: v1
kind: Service
metadata:
  name: nginx-lb
spec:
  type: LoadBalancer
  selector:
    app: nginx
  ports:
  - port: 80
    targetPort: 80

NodePort

아래 코드는 yaml를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# service-nodeport.yaml
apiVersion: v1
kind: Service
metadata:
  name: nginx-nodeport
spec:
  type: NodePort
  selector:
    app: nginx
  ports:
  - port: 80
    targetPort: 80
    nodePort: 30080

6. Ingress

Ingress 설치

# NGINX Ingress Controller
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/cloud/deploy.yaml

Ingress 설정

다음은 yaml를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: app-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
  - host: myapp.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: frontend-service
            port:
              number: 80
      - path: /api
        pathType: Prefix
        backend:
          service:
            name: backend-service
            port:
              number: 8000
  tls:
  - hosts:
    - myapp.example.com
    secretName: tls-secret

7. ConfigMap & Secret

ConfigMap

아래 코드는 yaml를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  DATABASE_HOST: postgres-service
  DATABASE_PORT: "5432"
  LOG_LEVEL: info

아래 코드는 yaml를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# Deployment에서 사용
spec:
  containers:
  - name: app
    image: myapp:latest
    envFrom:
    - configMapRef:
        name: app-config

Secret

다음은 간단한 bash 코드 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# Secret 생성
kubectl create secret generic db-secret \
  --from-literal=username=admin \
  --from-literal=password=secret123

다음은 yaml를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# Deployment에서 사용
# 실행 예제
spec:
  containers:
  - name: app
    image: myapp:latest
    env:
    - name: DB_USERNAME
      valueFrom:
        secretKeyRef:
          name: db-secret
          key: username
    - name: DB_PASSWORD
      valueFrom:
        secretKeyRef:
          name: db-secret
          key: password

8. Helm

설치

아래 코드는 bash를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# Windows
choco install kubernetes-helm
# macOS
brew install helm

Chart 사용

아래 코드는 bash를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# Chart 검색
helm search hub wordpress
# Chart 설치
helm install my-wordpress bitnami/wordpress
# 업그레이드
helm upgrade my-wordpress bitnami/wordpress
# 삭제
helm uninstall my-wordpress

커스텀 Chart

아래 코드는 bash를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# Chart 생성
helm create myapp
# 구조
myapp/
├── Chart.yaml
├── values.yaml
└── templates/
    ├── deployment.yaml
    ├── service.yaml
    └── ingress.yaml

아래 코드는 yaml를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# values.yaml
replicaCount: 3
image:
  repository: myapp
  tag: "1.0.0"
  pullPolicy: IfNotPresent
service:
  type: ClusterIP
  port: 80

9. 실전 예제: 풀스택 앱 배포

다음은 yaml를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# postgres.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: postgres
spec:
  replicas: 1
  selector:
    matchLabels:
      app: postgres
  template:
    metadata:
      labels:
        app: postgres
    spec:
      containers:
      - name: postgres
        image: postgres:16
        env:
        - name: POSTGRES_PASSWORD
          valueFrom:
            secretKeyRef:
              name: db-secret
              key: password
        ports:
        - containerPort: 5432
        volumeMounts:
        - name: postgres-storage
          mountPath: /var/lib/postgresql/data
      volumes:
      - name: postgres-storage
        persistentVolumeClaim:
---
          claimName: postgres-pvc
apiVersion: v1
kind: Service
metadata:
  name: postgres-service
spec:
  selector:
    app: postgres
  ports:
  - port: 5432

다음은 yaml를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# backend.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: backend
spec:
  replicas: 3
  selector:
    matchLabels:
      app: backend
  template:
    metadata:
      labels:
        app: backend
    spec:
      containers:
      - name: backend
        image: myapp/backend:1.0.0
        envFrom:
        - configMapRef:
            name: app-config
        - secretRef:
            name: db-secret
        ports:
---
        - containerPort: 8000
apiVersion: v1
kind: Service
metadata:
  name: backend-service
spec:
  selector:
    app: backend
  ports:
  - port: 8000

정리 및 체크리스트

핵심 요약

  • Kubernetes: 컨테이너 오케스트레이션
  • Pod: 최소 배포 단위
  • Deployment: 선언적 배포 관리
  • Service: 로드 밸런싱
  • Ingress: 외부 트래픽 라우팅
  • Helm: 패키지 관리자

프로덕션 체크리스트

  • 클러스터 구성
  • Deployment 작성
  • Service 설정
  • Ingress 구성
  • ConfigMap/Secret 관리
  • 모니터링 설정
  • 백업 전략 수립

같이 보면 좋은 글

  • GitHub Actions CI/CD 가이드
  • Docker Compose 완벽 가이드
  • Redis 고급 가이드

이 글에서 다루는 키워드

Kubernetes, K8s, Container, Orchestration, DevOps, Docker, Cloud

자주 묻는 질문 (FAQ)

Q. Docker Compose vs Kubernetes, 어떤 게 나은가요?

A. Docker Compose는 단일 서버용입니다. Kubernetes는 다중 서버 클러스터용입니다. 소규모는 Docker Compose, 대규모는 Kubernetes를 권장합니다.

Q. 학습 곡선이 가파른가요?

A. 네, Kubernetes는 복잡합니다. 하지만 기본 개념(Pod, Deployment, Service)만 이해하면 시작할 수 있습니다.

Q. 클라우드에서 사용해야 하나요?

A. 아니요, 온프레미스에서도 사용 가능합니다. 하지만 GKE, EKS, AKS 같은 관리형 서비스를 권장합니다.

Q. Helm은 필수인가요?

A. 아니요, 선택사항입니다. 하지만 복잡한 앱 배포를 크게 간소화합니다.

... 996 lines not shown ... Token usage: 63706/1000000; 936294 remaining Start-Sleep -Seconds 3