[Kubernetes] 쿠버네티스 Deployment 및 Service 파일 가이드

1. 개요

Kubernetes에서 애플리케이션을 배포하고 운영하려면 Deployment와 Service 파일이 필수예요. 그래서 이번에는 deployment.yaml과 service.yaml을 상세히 설명하고, 각 아규먼트가 어떤 역할을 하는지 정리해볼게요.

 

2. Deployment 파일 (deployment.yaml)

Deployment는 Kubernetes에서 애플리케이션을 배포하고 관리하는 가장 중요한 리소스 중 하나예요.

기본 예제 (deployment.yaml)

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app-deployment
  labels:
    app: my-app
spec:
  replicas: 3  # 실행할 Pod 개수
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-app-container
        image: nginx:latest  # 사용할 컨테이너 이미지
        ports:
        - containerPort: 80  # 컨테이너 내부에서 노출할 포트

주요 아규먼트 설명

필드	설명
apiVersion	사용할 Kubernetes API 버전 (apps/v1)
kind	생성할 리소스 타입 (Deployment)
metadata	이름, 라벨 등 메타데이터 설정
spec.replicas	생성할 Pod 개수 (3개)
spec.selector.matchLabels	어떤 라벨을 가진 Pod를 관리할 것인지 설정
spec.template	Pod의 템플릿 정의 (실제 실행될 컨테이너 설정)
spec.template.spec.containers	배포할 컨테이너 정의
image	사용할 컨테이너 이미지 (여기서는 nginx:latest)
ports.containerPort	컨테이너 내부에서 열어둘 포트 (80번)

 

추가적으로 사용할 수 있는 옵션

1️⃣ Rolling Update 설정

배포 중 무중단 업데이트를 위해 다음과 같이 strategy를 추가할 수 있어요.

  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: 1  # 한 번에 몇 개의 Pod가 중단될 수 있는지
      maxSurge: 1  # 추가로 몇 개의 Pod를 만들 수 있는지

2️⃣ 환경 변수 추가

        env:
        - name: ENV_VAR_NAME
          value: "my-value"

3️⃣ 자원 제한 및 요청 설정

        resources:
          requests:
            cpu: "500m"  # 최소 0.5 CPU 필요
            memory: "256Mi"  # 최소 256MB 메모리 필요
          limits:
            cpu: "1"  # 최대 1 CPU 사용 가능
            memory: "512Mi"  # 최대 512MB 메모리 사용 가능

 

 

3. Service 파일 (service.yaml)

Service는 Kubernetes 클러스터 내부에서 Pod에 대한 네트워크 접근을 관리해요.

기본 예제 (service.yaml)

apiVersion: v1
kind: Service
metadata:
  name: my-app-service
spec:
  selector:
    app: my-app  # 연결할 Pod의 라벨 지정
  ports:
  - protocol: TCP
    port: 80  # 서비스가 클러스터 내에서 노출하는 포트
    targetPort: 80  # 실제 컨테이너 내부의 포트
  type: ClusterIP  # 기본값 (클러스터 내부에서만 접근 가능)

주요 아규먼트 설명

필드	설명
apiVersion	사용할 Kubernetes API 버전 (v1)
kind	생성할 리소스 타입 (Service)
metadata	이름, 라벨 등 메타데이터 설정
spec.selector	연결할 Pod를 식별하는 라벨 (app: my-app)
spec.ports	서비스에서 사용할 포트 설정
port	서비스가 외부에 노출하는 포트 (80)
targetPort	실제 컨테이너가 내부적으로 사용하는 포트 (80)
type	서비스 타입 (기본값: ClusterIP)

Service 타입 종류

타입	설명
ClusterIP	기본값, 클러스터 내부에서만 접근 가능 (외부 접근 불가)
NodePort	노드의 특정 포트를 열어 외부에서도 접근 가능 (30000-32767 범위)
LoadBalancer	클라우드 환경에서 외부 로드 밸런서를 통해 접근 가능
ExternalName	DNS 주소를 반환하여 외부 서비스와 연결

NodePort 사용 예제

  type: NodePort
  ports:
  - port: 80
    targetPort: 80
    nodePort: 30080  # 클러스터 외부에서 접근 가능 (30000-32767 범위 내에서 설정 가능)

 

 

 

4. Deployment와 Service 적용 방법

1️⃣ Deployment 및 Service 생성

kubectl apply -f deployment.yaml
kubectl apply -f service.yaml

2️⃣ 배포 상태 확인

kubectl get pods
kubectl get services

3️⃣ Service를 통해 접근하기

• ClusterIP 타입: 클러스터 내부에서 curl http://my-app-service:80 사용
• NodePort 타입: http://<노드 IP>:30080 로 접속 가능
• LoadBalancer 타입: 클라우드 환경에서 퍼블릭 IP 할당 후 접속

---

 

• Deployment는 애플리케이션을 배포하고 관리하는 리소스로, replicas, image, rollingUpdate 등의 설정이 중요해요.
• Service는 Pod에 대한 네트워크 접근을 제공하며, ClusterIP, NodePort, LoadBalancer 등의 타입을 선택할 수 있어요.
• 실무에서는 Deployment와 Service를 함께 사용하여 AI 모델 서빙, 웹 애플리케이션 배포 등의 작업을 수행해요.

이 글을 통해 deployment.yaml과 service.yaml의 구조와 아규먼트를 이해하고, Kubernetes 환경에서 애플리케이션을 직접 배포하는 데 도움이 되길 바랍니다.