docker compose

docker compose

docker compose는 다중 컨테이너 앱을 정의하고 실행하는 Compose 명령이에요. docker-compose.yml 파일을 바탕으로 서비스들을 한 번에 관리해요.

출처: 문서

본문

docker compose는 Compose 파일로 정의한 여러 서비스를 빌드·실행·관리하는 상위 명령이에요. up, down, logs, exec 등 수많은 하위 명령을 제공해요.

지원하는 옵션은 다음과 같아요.

옵션 기본값 설명
--all-resources 사용하지 않는 리소스까지 모두 포함해요
--ansi auto ANSI 제어 문자를 출력할 시점을 정해요
--compatibility Compose를 하위 호환 모드로 실행해요
--dry-run 푸시 대신 최종 이미지를 보여줘요
--env-file 환경 변수 파일을 읽어요
-f, --file 빌드 정의 파일
--parallel -1 최대 병렬 처리를 제어해요 (무제한은 -1)
--profile 활성화할 프로필을 지정해요
--progress 진행 출력 유형을 설정해요 (auto, none, plain, quiet, rawjson, tty)
--project-directory 대체 작업 디렉터리를 지정해요
-p, --project-name 프로젝트 이름

Use -f to specify the name and path of one or more Compose files

-f로 하나 이상의 Compose 파일 이름·경로를 지정할 수 있어요.

$ docker compose -f docker-compose.yml -f docker-compose.prod.yml up

Use -p to specify a project name

-p로 프로젝트 이름을 지정해요.

$ docker compose -p myproject up

Use profiles to enable optional services

--profile로 선택적 서비스를 활성화해요.

$ docker compose --profile debug up

Configuring parallelism

--parallel로 병렬 실행을 구성할 수 있어요.

Set up environment variables

환경 변수를 설정해 Compose 파일의 변수를 치환할 수 있어요.

Use Dry Run mode to test your command

Dry Run 모드로 명령을 실제로 적용하지 않고 시험해 볼 수 있어요.

$ docker compose --dry-run up

사용할 수 있는 하위 명령은 다음과 같아요.

명령 설명
docker compose alpha scale Scale services
docker compose bridge Convert compose files into another model
docker compose build Build or rebuild services
docker compose commit Create a new image from a service container's changes
docker compose config Parse, resolve and render compose file in canonical format
docker compose convert Converts the compose file to platform's canonical format
docker compose cp Copy files/folders between a service container and the local filesystem
docker compose create Creates containers for a service
docker compose down Stop and remove containers, networks
docker compose events Receive real time events from containers
docker compose exec Execute a command in a running container
docker compose export Export a service container's filesystem as a tar archive
docker compose images List images used by the created containers
docker compose kill Force stop service containers
docker compose logs View output from containers
docker compose ls List running compose projects
docker compose pause Pause services
docker compose port Print the public port for a port binding
docker compose ps List containers
docker compose publish Publish compose application
docker compose pull Pull service images
docker compose push Push service images
docker compose restart Restart service containers
docker compose rm Removes stopped service containers
docker compose run Run a one-off command on a service
docker compose scale Scale services
docker compose start Start services
docker compose stats Display a live stream of container(s) resource usage statistics
docker compose stop Stop services
docker compose top Display the running processes
docker compose unpause Unpause services
docker compose up Create and start containers
docker compose version Show the Docker Compose version information
docker compose volumes List volumes
docker compose wait Block until containers of all (or specified) services stop.

더 알아보기