본문으로 건너뛰기
yutils
Kubernetes YAML 시각화
예시

입력 (docker-compose.yml)

services:
  web:
    image: nginx
    depends_on: [api]
    networks: [frontend]
  api:
    build: ./api
    depends_on: [db]
    networks: [frontend, backend]
  db:
    image: postgres:16
    volumes:
      - db-data:/var/lib/postgresql/data
    networks: [backend]
networks:
  frontend:
  backend:
volumes:
  db-data:

결과

6 리소스, 5 관계.
- web → api (depends_on)
- api → db (depends_on)
- frontend → web/api (network)
- backend → api/db (network)
- db → db-data (volume)

참고

depends_on 은 점선으로 표시 — 같은 컬럼 안 (service ↔ service) 관계이기 때문. 네트워크 / 볼륨 / 컨피그 / 시크릿은 top-level 에 선언된 것만 그래프 노드로 표시. bind mount (./local:/path) 는 그래프 제외.

사용법 / 자주 묻는 질문

이런 경우 사용하세요

  • PR 리뷰 — 새 docker-compose.yml 의 서비스 구조 한눈에 검증
  • 온보딩 — 신입에게 로컬 개발 스택 그림으로 설명
  • 디버깅 — depends_on 사이클·누락된 네트워크 등 구조 문제 빠르게 발견
  • Compose → K8s 마이그레이션 — 구조 매핑 전에 현재 구성 시각화 (짝 도구: K8s 시각화)
  • 프로덕션 운영자에게 데모 — 외부 의존성 (네트워크/볼륨/시크릿) 노출

자주 묻는 질문

Q.어떤 Compose 버전을 지원하나요?
A.Compose v2/v3+ (현재 표준). services / networks / volumes / configs / secrets top-level 키를 인식. v1 (top-level 이 서비스 이름) 은 지원 안 함 — 2018 년 이후 deprecated.
Q.왜 bind mount 는 그래프에 안 보이나요?
A../local:/path 같은 host bind mount 는 호스트 파일시스템 의존이지 Compose 리소스가 아닙니다. 그래프는 Compose 가 직접 관리하는 named volumes 만 표시 — 마이그레이션·다른 환경 이식의 핵심 자산이기 때문.
Q.Swarm 의 configs / secrets 도 지원되나요?
A.예. Compose v3 의 top-level configs / secrets 가 services 에서 참조되면 그래프 노드 + 엣지로 표시. Swarm mode 가 아니어도 일부 도구 (Podman, Kubernetes 변환) 가 같은 스펙을 사용합니다.
재미있는 사실

  • Docker Compose 의 전신은 Fig (2014, Orchard Labs). Docker Inc 가 2014 년 Orchard 인수 후 Fig 를 흡수해 docker-compose 로 rebrand. CLI 이름이 fig.yml → docker-compose.yml 로 바뀐 것은 그 흔적.

    Docker — Orchard 인수

  • Compose v1 (Python) 은 2014-2024 동안 운영. v2 (2021+) 는 Go 로 재작성 + Docker CLI plugin 으로 통합 — 그래서 명령이 'docker-compose' (하이픈) 가 아닌 'docker compose' (공백) 으로 변경. v1 은 2024 EOL.

    Compose v2 마이그레이션 가이드

  • Compose Spec 은 2020 년 Docker / Microsoft / AWS / Mirantis 공동 표준화. 같은 스펙을 Podman Compose · Kompose (→Kubernetes 변환) 등 다른 도구들도 사용 — docker-compose.yml 이 사실상 컨테이너 오케스트레이션의 lingua franca.

    Compose Spec

관련 가이드

관련 도구

이 카테고리 모든 도구 보기 →