Antigravity Agent
131 lines
4.2 KiB
Markdown
131 lines
4.2 KiB
Markdown
---
|
|
id: devops-deployment-strategies
|
|
title: 배포 전략 — Blue-Green / Canary / Rolling
|
|
category: Coding
|
|
status: draft
|
|
source_trust_level: B
|
|
verification_status: conceptual
|
|
created_at: 2026-05-09
|
|
updated_at: 2026-05-09
|
|
tags: [devops, deployment, blue-green, canary, vibe-coding]
|
|
tech_stack: { language: "Kubernetes / ECS / Lambda", applicable_to: ["Backend"] }
|
|
applied_in: []
|
|
aliases: [blue-green, canary, rolling update, traffic shifting]
|
|
---
|
|
|
|
# 배포 전략
|
|
|
|
> 사용자가 다운타임 / 사고를 보지 않게 하는 방법. **Rolling (점진), Blue-Green (즉시 전환), Canary (소수 → 전체)** 3종이 표준. 트래픽이 클수록 canary 가 안전.
|
|
|
|
## 📖 핵심 개념
|
|
- **Rolling**: 한 번에 N% 인스턴스 새 버전. 마지막까지 구버전 / 신버전 공존.
|
|
- **Blue-Green**: 새 환경 (green) 풀 가동 → LB 한 번에 전환.
|
|
- **Canary**: 신버전을 트래픽 1-5% 만 → 메트릭 확인 → 점진 확대.
|
|
- **Feature flag**: 코드 deploy ≠ release. 가장 유연.
|
|
|
|
## 💻 코드 패턴
|
|
|
|
### Kubernetes Rolling
|
|
```yaml
|
|
apiVersion: apps/v1
|
|
kind: Deployment
|
|
metadata: { name: api }
|
|
spec:
|
|
replicas: 10
|
|
strategy:
|
|
type: RollingUpdate
|
|
rollingUpdate:
|
|
maxUnavailable: 1 # 한 번에 1개만 down
|
|
maxSurge: 2 # 최대 2개 추가
|
|
template:
|
|
spec:
|
|
containers:
|
|
- name: api
|
|
image: api:v2
|
|
readinessProbe: { httpGet: { path: /ready, port: 8080 } }
|
|
```
|
|
|
|
readinessProbe 가 통과하기 전에는 traffic 안 받음. 부드러운 교체.
|
|
|
|
### Blue-Green (Argo Rollouts)
|
|
```yaml
|
|
apiVersion: argoproj.io/v1alpha1
|
|
kind: Rollout
|
|
metadata: { name: api }
|
|
spec:
|
|
strategy:
|
|
blueGreen:
|
|
activeService: api-active
|
|
previewService: api-preview
|
|
autoPromotionEnabled: false # 수동 승인
|
|
scaleDownDelaySeconds: 300 # 5분 후 옛것 down
|
|
template: { ... v2 ... }
|
|
```
|
|
|
|
옛 버전 (blue) 와 새 버전 (green) 동시 가동. service selector 만 바꿔 즉시 전환. 문제 시 즉시 롤백.
|
|
|
|
### Canary (Argo Rollouts)
|
|
```yaml
|
|
spec:
|
|
strategy:
|
|
canary:
|
|
maxSurge: "20%"
|
|
maxUnavailable: 0
|
|
steps:
|
|
- setWeight: 5 # 5% 트래픽
|
|
- pause: { duration: 5m }
|
|
- analysis: # Prometheus 메트릭 자동 검증
|
|
templates: [ { templateName: success-rate } ]
|
|
- setWeight: 25
|
|
- pause: { duration: 10m }
|
|
- setWeight: 50
|
|
- pause: { duration: 10m }
|
|
- setWeight: 100
|
|
```
|
|
|
|
자동 metric analysis → 임계값 미달 시 자동 롤백.
|
|
|
|
### Database 호환성 (deploy 와 함께)
|
|
- expand-contract 패턴 (`DB_Migration_Safety.md` 참고).
|
|
- 코드 N+1 버전이 schema N 도, N+1 도 호환되어야.
|
|
|
|
### Feature flag 결합 (가장 안전)
|
|
```ts
|
|
if (await flags.isOn('checkout-v2', { userId })) {
|
|
return newCheckoutFlow();
|
|
}
|
|
return oldCheckoutFlow();
|
|
```
|
|
|
|
코드는 deploy, release 는 flag toggle. 사고 시 flag off — 재배포 X.
|
|
|
|
## 🤔 의사결정 기준
|
|
| 상황 | 권장 |
|
|
|---|---|
|
|
| 단일 인스턴스 | rolling 의미 없음. 짧은 down 또는 blue-green |
|
|
| 작은 팀, 트래픽 적음 | rolling |
|
|
| 트래픽 큼, 사고 비싼 | canary + auto-analysis |
|
|
| Stateful (DB schema 변경) | expand-contract + canary |
|
|
| Lambda / serverless | alias + weighted (canary 자연스러움) |
|
|
| 모바일 앱 | staged rollout (Play Store / App Store) |
|
|
|
|
## ❌ 안티패턴
|
|
- **readinessProbe 없는 rolling**: 새 인스턴스가 준비 전 traffic 받음 → 사용자 에러.
|
|
- **hot deploy without graceful shutdown**: 진행 중 요청 cut.
|
|
- **DB 변경 + 코드 변경 동시**: 신구 코드가 다른 schema 가정 → 사고. expand-contract.
|
|
- **canary 메트릭 없음**: "잘 되는지" 모르고 100% 확대.
|
|
- **롤백 절차 없음**: 사고 시 panic. 1-click 또는 auto.
|
|
- **environment 분리 없음**: dev = prod = 한 클러스터.
|
|
- **secret 도 deploy 와 같이 변경**: rotation 따로.
|
|
- **canary 가 5% 인데 그 5% 가 가장 활성 사용자**: 표본 편향. 라우팅 균등.
|
|
|
|
## 🤖 LLM 활용 힌트
|
|
- 트래픽 클수록 canary + analysis.
|
|
- DB 변경은 항상 expand-contract.
|
|
- Feature flag 가 release 의 진짜 단위.
|
|
|
|
## 🔗 관련 문서
|
|
- [[Feature_Flags_in_Practice]]
|
|
- [[DB_Migration_Safety]]
|
|
- [[Backend_Health_Check_Patterns]]
|