• Docker Compose
• Key features of Docker Compose
  • 단일 호스트에 여러 개의 격리된 환경
  • 컨테이너 생성 시 볼륨 데이터 보존
  • 변경된 컨테이너만 재생성
  • 변수 지원 및 환경 간 컴포지션 이동
• The Compose application model
  • example
• Docker Compose 문법
  • version
  • image
  • build
    • context, dockerfile
    • args
  • environment, env_file
  • networks
    • 사용자 정의 네트워크 지정
  • ports
  • expose

Docker Compose

Docker Compose란, 다중 컨테이너 Docker 애플리케이션을 정의하고 실행하기 위한 도구이다. Compose에서는 YAML 파일을 사용하여 애플리케이션 서비스를 구성한다. 그런 다음에 단일 명령으로 모든 서비스를 만들고 시작한다.

Compose를 사용하기 위해 기본적으로 3단계를 거친다.

1. 어디에서나 재현할 수 있도록 Dockerfile으로 애플리케이션의 환경을 정의한다.
2. 격리된 환경에서 함께 실행할 수 있도록 docker-compose.yml에서 앱을 구성하는 서비스를 정의한다.
3. docker compose up을 실행하면 Docker compose command가 전체 앱을 시작하고 실행한다.

docker-compose.yml 파일은 다음과 같다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
version: "3.9"  # optional since v1.27.0
services:
  web:
    build: .
    ports:
      - "8000:5000"
    volumes:
      - .:/code
      - logvolume01:/var/log
    depends_on:
      - redis
  redis:
    image: redis
volumes:
  logvolume01: {}

Compose 파일에 대한 자세한 내용은 다음을 참조하면 된다.
Compose file reference

Key features of Docker Compose

단일 호스트에 여러 개의 격리된 환경

Compose는 프로젝트 이름을 사용하여 환경을 서로 격리한다. 여러 다른 컨텍스트에서 이 프로젝트 이름을 사용할 수 있다.

• 프로젝트의 각 기능 분기에 대한 안정적인 복사본을 실행하려는 경우처럼 개발 호스트에서 단일 환경의 여러 복사본을 만들기 위해 사용한다.
• CI 서버에서 빌드가 서로 간섭하지 않도록 프로젝트 이름을 고유한 빌드 번호로 설정할 수 있다.
• 공유 호스트 또는 개발 호스트에서 동일한 서비스 이름을 사용할 수 있는 서로 다른 프로젝트가 서로 간섭하지 않도록 한다.

컨테이너 생성 시 볼륨 데이터 보존

Compose는 서비스에서 사용하는 모든 볼륨을 보존한다. 실행 시 이전 컨테이너에서 새 컨테이너로 볼륨을 복사하여 볼륨에서 만든 모든 데이터가 손실되지 않도록 한다.

변경된 컨테이너만 재생성

Compose는 컨테이너를 만드는 데 사용되는 구성을 캐시한다. 변경되지 않은 서비스를 다시 시작하면 Compose는 기존 컨테이너를 재사용한다.

변수 지원 및 환경 간 컴포지션 이동

Compose는 Compose 파일의 변수를 지원한다. 이러한 변수를 사용하여 다양한 환경 또는 다양한 사용자에 맞게 구성을 사용자 지정할 수 있다.

The Compose application model

참조 : https://docs.docker.com/compose/compose-file/

Compose 사양를 사용하면 플랫폼에 구애받지 않는 컨테이너 기반 애플리케이션을 정의할 수 있다. 애플리케이션은 적절한 공유 리소스 및 통신 채널과 함께 실행되어야 하는 컨테이너 집합으로 설계된다.

애플리케이션의 구성 요소는 services로 정의된다. services는 동일한 컨테이너 이미지를 한 번 이상 실행하여 플랫폼에서 구현되는 추상적인 개념이다.

services는 networks를 통해 서로 통신한다. networks는 함께 연결된 services 내의 컨테이너 간에 IP 경로를 설정하기 위한 플랫폼 기능 추상화이다.

services는 영구 데이터를 volumes에 저장하고 공유한다. volumes은 전역 옵션이 있는 상위 수준 파일 시스템 마운트와 같은 영구 데이터를 설명한다.

example

다음 예제는 프런트엔드 웹 애플리케이션과 백엔드 서비스로 분할된 애플리케이션이다.
프런트엔드는 런타임에 인프라에서 관리하는 HTTP configuration 파일로 구성되어 외부 도메인 이름과 플랫폼의 보안 비밀 저장소에 삽입된 HTTPS server certificate를 제공한다.
백엔드는 persistent volume에 데이터를 저장한다.
두 서비스 모두 격리된 백티어 네트워크에서 서로 통신하지만 프런트엔드는 프런트 네트워크에 연결되어 외부 사용을 위해 포트 443을 노출한다.

