Twelve-Factors

Twelve-Factors 란?

• Heroku 클라우드 플랫폼 창시자들이 정립한 애플리케이션 개발 원칙 중 유익한 것을 모아서 정리한 것
• 탄력적(elastic)이고 이식성 있는(portability) 배포를 위한 Best Practices

---

핵심 사상

• 선언적(목표명시) 형식으로 설정을 자동화해서 프로젝트에 새로 참여하는 동료가 적응하는 데 필요한 시간과 비용을 최소화한다.
• 운영체제에 구애받지 않는 투명한 계약을 통해 다양한 실행 환경에서 작동할 수 있도록 이식성을 극대화 한다.
• 현대적인 클라우드 플랫폼 기반 개발을 통해 서버와 시스템 관리에 대해 부담을 줄인다.
• 개발과 운영의 간극을 최소화해서 지속적 배포(continuous deployment)를 가능하게 하고 애자일성을 최대화 한다.
• 도구, 아키텍처, 개발 관행을 크게 바꾸지 않아도 서비스 규모 수직적 확장이 가능하다.

---

Twelve-Factors의 제약 사항

1. 코드 베이스(Codebase)

• 버전 관리되는 하나의 코드베이스가 여러번 배포된다.
• 코드베이스와 앱 사이에는 항상 1대1 관계가 성립된다.

2. 의존성(Dependencies)

• 애플리케이션의 의존관계(dependencies)는 명시적으로 선언 되어야 한다.
• 모든 의존 라이브러리는 아파치 메이븐, 그레들 등의 의존관계 관리 도구를 써서 라이브러리 저장소에서 내려받을 수 있어야 한다.

3. 설정(Config)

• 설정 정보는 실행 환경에 저장한다.
• 설정 정보(configuration)는 애플리케이션 코드와 엄격하게 분리한다.
• 설정은 배포(스테이지, 프로덕션, 개발 환경 등) 마다 달라질 수 있는 모든 것(DB정도, 외부 서비스 인증, 호스트 이름 등)
• 설정을 환경 변수(env)에 저장한다.

4. 백엔드(지원) 서비스(Backend Service)

• 지원 서비스(backing sevice)는 필요에 따라 추가되는 자원으로 취급한다.
• 지원 서비스는 데이터베이스, API 기반 RESTFul 웹 서비스, SMTP 서버, FTP 서버 등
• 지원 서비스는 애플리케이션의 자원으로 간주한다.
• 테스트 환경에서 사용하던 임베디드 SQL을 스테이징 환경에서 MySQL로 교체할 수 있어야 한다.

5. 무상태 프로레스(Stateless process)

• 애플리케이션을 하나 혹은 여러개의 무상태 프로세스로 실행
• 상태는 외부 저장소에 보관

6. 빌드, 릴리즈, 실행(Build, Release, Run)

• 철저하게 분리된 빌드와 실행 단계
• 코드베이스는 3단계를 거쳐 (개발용이 아닌) 배포로 변환한다.
  1. 빌드 단계 : 소스 코드를 가져와 컴파일 후 하나의 패키지를 만든다.
  2. 릴리스 단계 : 빌드에 환경설정 정보를 조합한다. 릴리스 버전은 실행 환경에서 운영될 수 있는 준비가 완료되어 있다. 시맨틱 버저닝 등 식별자가 부여됨, 이 버전은 롤백하는 데 사용
  3. 실행 단계 : 보통 런타임이라 불림, 릴리스 버전 중 하나를 선택해 실행 환경 위에 애플리케이션 실행

7. 포트 바인딩

• 서비스는 포트에 연결해서 외부에 공개한다.
• 실행 환경에 웹 서버를 따로 추가해줄 필요 없이 스스로 웹 서버를 포함하고 있어서 완전히 자기 완비적(self-contained)이다.

8. 동시성(Concurrency)

• 프로세스 모델을 통해 수평적으로 확장한다.
• 애플리케이션은 필요할 때 마다 프로세스나 스레드를 수평적으로 확장해서 병렬로 실행 할 수 있어야 한다.
• 장시간 소요되는 데이터 프로세싱 작업은 스레드풀에 할당해서 실행기(executor)를 통해 수행되어야 한다.
• 예를 들어, HTTP 요청은 서블릿 쓰레드가 처리하고, 시간이 오래 걸리는 작업은 워커 쓰레드가 처리해야 한다.

9. 처분성(Disposability)

• 빠른 시작과 그레이스풀 셧다운(Graceful Shutdown)을 통한 안정성 극대화
• 애플리케이션은 프로세스 실행 중에 언제든지 중지될 수 있고, 중지될 때 처리되어야 하는 작업을 모두 수행한 다음 깔끔하게 종료될 수 있다.
• 가능한 짧은 시간 내에 시작되어야 한다.

10. dev / prod 일치

• development, staging, production 환경을 최대한 비슷하게 유지
• 개발 환경과 운영 환경을 가능한 한 동일하게 유지하는 짝맞춤(parity)을 통해 분기(divergence)를 예방할 수 있다.
• 유념해야 할 세가지
  1. 시간 차이 : 개발자는 변경 사항을 운영 환경에 빨리 배포해야 한다.
  2. 개인 차이 : 코드 변경을 맡은 개발자는 운영 환경으로 배포 작업까지 할 수 있어야 하고, 모니터링도 할 수 있어야 한다.
  3. 도구 차이 : 각 실행 환경에 사용된 기술이나 프레임워크는 동일하게 구성되어야 한다.

11. 로그

• 로그는 이벤트 스트림으로 취급한다.
• 로그를 stdout에 남긴다.
• 애플리케이션은 로그 파일 저장에 관여하지 말아야 한다.
• 로그 집계와 저장은 애플리케이션이 아니라 실행 환경에 의해 처리되어야 한다.

12. Admin 프로세스

• admin/maintenance 작업을 일회성 프로세스로 실행
• 실행되는 프로세스와 동일한 환경에서 실행
• admin 코드는 애플리케이션 코드와 함께 배포되어야 한다.

---

참고 사이트

Twelve-Factors