Docker Compose에서 사전 정의 환경 변수 구성하기
Docker Compose에서 사전 정의 환경 변수 구성하기 (Configure pre-defined environment variables in Docker Compose)
Docker Compose는 프로젝트 이름, Compose 파일 경로 같은 동작을 제어하는 사전 정의 환경 변수를 지원해요. 자세한 내용은 Docker CLI 환경 변수 참조를 확인해요.
출처: 문서
본문
이 페이지는 다음 사전 정의 환경 변수를 어떻게 설정·변경하는지 설명해요.
오버라이드 방법 (Methods to override)
환경 변수를 변경하거나 설정할 때는 환경 변수 우선순위(Environment variable precedence)를 인지해야 해요.
구성 세부사항 (Configuration details)
프로젝트·파일 구성 (Project and file configuration)
COMPOSE_PROJECT_NAME
프로젝트 이름을 설정해요. 이 값은 서비스 이름과 함께 컨테이너 이름 앞에 붙어요.
Compose는 여러 방식으로 프로젝트 이름을 설정할 수 있어요. 각 방식의 우선순위(높음 → 낮음)는 다음과 같아요:
- 커맨드 라인 플래그 (
-p/--project-name) - (환경 변수)
- (구성 파일의
name속성) - 구성 파일이 지정되지 않으면 현재 디렉터리의 이름 (of the current directory)
프로젝트 디렉터리나 현재 디렉터리 이름이 이 제약을 위반하면 다른 메커니즘을 써야 해요. COMPOSE_PROJECT_NAME으로 프로젝트 이름을 지정할 수 있어요.
COMPOSE_FILE
Compose 파일의 경로를 지정해요. 여러 Compose 파일을 지정하면 병합돼요.
(그 외 사전 정의 변수)
그 외에도 COMPOSE_PROFILES, COMPOSE_BAKE, COMPOSE_IGNORE_ORPHANS 등 다양한 사전 정의 환경 변수가 있어요. 각 변수의 의미와 기본값은 원본 문서를 참고해요.