Develop 최상위 요소

Develop 최상위 요소 (Develop / watch)

Compose 파일의 develop 최상위 요소는 Compose의 watch 기능(watch mode)을 설정하는 데 사용돼요. 개발 중 소스 트리의 변경을 감지해 컨테이너를 자동으로 재빌드·재시작 하도록 지정할 수 있어요.

출처: 문서

본문

설명 (Description)

develop 최상위 요소는 소스 변경을 보고 로컬 개발 워크플로에 맞춰 작업을 다시 실행하는 Compose watch를 구성해요.

속성 (Attributes)

develop 블록에는 watch 속성이 있으며, 이는 변경 감지 규칙 목록을 정의해요. 각 규칙은 다음 속성을 포함할 수 있어요:

  • path (필수): 변경을 감시할 파일 또는 디렉토리 경로. 오버라이드를 위해 glob 패턴으로 지정할 수도 있어요.
  • action (필수): 변경 시 수행할 작업. rebuild, sync, 또는 sync+restart 중 하나.
    • rebuild: 소스 변경 시 이미지와 서비스를 다시 빌드·실행.
    • sync: 파일만 컨테이너로 동기화하고 서비스는 다시 시작하지 않음.
    • sync+restart: 파일을 동기화하고 서비스를 다시 시작.
  • target (선택): syncsync+restart 동작에서 파일을 컨테이너의 어디에 동기화할지 지정.
  • ignored (선택): 감시에서 제외할 경로.

예시 (Example)

services:
  web:
    image: myapp
    build: .
    develop:
      watch:
        - action: sync
          path: ./src
          target: /src
        - action: rebuild
          path: .

docker compose watch를 실행해 변경 감지로 개발 반복을 자동화할 수 있어요.

더 알아보기 (Learn more)

  • Compose watch 사용법은 docker compose watch 명령과 Compose 문서를 참고해요.