12 Factor App — 클라우드 네이티브 애플리케이션 설계 원칙

하나의 Git 저장소 → 여러 환경에 배포

┌─────────────┐
│  Git Repo   │──→ dev 환경
│  (하나)     │──→ staging 환경
└─────────────┘──→ production 환경

✗ 환경별로 코드가 다르면 안 됨
✗ 여러 앱이 한 저장소에 있으면 분리 필요

✓ 좋은 예:
  package.json, build.gradle, requirements.txt에 모든 의존성 명시
  → npm install, pip install -r requirements.txt로 재현 가능

✗ 나쁜 예:
  "서버에 curl이 설치되어 있을 거야"라고 가정
  → 시스템 의존성도 Dockerfile에 명시해야 함

# ✗ 코드에 하드코딩
db_url = "jdbc:mysql://prod-db:3306/myapp"

# ✓ 환경 변수로 분리
db_url = os.environ['DATABASE_URL']

DB, 메시지 큐, 캐시, 메일 서비스 등을 교체 가능한 리소스로 취급

로컬 MySQL → AWS RDS로 교체할 때
코드 변경 없이 DATABASE_URL 환경 변수만 변경

DATABASE_URL=mysql://localhost:3306/myapp    (로컬)
DATABASE_URL=mysql://rds.amazonaws.com/myapp (프로덕션)

Build:   코드 + 의존성 → 실행 가능한 아티팩트 (JAR, Docker 이미지)
Release: 아티팩트 + 설정 → 릴리스 (버전 태깅)
Run:     릴리스 실행

✗ 운영 서버에서 직접 코드 수정하면 안 됨
✓ 항상 빌드 → 릴리스 → 실행 순서를 지켜야 함

✗ 나쁜 예: 파일 시스템에 세션 저장
  // 서버가 여러 대면 세션이 공유되지 않음
  app.use(session({ store: new FileStore() }));

✓ 좋은 예: 외부 저장소에 상태 저장
  // Redis에 세션 저장 → 어떤 서버가 처리해도 동일
  app.use(session({ store: new RedisStore() }));

앱 자체가 HTTP 서버 역할 (별도 웹 서버 불필요)
→ Spring Boot의 내장 Tomcat, Node.js의 Express 등

app.listen(process.env.PORT || 3000);

수직 확장 (Scale Up): 서버 사양 올리기 → 한계 있음
수평 확장 (Scale Out): 프로세스 수 늘리기 → 12 Factor 방식

web=3       (웹 요청 처리 프로세스 3개)
worker=2    (백그라운드 작업 프로세스 2개)
scheduler=1 (스케줄러 프로세스 1개)

빠른 시작: 수 초 내에 요청 처리 가능 상태
우아한 종료(Graceful Shutdown):
  1. SIGTERM 수신
  2. 새 요청 거부
  3. 진행 중인 요청 완료 대기
  4. 프로세스 종료

// Node.js 예시
process.on('SIGTERM', () => {
  server.close(() => {
    db.disconnect();
    process.exit(0);
  });
});

✗ 나쁜 예:
  개발: SQLite + 로컬 파일 저장
  프로덕션: PostgreSQL + S3

✓ 좋은 예:
  개발: Docker Compose로 PostgreSQL + MinIO
  프로덕션: RDS PostgreSQL + S3
  → 같은 종류의 서비스 사용

✗ 나쁜 예: 앱이 직접 로그 파일 관리
  logger.setOutput(new FileWriter("/var/log/app.log"));

✓ 좋은 예: stdout으로 출력, 수집은 인프라가 담당
  console.log(JSON.stringify({ level: "info", msg: "요청 처리 완료" }));
  → Fluentd, Logstash 등이 수집하여 Elasticsearch로 전달

DB 마이그레이션, 데이터 정리 등의 관리 작업도
앱과 동일한 환경에서 일회성 프로세스로 실행

# 좋은 예
kubectl exec -it app-pod -- python manage.py migrate
docker exec app python manage.py createsuperuser

# 나쁜 예: 프로덕션 서버에 SSH로 접속해서 직접 실행