📌 NestJS + Kubernetes & 마이크로서비스 배포: 실전 가이드 - NestJS 마이크로서비스를 Kubernetes에 배포하기

📌 NestJS + Kubernetes & 마이크로서비스 배포: 실전 가이드

3. NestJS 마이크로서비스를 Kubernetes에 배포하기

---

이제 Docker로 컨테이너화한 NestJS 마이크로서비스를 Kubernetes 클러스터에 배포해보겠습니다.
이 글에서는 로컬 Kubernetes 환경(Minikube 또는 Kind)을 설정하고, Deployment, Service, Ingress 리소스를 구성하여 마이크로서비스를 실행하는 전체 과정을 설명합니다. 🚀

---

✅ 1. Kubernetes 클러스터 준비 (Minikube 기준)

📦 Minikube 설치

# Mac (Homebrew)
brew install minikube

# 시작
minikube start

📦 Docker 이미지 Minikube로 전송

# Minikube Docker 환경 설정
eval $(minikube docker-env)

# Docker 이미지 빌드 (Minikube 내에서 사용)
docker build -t api-gateway -f docker/Dockerfile.api-gateway .
docker build -t user-service -f docker/Dockerfile.user-service .

---

✅ 2. Kubernetes 매니페스트 작성 (Deployment + Service)

📂 k8s/api-gateway-deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: api-gateway
spec:
  replicas: 1
  selector:
    matchLabels:
      app: api-gateway
  template:
    metadata:
      labels:
        app: api-gateway
    spec:
      containers:
        - name: api-gateway
          image: api-gateway
          ports:
            - containerPort: 3000
---
apiVersion: v1
kind: Service
metadata:
  name: api-gateway
spec:
  selector:
    app: api-gateway
  ports:
    - protocol: TCP
      port: 3000
      targetPort: 3000
  type: ClusterIP

📂 k8s/user-service-deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: user-service
spec:
  replicas: 1
  selector:
    matchLabels:
      app: user-service
  template:
    metadata:
      labels:
        app: user-service
    spec:
      containers:
        - name: user-service
          image: user-service
          ports:
            - containerPort: 3001
---
apiVersion: v1
kind: Service
metadata:
  name: user-service
spec:
  selector:
    app: user-service
  ports:
    - protocol: TCP
      port: 3001
      targetPort: 3001
  type: ClusterIP

---

✅ 3. Kubernetes 리소스 적용

반응형

kubectl apply -f k8s/user-service-deployment.yaml
kubectl apply -f k8s/api-gateway-deployment.yaml

상태 확인:

kubectl get pods
kubectl get services

---

✅ 4. API Gateway 외부 노출 (NodePort or Ingress)

📂 k8s/api-gateway-service.yaml (NodePort 방식)

apiVersion: v1
kind: Service
metadata:
  name: api-gateway-external
spec:
  selector:
    app: api-gateway
  ports:
    - protocol: TCP
      port: 3000
      targetPort: 3000
      nodePort: 30080
  type: NodePort

kubectl apply -f k8s/api-gateway-service.yaml
minikube service api-gateway-external

✅ 브라우저에서 http://<Minikube_IP>:30080/users 접속 시 응답 확인 가능

---

✅ 5. 서비스 간 통신 구성

NestJS 내부 설정에서 user-service라는 Kubernetes DNS 이름을 사용할 수 있습니다.
📂 apps/api-gateway/main.ts 또는 설정파일:

{
  transport: Transport.TCP,
  options: {
    host: 'user-service', // K8s 서비스 이름
    port: 3001,
  }
}

✅ user-service라는 이름으로 Kubernetes 클러스터 내 DNS가 자동 구성되어 통신 가능

---

✅ 6. 실행 결과 확인

curl http://localhost:30080/users

응답:

[
  { "id": 1, "name": "Alice" },
  { "id": 2, "name": "Bob" }
]

🎉 성공적으로 Kubernetes 환경에서 NestJS 마이크로서비스가 작동합니다!

---

✅ 결론: NestJS 마이크로서비스 Kubernetes 배포 완료

✅ 로컬 Kubernetes 클러스터(Minikube)에서 NestJS 서비스 실행
✅ Deployment, Service, NodePort 등 기본 리소스 적용
✅ 서비스 간 통신은 Kubernetes DNS를 통해 자동 연결
✅ 다음 단계에서는 Ingress, 도메인 연결, Helm을 통한 배포 자동화를 다룰 예정입니다

---

🔍 다음 글 예고: NestJS Kubernetes Ingress + Helm 배포 자동화

📌 다음 편: 4. Ingress & Helm으로 NestJS 클러스터 배포 최적화하기

---

 

NestJS Kubernetes 배포,NestJS K8s,NestJS 클러스터 배포,NestJS Minikube,NestJS Docker Kubernetes,NestJS 마이크로서비스 K8s,NestJS 서비스 배포,NestJS NodePort,NestJS TCP 통신,Kubernetes NestJS 서비스