Extension 최상위 요소

Extension 최상위 요소 (Extension top-level element)

Compose 파일의 최상위 extension 요소는 x- 접두사 확장 필드를 사용해 Compose 구성을 확장하는 방법이에요. Compose 파일을 더 읽기 쉽고 유지보수 가능하게 만드는 데 도움을 줍니다.

출처: 문서

본문

설명 (Description)

최상위 x- 접두사 확장 필드는 Compose 구성을 확장하는 데 사용돼요. 각 확장 필드는 매우 광범위하게 열려 있고, Compose는 이를 무시하므로 그 안에서 사용되는 구문에 대한 구조적 검증을 수행하지 않아요.

예시 (Example)

x-env: &env
  environment:
    - LAUNCH_ROCKET
    - BUILD_DOLLAR

x-common: &common
  image: busybox
  command: echo "This is a test"

services:
  app:
    <<: *common

참고:

YAML merge 문법을 사용해 확장 필드를 참조할 때, 대상 속성이 매핑이 아닌 시퀀스나 스칼라라면 오류가 발생해요.

docker compose config는 확장 필드를 로드하지 않는다는 점에 주의해요.

더 알아보기 (Learn more)

• YAML 앵커·별칭과의 결합은 fragments 문서를 참고해요.