Docker Compose는 단일 YAML 파일을 사용하여 멀티 컨테이너 애플리케이션을 정의하고 실행하는 도구입니다. 여러 docker run 명령을 수동으로 실행하는 대신, 모든 서비스(앱, 데이터베이스, 캐시)를 docker-compose.yml에 기술하고 하나의 명령으로 함께 시작합니다.
실제 앱은 종종 여러 container를 가짐: 웹 앱 + 데이터베이스 + 캐시 + ...
→ 각각을 docker run으로 수동 실행(포트, 네트워크, volume, 환경 변수, 의존성)하는 것은
번거롭고, 오류가 발생하기 쉬우며, 재현/공유하기 어려움
→ Compose는 전체 스택을 하나의 파일에 정의 → 하나의 명령으로 전체를 시작.
services:
web:
build: . # 로컬 Dockerfile로부터 빌드
ports:
- "3000:3000" # 포트 매핑
environment:
- DATABASE_URL=postgres://db:5432/myapp
depends_on:
- db # web보다 먼저 db 시작
db:
image: postgres:16 # 미리 빌드된 image 사용
environment:
- POSTGRES_PASSWORD=secret
volumes:
- dbdata:/var/lib/postgresql/data # 데이터베이스 영속화
volumes:
dbdata:
하나의 파일이 모든 서비스, 그것들의 image/빌드, 포트, 환경 변수, volume, 의존성을 정의하며 — 그것들은 네트워크를 공유합니다(서비스 이름으로 서로에게 도달, 예: db).
docker compose up -d # 모든 서비스를 빌드하고 시작(백그라운드에서)
docker compose ps # 실행 중인 서비스 목록
docker compose logs -f # 모든 서비스의 로그 보기
docker compose down # 모든 것을 중지하고 제거
docker compose down -v # volume도 제거
Docker Compose를 이해하는 것은 가치 있습니다. 실제 애플리케이션은 거의 항상 여러 container를 수반하며 Compose가 그것들을 관리하는 표준 도구이기 때문입니다. 따라서 중요한 실용 지식입니다.
그것이 해결하는 문제는 실제적입니다. 전형적인 애플리케이션은 여러 서비스(웹 앱, 데이터베이스, 캐시, 어쩌면 메시지 큐)를 가지며, 각각을 별도의 docker run 명령으로 수동 실행하는 것 — 포트, 네트워크, volume, 환경 변수, 시작 순서를 구성하는 것 — 은 번거롭고, 오류가 발생하기 쉬우며, 재현하거나 공유하기 어렵습니다. Compose는 전체 멀티 컨테이너 스택을 하나의 선언적 YAML 파일에 정의하고 단일 명령(docker compose up)으로 전체를 시작함으로써 이를 해결하여, 멀티 컨테이너 애플리케이션을 쉽게 실행하고, 재현하고, 공유할 수 있게 합니다.
docker-compose.yml 구조(서비스를 그것들의 image/빌드, 포트, 환경 변수, volume, 의존성과 함께 정의하며, 서비스가 자동으로 네트워킹되어 이름으로 도달 가능)와 주요 명령(up, down, ps, logs)을 이해하는 것은 개발과 멀티 서비스 애플리케이션 실행을 위한 실용적이고 일상적인 지식입니다.
Compose는 특히 로컬 개발 환경(앱을 그 데이터베이스 및 의존성과 함께 하나의 명령으로 띄움)과 애플리케이션 스택을 재현 가능하게 정의하는 데 가치가 있습니다.
실제 애플리케이션은 일반적으로 멀티 컨테이너이고, Docker Compose가 그것들을 간단하게 정의하고 실행하는 표준적이고 널리 사용되는 도구이므로(번거로운 수동 오케스트레이션을 하나의 선언적 파일과 명령으로 대체함), Docker Compose — 그것이 해결하는 것, compose 파일 구조, 명령 — 를 이해하는 것은 멀티 컨테이너 애플리케이션 작업을 위한 가치 있고 자주 적용되는 지식이며, 사소하지 않은 모든 컨테이너화 애플리케이션을 위한 Docker의 거의 필수적인 동반자이자 개발 워크플로에서 어디에나 존재하는 도구입니다.