1
2
3
4
5
6
7
8
9
10
11
12
13
(External user) --> 443 [frontend network]
                            |
                  +--------------------+
                  |  frontend service  |...ro...<HTTP configuration>
                  |      "webapp"      |...ro...<server certificate> #secured
                  +--------------------+
                            |
                        [backend network]
                            |
                  +--------------------+
                  |  backend service   |  r+w   ___________________
                  |     "database"     |=======( persistent volume )
                  +--------------------+        \_________________/

예제 애플리케이션은 다음으로 구성된다.

• Docker Image로 지원되는 2개의 services: webapp, database
• 프런트엔트에 주입된 1개의 secured
• 프런트엔트에 삽입된 1개의 configs
• 백엔드에 연결된 1개의 영구 volumes
• 2개의 networks

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
services:
  frontend:
    image: awesome/webapp
    ports:
      - "443:8043"
    networks:
      - front-tier
      - back-tier
    configs:
      - httpd-config
    secrets:
      - server-certificate

  backend:
    image: awesome/database
    volumes:
      - db-data:/etc/data
    networks:
      - back-tier

volumes:
  db-data:
    driver: flocker
    driver_opts:
      size: "10GiB"

configs:
  httpd-config:
    external: true

secrets:
  server-certificate:
    external: true

networks:
  # The presence of these objects is sufficient to define them
  front-tier: {}
  back-tier: {}

Docker Compose 문법

version

docker-compose는 버전에 따라 차이가 있기 때문에 버전을 정의하는 것이 좋다.

1
version: "3"

image

서비스의 베이스 이미지를 지정한다. 베이스 이미지가 로컬 환경에 없다면 Docker hub에서 다운로드하여 베이스 이미지로 사용된다.

1
2
3
services:
    web:
        image: centos:7

build

베이스 이미지를 생성하는 Dockerfile을 지정한다. 자동으로 Dockerfile을 빌드하여 베이스 이미지를 만들고 컨테이너를 실행한다.

1
2
3
4
# docker-compose.yaml
services:
    web:
        build: .

1
2
# Dockerfile
FROM centos:7

context, dockerfile

만약에 Dockerfile의 경로나 이름이 다른 경우에는 지정할 수 있다.

• context : Dockerfile의 위치
• dockerfile : Dockerfile의 이름

1
2
3
4
5
services:
    web:
        build:
            context: /src
            dockerfile: Dockerfile-web

args

인수를 지정하여 Dockerfile에 값을 넣을 수 있다.

1
2
3
4
5
6
7
8
# docker-compose.yaml
version: "3"
services:
    web:
        build:
            context: .
            args:
                number: 1

1
2
3
4
5
# dockerfile
FROM centos: 7

ARG number
RUN echo "$number"

environment, env_file

파일을 읽어서 컨테이너의 환경 변수를 지정할 수 있다.

1
2
3
4
5
6
7
8
# docker-compose.yaml
version: "3"
services:
    web:
        build: .
        environment:
            NUMBER : 7
            SHOW : "true"

1
2
3
4
5
6
# docker-compose.yaml
version: "3"
services:
    web:
        build: .
        env_file: .env

networks

Docker Compose는 여러 개의 컨테이너로 구성된 애플리케이션을 관리하기 위한 오케스트레이션 도구이다. 기본적으로 Docker Compose는 하나의 기본 네트워크에 모든 컨테이너를 연결한다. 기본 네트워크 이름은 docker-compose.yml 파일이 위치한 디렉토리 이름 뒤에 _default가 붙는다. docker network ls 명령어로 기본 네트워크를 확인할 수 있다.

사용자 정의 네트워크 지정

docker-compose.yml 파일에 networks 항목에 새로운 네트워크를 명시하여 컨테이너를 연결할 수 있다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
services:
  web:
    build: .
    ports:
      - "8000:8000"
    networks:
      - new-net
  db:
    image: postgres
    ports:
      - "8001:5432"
networks:
  new-net:
    driver: bridge

ports

service의 ports에 “host:container” 또는 “container”로 명시하여 호스트 포트와 컨테이너 포트를 구분하는 것이 중요하다. container 포트는 서비스 네트워크를 위해 사용되고, host 포트가 정의되면 외부에서도 서비스에 접근할 수 있다.

expose

expose는 host OS에 포트를 공개하지 않고, 컨테이너에만 포트를 공개한다. host OS와 직접 연결되지 않고, 링크 등으로 연결된 컨테이너 간의 통신이 필요한 경우에 사용된다.