Docker Compose

Compose 파일 기반 컨테이너 정의

YAML 형식의 compose.yaml 파일에 서비스, 네트워크, 볼륨을 선언하여 애플리케이션을 구성합니다. 동일한 파일을 통해 여러 컨테이너 구성을 재현 가능한 형태로 관리할 수 있습니다.

단일 명령으로 다중 컨테이너 실행

docker compose up 명령 한 번으로 정의된 모든 컨테이너를 시작할 수 있습니다. docker compose down으로 정리하는 등 명령줄에서 다중 컨테이너의 라이프사이클을 제어합니다.

Docker Desktop과의 통합 제공

Windows와 macOS에서는 Docker Compose가 Docker Desktop에 기본 포함되어 별도 설치 없이 사용할 수 있습니다.

Windows에서 설치하기

Windows에서는 winget 패키지 관리자를 통해 설치할 수 있습니다. Docker Engine이 미리 설치되어 있어야 하며, 설치 명령은 winget install --id Docker.DockerCompose --exact입니다.

Linux에서 설치하기

GitHub release 페이지에서 바이너리를 다운로드한 뒤 파일 이름을 docker-compose로 변경하고 $HOME/.docker/cli-plugins에 복사하면 사용자 단위로 설치됩니다. 시스템 전역으로 설치하려면 /usr/local/lib/docker/cli-plugins, /usr/local/libexec/docker/cli-plugins, /usr/lib/docker/cli-plugins, /usr/libexec/docker/cli-plugins 중 한 경로에 복사하고 필요하면 chmod +x로 실행 권한을 부여합니다.

기본 사용 절차

• 애플리케이션 환경을 재현 가능하도록 Dockerfile을 작성합니다.
• 서비스들을 묶어 실행하기 위해 compose.yaml에 서비스를 정의합니다.
• docker compose up을 실행해 컨테이너들을 함께 시작합니다.

Compose 파일 예시

• web 서비스: 현재 디렉터리를 빌드하고 호스트 5000 포트를 컨테이너 5000 포트와 연결하며, 현재 디렉터리를 컨테이너의 /code 경로에 볼륨으로 마운트합니다.
• redis 서비스: 공개된 redis 이미지를 그대로 사용합니다.

활용 예시

Compose 파일 하나로 웹 서버와 데이터베이스처럼 서로 다른 역할을 하는 컨테이너를 묶어 정의하고, docker compose up 한 번으로 함께 실행하여 로컬 개발 환경을 빠르게 구성할 수 있습니다. 또한 Dockerfile과 함께 사용하면 정의된 동일한 환경을 다른 머신에서도 재현하여 실행할 수 있습니다.

지원 환경 및 요구사항

Windows에서는 winget을 통해 설치가 가능하며, 동작을 위해 Docker Engine이 사전에 설치되어 있어야 합니다. Windows와 macOS에서는 Docker Desktop에 Docker Compose가 포함되어 있어 별도 설치 없이 사용할 수 있습니다. Linux에서는 release 페이지 바이너리를 직접 다운로드해 CLI 플러그인 경로에 배치하여 설치합니다. 공식 패키지의 아키텍처 정보는 x64로 명시되어 있습니다.

버전 및 업데이트

현재 winget에 등록된 패키지 버전은 5.5.0이며, release_date는 2026-08-17입니다. GitHub 저장소의 최근 릴리스 노트에는 CI 워크플로 강화, CODEOWNERS 추가, buildkit·docker/cli 등 다수의 의존성 업데이트가 포함된 변경 이력이 기록되어 있습니다.

제한 및 라이선스

• Docker Compose는 명령줄 인터페이스(CLI)로 동작하는 플러그인이며, 별도의 그래픽 사용자 인터페이스는 제공되지 않습니다.
• Docker Engine이 사전에 설치되어 있어야 동작합니다.
• 라이선스는 Apache-2.0이며, 자세한 내용은 GitHub 저장소의 LICENSE 파일을 통해 확인할 수 있습니다.