카나리 배포(Canary Deployment)란 무엇인가요?

김상욱·2025년 1월 12일

카나리 배포(Canary Deployment)란 무엇인가요?

카나리 배포(Canary Development)는 소프트웨어 업데이트를 점진적으로 적용하여 전체 시스템에 미치는 영향을 최소화하고, 새로운 버전의 안정성을 확인하는 배포 전략 중 하나입니다. 이 방법은 특히 대규모 애플리케이션이나 서비스에서 중요하며, 새로운 기능이나 변경 사항이 문제를 일으킬 경우 빠르게 대응할 수 있게 도와줍니다.

왜 카나리 배포가 필요한가요?

전통적인 배포 방식에서는 새로운 버전을 한 번에 전체 사용자에게 배포합니다. 이 경우, 새로운 버전에 버그가 있거나 예상치 못한 문제가 발생하면 모든 사용자에게 영향을 미칠 수 있습니다. 반면, 카나리 배포는 새로운 버전을 일부 사용자에게만 먼저 배포하여 문제를 조기에 발견하고, 전에 배포 전에 수정할 수 있게 해줍니다.

카나리 배포의 단계

기존 버전 유지 : 현재 안정적으로 운영 중인 버전(예: 버전 1)을 계속해서 서비스합니다.
새 버전 배포 : 새로운 버전(예: 버전 2)을 일부 서버에 배포합니다. 이때 전체 트래픽의 일부(예: 5%)만 새로운 버전으로 보내집니다.
모니터링 및 검증 : 새로운 버전이 정상적으로 동작하는지 모니터링합니다. 오류율, 성능, 사용자 피드백 등을 확인합니다.
점진적 확대 : 새로운 버전이 안정적이라 판단되면, 점차 새로운 버전으로 향하는 트래픽의 비율을 늘려 전체 시스템에 배포합니다.
완전 전환 또는 롤백 : 모든 트래픽이 새로운 버전으로 전환되면 배포가 완료됩니다. 만약 문제가 발생하면, 이전 버전으로 빠르게 롤백할 수 있습니다.

Java/Spring 백엔드 개발자 입장에서의 카나리 배포

컨테이너화 : Docker와 같은 컨테이너 기술을 사용하여 애플리케이션을 패키징하면, 다양한 버전을 쉽게 배포하고 관리할 수 있습니다.
오케이스트레이션 도구 : Kubernetes와 같은 오케스트레이션 도구를 사용하면, 트래픽을 특정 비율로 분산시키고, 카나리 배포를 자동화할 수 있습니다. 예를 들어, Deployment의 canary 전략을 설정하여 새로운 버전의 파드를 일정 비율로 추가할 수 있습니다.
서비스 메쉬 : Istio와 같은 서비스 메쉬를 사용하면, 세밀한 트래픽 제어와 모니터링이 가능합니다. 이를 통해 카나리 배포 시 트래픽을 세부적으로 조절하고, 문제 발생 시 빠르게 대응할 수 있습니다.
CI/CD 파이프라인 : Jenkins, GitLab CI, GitHub Actions와 같은 CI/CD 도구를 활용하여, 카나리 배포 과정을 자동화할 수 있습니다. 새로운 버전이 빌드되면 자동으로 일부 서버에 배포되고, 테스트가 진행되도록 설정할 수 있습니다.

장점

리스크 최소화 : 전체 시스템에 영향을 미치기 전에 문제를 조기에 발견할 수 있습니다.
빠른 피드백 : 실제 사용자 환경에서 새로운 기능의 성능과 안정성을 테스트할 수 있습니다.
유연성 : 문제가 발생했을 때 빠르게 롤백할 수 있어 안정적인 서비스 제공이 가능합니다.

단점

복잡성 증가 : 배포 과정이 복잡해지고, 추가적인 인프라와 도구가 필요할 수 있습니다.
모니터링 필요 : 새로운 버전의 상태를 지속적으로 모니터링해야 하므로, 모니터링 시스템이 잘 갖추어져 있어야 합니다.

네, 취업 준비 중인 신입 Java/Spring 백엔드 개발자가 카나리 배포 개념과 실습을 통해 경험을 쌓을 수 있는 몇 가지 실습 방법을 소개해드릴게요.

1. 로컬 환경에서의 카나리 배포 실습

A. Spring Boot 애플리케이션 두 버전 만들기

목표: 기존 버전과 신규 버전을 각각 만들어서 기능 차이를 확인할 수 있도록 합니다.
실습 방법:
- 간단한 REST API 엔드포인트를 가진 Spring Boot 애플리케이션을 생성합니다.
- 기존 버전(v1)은 “Hello World” 같은 기본 엔드포인트를 제공하게 하고, 신규 버전(v2)은 “Hello Canary”와 같이 약간 다른 기능 또는 메시지를 반환하게 구현해보세요.
- 각각의 버전을 다른 포트 또는 Docker 이미지를 사용하여 구분합니다.

B. Docker 컨테이너화

목표: 애플리케이션을 Docker 컨테이너에 담아서 쉽게 배포 및 관리하는 방법을 익힙니다.
실습 방법:
- 두 버전의 Spring Boot 애플리케이션을 각각 Docker 이미지로 빌드합니다.
- Dockerfile을 작성해 이미지 빌드를 자동화해보세요.
- 예:
```
FROM openjdk:11-jre-slim
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]
```

