본문 바로가기
Docker

[Docker] docker-compose.override.yml 개념 및 사용법

by 임혁진 2025. 4. 17.

 1. docker-compose.override.yml이란?

docker-compose.yml을 확장해서 개발/운영 환경별 설정을 따로 관리할 수 있게 도와주는 파일.

 

  • 개발: 코드 수정 시 자동 반영, 디버깅, 로깅 등
  • 운영: 보안, 성능 최적화, 로그 최소화 등등

 

 기본 동작

docker-compose up을 실행하면, 도커는 자동으로 아래 두 파일을 병합해서 실행합니다.

  • docker-compose.yml
  • docker-compose.override.yml

 예시

docker-compose.yml

services:
  web:
    build: .
    ports:
      - "80:80"

 

docker-compose.override.yml

services:
  web:
    volumes:
      - ./src:/app/src
    environment:
      - DEBUG=true

 

위처럼 하면, 개발 환경에서는 볼륨디버그 환경변수가 추가

즉. web: build, ports , volumes , environment 가 다 들어감.

 

운영에서는?

운영용은 -f 옵션으로 별도 파일을 지정

docker-compose -f docker-compose.yml -f docker-compose.prod.yml up

docker-compose -f 명령어

  • -f 옵션은 사용할 docker-compose 파일을 직접 지정하는 옵션
  • 여러 개의 Compose 파일을 사용할 수 있고, 뒤에 오는 파일이 앞에 오는 파일을 "덮어쓴다"는 게 핵심

 

관련 글 목록