프로젝트 이름 지정하기

프로젝트 이름 지정하기 (Specify a project name)

기본적으로 Compose는 Compose 파일이 들어 있는 디렉터리 이름을 기반으로 프로젝트 이름을 지정해요. 이를 여러 방법으로 오버라이드할 수 있어요.

이 페이지는 커스텀 프로젝트 이름이 유용한 시나리오를 다루고, 프로젝트 이름을 설정하는 다양한 방법과 각 접근 방식의 우선순위 순서를 제공해요.

출처: 문서

본문

(커맨드 라인 옵션으로도 설정 가능해요.)

예시 사용 사례 (Example use cases)

Compose는 프로젝트 이름으로 환경을 서로 격리해요. 프로젝트 이름이 유용한 여러 맥락이 있어요:

  • 개발 호스트에서: 단일 환경의 여러 복사본을 만들어, 프로젝트의 각 기능 브랜치마다 안정적인 복사본을 실행하는 데 유용.
  • CI 서버에서: 프로젝트 이름을 고유한 빌드 번호로 설정해 빌드 간 간섭 방지.
  • 공유·개발 호스트에서: 같은 서비스 이름을 공유할 수 있는 서로 다른 프로젝트 간의 간섭 방지.

프로젝트 이름 설정 (Set a project name)

프로젝트 이름은 소문자, 숫자, 하이픈, 밑줄만 포함해야 해요. -p/--project-name 플래그, COMPOSE_PROJECT_NAME 환경 변수, 또는 Compose 파일의 name 최상위 속성으로 설정할 수 있어요.

우선순위 (Precedence)

프로젝트 이름 설정 방법의 우선순위(높음 → 낮음)는:

  1. 커맨드 라인 플래그
  2. 환경 변수 (COMPOSE_PROJECT_NAME)
  3. 구성 파일의 name(할당 여부에 따라)

더 알아보기 (Learn more)