버전과 이름 최상위 요소

버전과 이름 최상위 요소 (Version and name top-level elements)

Compose 파일의 version과 name 최상위 요소를 설명해요. version은 구식(obsolete)이고 name은 프로젝트 이름을 정의해요.

출처: 문서

중요

최상위 version 속성은 하위 호환을 위해 Compose Specification으로 정의됐어요. 정보 제공용일 뿐이며, 사용하면 구식이라는 경고 메시지를 받게 돼요.

Compose는 version 필드와 관계없이 항상 가장 최신 스키마로 Compose 파일을 검증해요.

Compose는 Compose 파일을 완전히 파싱할 수 있는지 확인해요. 일부 필드가 알 수 없으면, 대개 Compose 파일이 Specification의 최신 버전으로 정의된 필드로 작성된 경우, 경고 메시지를 받게 돼요.

최상위 name 속성은 명시적으로 설정하지 않을 때 사용할 프로젝트 이름으로 Compose Specification에 정의돼요.

Compose는 이 이름을 오버라이드하는 방법을 제공하며, 최상위 name 요소가 설정되지 않을 때 사용할 기본 프로젝트 이름을 설정해요.

프로젝트 이름이 최상위 name 또는 어떤 커스텀 메커니즘으로 정의될 때마다 보간(interpolation)과 환경 변수 해석을 위해 COMPOSE_PROJECT_NAME으로 노출돼요.

name: myapp

services:
  foo:
    image: busybox
    command: echo "I'm running ${COMPOSE_PROJECT_NAME}"

Compose 프로젝트 이름을 지정하는 다른 방법에 대한 자세한 내용은 "Specify a project name" 를 참고해요.