C. 로컬 쿠버네티스 클러스터 사용 (minikube 또는 kind)

목표: 쿠버네티스 클러스터를 통해 실제 카나리 배포 시나리오를 모의 실습합니다.
실습 방법:
- minikube 또는 kind를 설치한 후, 로컬에서 쿠버네티스 클러스터를 구성합니다.
- 기존 버전(v1)을 배포하는 Deployment와 신규 버전(v2)를 배포하는 별도의 Deployment를 작성합니다.
- 서비스 리소스를 이용하여 트래픽 분산을 연습합니다.

D. 실습 예제

Deployment 작성:

v1 Deployment (예: 3개의 파드):

apiVersion: apps/v1
kind: Deployment
metadata:
  name: spring-app-v1
spec:
  replicas: 3
  selector:
    matchLabels:
      app: spring-app
      version: "v1"
  template:
    metadata:
      labels:
        app: spring-app
        version: "v1"
    spec:
      containers:
      - name: spring-app
        image: your-dockerhub-username/spring-app:v1
        ports:
        - containerPort: 8080

v2 Deployment (예: 1개의 파드, 초기 카나리 배포):

apiVersion: apps/v1
kind: Deployment
metadata:
  name: spring-app-v2
spec:
  replicas: 1
  selector:
    matchLabels:
      app: spring-app
      version: "v2"
  template:
    metadata:
      labels:
        app: spring-app
        version: "v2"
    spec:
      containers:
      - name: spring-app
        image: your-dockerhub-username/spring-app:v2
        ports:
        - containerPort: 8080

서비스(SVC) 작성:
- 두 Deployment의 파드를 모두 포함하는 서비스 리소스를 생성합니다.
- 서비스는 두 Deployment의 파드를 선택할 수 있도록 label selector를 app: spring-app으로 지정합니다.
```
apiVersion: v1
kind: Service
metadata:
  name: spring-app-service
spec:
  selector:
    app: spring-app
  ports:
  - protocol: TCP
    port: 80
    targetPort: 8080
```
- 이렇게 하면 서비스는 v1, v2의 파드 모두로 트래픽을 전달하는데, 이후 인그레스나 서비스 메쉬(예: Istio)를 활용해 세밀하게 트래픽 비율을 조절할 수 있습니다.
트래픽 조정 (선택사항):
- 간단하게 서비스 리소스를 통해 트래픽을 보내다 보면, v1과 v2 모두에 트래픽이 전달됩니다.
- 좀 더 정밀하게 제어하려면 Istio, Linkerd와 같은 서비스 메쉬 도구를 도입하거나, Ingress 컨트롤러에서 Canary 기능을 지원하는 설정(예: NGINX Ingress Controller의 annotation)을 활용할 수 있습니다.

2. CI/CD 파이프라인 연동 실습

A. Jenkins 또는 GitHub Actions 사용하기

목표: 코드가 커밋될 때마다 자동으로 빌드, Docker 이미지 생성, 쿠버네티스 클러스터에 배포하는 과정을 경험해봅니다.
실습 방법:
- Maven을 사용하여 Spring Boot 애플리케이션을 빌드하고, Docker 빌드를 수행하도록 파이프라인 스크립트를 작성합니다.
- CI/CD가 완료되면, 쿠버네티스 클러스터에 새 버전을 배포하는 스크립트를 작성합니다.
- 이 때, 카나리 배포를 위해 초기에는 신규 버전(v2)을 일부 파드만 배포한 후 모니터링을 통해 추가 배포 또는 롤백하는 로직을 추가할 수 있습니다.

3. 모니터링 및 롤백 연습

목표: 카나리 배포 중에 발생할 수 있는 문제를 모니터링하고, 문제가 발생한 경우 롤백하는 시나리오를 익힙니다.
실습 방법:
- Prometheus, Grafana 등을 사용하여 애플리케이션의 성능, 에러율, 응답 시간을 모니터링합니다.
- 카나리 버전(v2)에 문제가 발생했다고 가정하고, 쿠버네티스 CLI 또는 CI/CD 파이프라인을 통해 롤백하는 과정을 시뮬레이션해봅니다.

4. 추가 학습 자료 및 연습방법

Kubernetes 공식 문서 및 Spring Boot + Docker 관련 튜토리얼을 참고하세요.
유튜브에서 "Canary Deployment Tutorial" 등으로 검색하면 다양한 데모 영상을 참고할 수 있습니다.
GitHub 오픈소스 프로젝트에서 카나리 배포 관련 예제 코드나 Helm 차트 등을 찾아보며 실제 코드 구조와 설정을 이해해보세요.

이러한 실습들을 통해 Java/Spring 백엔드 개발자로서 카나리 배포의 개념부터 실무 적용까지 경험해볼 수 있으며, DevOps 팀이나 클라우드 인프라 환경과 협업할 때 큰 도움이 될 것입니다.

혹시 추가적으로 더 궁금한 부분이나 도움이 필요한 부분이 있다면 언제든 질문해 주세요!

김상욱

이전 포스트

[코딩테스트][백준] 🔥 백준 2448번 "별 찍기 - 11" 문제: Python으로 완벽 해결하기! 🔥

다음 포스트

카나리 배포(Canary Deployment)란 무엇인가요?