Repolode
docker

docker/compose

단일 Compose 파일로 여러 컨테이너로 구성된 Docker 애플리케이션을 정의하고 실행하는 CLI 도구입니다.

스타
38,466
포크
5,883
열린 이슈
103
마지막 커밋
3일 전

어떤 프로젝트인가요?

Docker Compose를 사용하면 Compose 사양을 따르는 YAML 파일에 웹 서버, 데이터베이스, 캐시처럼 애플리케이션을 구성하는 컨테이너를 기술할 수 있습니다. `docker compose up`을 실행하면 모든 서비스를 한꺼번에 만들고 시작하므로, 여러 개의 `docker run` 명령을 따로 실행하는 대신 한 번의 명령으로 여러 서비스로 구성된 환경을 띄울 수 있습니다.

Compose 파일에서는 각 컨테이너를 어떻게 빌드하거나 가져올지, 어떤 포트와 볼륨을 사용할지, 서비스끼리 어떻게 연결할지를 정의합니다. 이 프로젝트는 Go로 작성되었으며 Docker CLI 플러그인으로 제공되므로 `docker compose` 명령을 일반 Docker CLI와 함께 사용할 수 있습니다. Windows 및 macOS용 Docker Desktop에 포함되어 있고, Linux용 독립 실행형 바이너리도 배포됩니다.

README에 따르면 이전 Python 버전은 v1 브랜치에 있으며, Docker Swarm은 Docker Inc. 외부에서 유지 관리되므로 더 이상 Compose 기능 업데이트를 받지 않습니다.

핵심 기능

  • 01Compose 사양을 따르는 단일 YAML 파일에 여러 컨테이너로 구성된 애플리케이션을 정의합니다.
  • 02`docker compose up` 같은 한 번의 명령으로 앱의 모든 서비스를 시작하고, 중지하고, 다시 빌드합니다.
  • 03각 서비스의 Dockerfile에서 이미지를 빌드하거나 레지스트리에서 이미지를 가져옵니다.
  • 04Windows, macOS, Linux에서 사용할 수 있으며 Docker Desktop에 포함되거나 독립 실행형 바이너리로 제공됩니다.

활용 사례

  • 개발자 노트북에서 웹 앱과 데이터베이스, 캐시를 함께 실행합니다.
  • 팀이 공유하는 Compose 파일로 재현 가능한 로컬 환경을 구성합니다.
  • 테스트 스위트를 실행하기 전에 통합 테스트에 필요한 의존 서비스를 띄웁니다.

빠른 시작

  1. 1

    Windows 또는 macOS에서는 Docker Desktop을 통해 Docker Compose를 설치하세요

  2. 2

    Linux에서는 릴리스 페이지에서 바이너리를 다운로드한 뒤 CLI plugins 폴더에 넣으세요

  3. 3

    compose.yaml 파일에 서비스를 정의한 다음 앱을 시작하세요

    docker compose up

사용 전 알아둘 점

  • Python 기반 v1 버전은 레거시 브랜치에서만 사용할 수 있습니다.
  • Docker Swarm 사용자는 Compose의 모든 기능을 이용하지 못할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

compose은(는) 무엇인가요?
단일 Compose 파일로 여러 컨테이너로 구성된 Docker 애플리케이션을 정의하고 실행하는 CLI 도구입니다. Docker Compose를 사용하면 Compose 사양을 따르는 YAML 파일에 웹 서버, 데이터베이스, 캐시처럼 애플리케이션을 구성하는 컨테이너를 기술할 수 있습니다. `docker compose up`을 실행하면 모든 서비스를 한꺼번에 만들고 시작하므로, 여러 개의 `docker run` 명령을 따로 실행하는 대신 한 번의 명령으로 여러 서비스로 구성된 환경을 띄울 수 있습니다.
compose은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
compose은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
compose은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. compose의 마지막 커밋은 2026년 10월 22일입니다.
compose은(는) 어디에 사용할 수 있나요?
개발자 노트북에서 웹 앱과 데이터베이스, 캐시를 함께 실행합니다. 팀이 공유하는 Compose 파일로 재현 가능한 로컬 환경을 구성합니다. 테스트 스위트를 실행하기 전에 통합 테스트에 필요한 의존 서비스를 띄웁니다.
compose는 어떻게 설치하나요?
Windows 또는 macOS에서는 Docker Desktop을 통해 Docker Compose를 설치하세요 Linux에서는 릴리스 페이지에서 바이너리를 다운로드한 뒤 CLI plugins 폴더에 넣으세요 compose.yaml 파일에 서비스를 정의한 다음 앱을 시작하세요: docker compose up
compose은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/docker/compose

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트