Files

T

Antigravity Agent 93ec7e9056 [G1-Sync] Manual knowledge update

2026-05-09 21:08:02 +09:00

4.2 KiB

Raw Blame History

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

title

배포 전략

사용자가 다운타임 / 사고를 보지 않게 하는 방법. Rolling (점진), Blue-Green (즉시 전환), Canary (소수 → 전체) 3종이 표준. 트래픽이 클수록 canary 가 안전.

📖 핵심 개념

Rolling: 한 번에 N% 인스턴스 새 버전. 마지막까지 구버전 / 신버전 공존.
Blue-Green: 새 환경 (green) 풀 가동 → LB 한 번에 전환.
Canary: 신버전을 트래픽 1-5% 만 → 메트릭 확인 → 점진 확대.
Feature flag: 코드 deploy ≠ release. 가장 유연.

💻 코드 패턴

Kubernetes Rolling

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)

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)

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 결합 (가장 안전)

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 의 진짜 단위.

4.2 KiB Raw Blame History