📌 NestJS + Kubernetes & 마이크로서비스 배포: 실전 가이드NestJS CI/CD 자동화로 운영 효율 극대화 (ArgoCD + GitHub Actions)

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

24. NestJS CI/CD 자동화로 운영 효율 극대화 (ArgoCD + GitHub Actions)

---

NestJS 애플리케이션을 안정적으로 운영하려면 **지속적 통합 및 배포(CI/CD)**를 통해 코드 변경 사항을 빠르고 안전하게 반영할 수 있어야 합니다.
이번 글에서는 GitHub Actions를 이용한 빌드 자동화와 ArgoCD를 활용한 Kubernetes 클러스터 배포 자동화를 중심으로 NestJS CI/CD 파이프라인 구축 전략을 소개합니다. 🚀

---

✅ 1. CI/CD 파이프라인 구조

[개발자가 코드 푸시] 
       ↓
[GitHub Actions]
 - 빌드 & 테스트
 - Docker 이미지 빌드 & 푸시
       ↓
[ArgoCD]
 - GitOps 방식으로 변경 감지
 - Kubernetes 클러스터에 자동 배포

---

✅ 2. GitHub Actions 설정 (CI 파트)

📦 GitHub Actions 설정 파일

📂 .github/workflows/ci.yml

name: CI for NestJS

on:
  push:
    branches: [main]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v3

      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: 18

      - name: Install dependencies
        run: npm ci

      - name: Run tests
        run: npm run test:ci

      - name: Build project
        run: npm run build

      - name: Set up Docker
        uses: docker/setup-buildx-action@v2

      - name: Log in to Docker Hub
        uses: docker/login-action@v2
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and push Docker image
        run: |
          docker build -t ${{ secrets.DOCKER_USERNAME }}/nestjs-app:latest .
          docker push ${{ secrets.DOCKER_USERNAME }}/nestjs-app:latest

---

✅ 3. ArgoCD 설정 (CD 파트)

📦 ArgoCD 설치 (Kubernetes 클러스터에)

반응형

kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

📦 ArgoCD 접근

kubectl port-forward svc/argocd-server -n argocd 8080:443

• 브라우저 접속: https://localhost:8080
• 기본 로그인: admin / 초기 비밀번호는 kubectl get pods -n argocd 명령으로 확인

---

✅ 4. ArgoCD 애플리케이션 생성

📂 애플리케이션 정의

argocd app create nestjs-app \
  --repo https://github.com/your-username/nestjs-app \
  --path k8s \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace default \
  --sync-policy automated

📂 애플리케이션 자동 동기화 설정

argocd app set nestjs-app --sync-policy automated

---

✅ 5. Kubernetes 배포 파일 구성

📂 k8s/deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nestjs-app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nestjs-app
  template:
    metadata:
      labels:
        app: nestjs-app
    spec:
      containers:
        - name: nestjs-app
          image: your-docker-id/nestjs-app:latest
          ports:
            - containerPort: 3000
---
apiVersion: v1
kind: Service
metadata:
  name: nestjs-app
spec:
  ports:
    - port: 80
      targetPort: 3000
  selector:
    app: nestjs-app

---

✅ 6. CI/CD 파이프라인 테스트

1. 코드를 수정하고 git push를 실행합니다.
2. GitHub Actions에서 CI 파이프라인이 자동 실행되어 Docker 이미지를 빌드하고 Docker Hub에 푸시합니다.
3. ArgoCD가 새로운 이미지를 감지하고 Kubernetes에 배포합니다.
4. 애플리케이션이 자동으로 최신 상태로 갱신됩니다.

✅ 성공 여부 확인:

argocd app get nestjs-app
kubectl get pods

---

✅ 7. CI/CD 고도화 전략

항목 개선 방법

릴리즈 관리	Git 태그 기반 버전 관리 (예: v1.0.0)
블루그린 배포	Argo Rollouts와 연계하여 트래픽 무중단 전환
모니터링	Grafana와 ArgoCD 연동하여 배포 상태 시각화
롤백 전략	Git 커밋 단위로 롤백 (argocd app rollback)

---

✅ 8. CI/CD 구축 시 유의사항

• GitHub Actions와 ArgoCD의 권한 설정을 명확히 관리
• Kubernetes 클러스터의 리소스 과부하를 방지하기 위해 HPA 설정 고려
• 테스트 환경과 프로덕션 환경을 분리하여 설정 파일 관리 (values.dev.yaml, values.prod.yaml)

---

✅ 결론: CI/CD 자동화로 운영 부담 최소화

✅ GitHub Actions로 CI 파이프라인 구성하여 자동화
✅ ArgoCD로 GitOps 기반 CD 관리하여 무중단 배포
✅ Kubernetes 클러스터에 최적화된 CI/CD 아키텍처 구축
✅ 배포 상태 모니터링과 롤백 전략까지 고려하여 안정성 확보

다음 글에서는 NestJS 프로젝트에서 Kafka 기반 실시간 데이터 스트리밍 파이프라인을 구축하는 방법을 소개합니다! 🌐

---

🔍 다음 글 예고: NestJS + Kafka로 실시간 데이터 스트리밍 파이프라인 구축

📌 다음 편: 25. NestJS + Kafka 실시간 데이터 처리

---

 

NestJS CI/CD,NestJS ArgoCD,NestJS GitHub Actions,NestJS Kubernetes 배포,NestJS CI 자동화,NestJS CD 자동화,NestJS GitOps,NestJS 자동 배포,NestJS ArgoCD 설정,NestJS Docker CI/CD