Docker Compose

Docker Compose란?

Docker Compose란 단일 서버에서 여러개의 컨테이너를 하나의 서비스로 정의해 컨테이너의 묶음으로 관리할 수 있는 작업 환경을 제공하는 관리 도구이다.

Docker Compose에서는 compose 파일을 준비해서 커맨드를 1회 실행하는 것으로 그 파일로부터 설정을 읽어들여 모든 컨테이너 서비스를 실행시키는 것이 가능하다.

Docker Compose를 사용하는 이유

여러 개의 컨테이너가 하나의 어플리케이션으로 동작할 때 Docker Compose를 사용하지 않는다면, 이를 테스트 하기 위해 각 컨테이너를 하나씩 생성해야 한다.

예를 들면, 웹 어플리케이션을 테스트하려면 웹 서버 컨테이너, 데이터베이스 컨테이너 두 개의 컨테이너를 각각 생성해야 한다.

$ docker run --name wordpress_db -d mysql:8

$ docker run -d -p 8080:80 \
--link wordpress_db:mysql --name seunghwan_wordpress \
wordpress:latest
Shell
복사

위의 예제를 실행하면 wordpress와 mysql 컨테이너를 생성한다.

이처럼 여러 개의 컨테이너로 구성된 어플리케이션을 구축하기 위해 run 명령어를 여러 번 사용할 수 있지만 각 컨테이너가 제대로 동작하는지 확인하는 테스트 단계에서는 이런식으로 일일히 여러개의 컨테이너를 실행하기는 번거롭다.

매번 run 명령어에 옵션을 설정해 CLI로 컨테이너를 생성하기보다는 여러 개의 컨테이너를 하나의 서비스로 정리해 컨테이너 묶음으로 관리할 수 있다면 좀 더 편리할 것입니다.

이를 위해 도커 컴포즈(Docker Compose)는 컨테이너를 이용한 서비스의 개발과 CI를 위해 여러 개의 컨테이너를 하나의 프로젝트로서 다룰 수 있는 작업 환경을 제공한다.

Docker Compose의 구조

Docker Compose는 시스템 구축에 필요한 설정을 YAML 포맷으로 기재한 정의 파일을 이용해 전체 시스템을 일괄 실행(run) 또는 일괄 종료 및 삭제(down) 할 수 있다.

YAML 파일에는 컨테이너나 볼륨을 ‘어떠한 설정으로 만들지’에 대한 항목이 기재되어 있다.

up 커맨드

•

docker run 커맨드와 비슷

•

정의 파일에 기재된 내용대로 이미지를 내려받고 컨테이너를 생성 및 실행

•

정의 파일에는 네트워크나 볼륨에 대한 정의도 기재할 수 있어서 주변 환경을 한꺼번에 생성할 수 있음

down 커맨드

•

컨테이너와 네트워크를 정지 및 삭제

•

볼륨과 이미지는 삭제

•

컨테이너와 네트워크 삭제 없이 종료만 하고 싶다면 stop 커맨드를 사용

이외에도 각 컨테이너의 의존성, 네트워크, 볼륨 등을 함께 정의할 수 있다.

YAML

•

다수의 Container로 소프트웨어가 구성되는 경우 사용할 수 있는 툴 + 환경 설정 파일(yml or yaml)

◦

docker-compose.yml로 설정

◦

여기서 다양한 테스트들도 수행 가능

◦

다양한 버전을 만드는 것도 일반적 (dev, test, prod 등등)

▪

ex) docker-compose.dev.yml

•

개별 Container를 따로 관리하는 것보다 훨씬 더 생산성이 높음

•

사용법 자체는 간단 : 소프트웨어를 구성하는 모든 컨테이너에게 적용됨

$ docker-compose build
$ docker-compose up # -> pull + build + run 
$ docker-compose pull
$ docker-compose ps
$ docker-compose down
$ docker-compose start
$ docker-compose stop
$ docker-compose rm
Shell
복사

docker-compose.yml 작성 및 활용

Wordpress 사이트

워드프레스는 웹 사이트를 만들기 위한 소프트웨어로, 서버에 설치해서 사용한다.

워드프레스 컨테이너와 MySQL 컨테이너로 구성되며, 워드프레스는 간단히 말해 블로그 생성 도구와 같은 것으로, 웹 사이트 작성자가 작성한 내용을 데이터베이스에 저장하고, 웹 사이트 열람자의 요청에 따라 웹 페이지를 보여준다. 즉, 프로그램이 MySQL에 저장된 데이터를 읽고 쓸 수 있어야 하기 때문에 두 컨테이너가 연결되어 있어야 한다.

MySQL, Wordpress 컨테이너 생성 시 필요한 옵션과 인자

•

MySQL

docker run --name 컨테이너_이름 -dit --net=네트워크_이름 -e MYSQL_ROOT_PASSWORD=MySQL_루트_패스워드 -e MYSQL_DATABASE=데이터베이스_이름 -e MYSQL_USER=MySQL_사용자이름 -e MYSQL_PASSWORD=MySQL_패스워드 mysql --character-set-server=문자_인코딩 --collation-server=정렬_순서 --default-authentication-plugin=인증_방식
Shell
복사

•

Wordpress

docker run --name 컨테이너_이름 -dit --net=네트워크_이름 -p 포트_설정 -e WORDPRESS_DB_HOST=데이터베이스_컨테이너_이름 -e WORDPRESS_DB_NAME=데이터베이스_이름 -e WORDPRESS_DB_USER=데이터베이스_사용자이름 -e WORDPRESS_DB_PASSWORD=데이터베이스_패스워드 wordpress
Shell
복사

docker run 명령어로 컨테이너 생성

docker run -d --name wordpress_db \
	--network geonoo_network \
	-p 3306:3306 \
	-e MYSQL_ROOT_PASSWORD=y3787 \
	-e MYSQL_DATABASE=y3787 \
	-e MYSQL_USER=y3787 \
	-e MYSQL_PASSWORD=y3787 \
	-v mysql:/var/lib/mysql \
	--restart unless-stopped \
	mysql:8
Shell
복사

docker run -d --name geonoo_wordpress \
	--network geonoo_network \
	-p 8080:80 \
	--link wordpress_db:mysql \
	-e WORDPRESS_DB_HOST=db:3306 \
	-e WORDPRESS_DB_NAME=y3787 \
	-e WORDPRESS_DB_USER=y3787 \
	-e WORDPRESS_DB_PASSWORD=y3787 \
	--restart unless-stopped \
	wordpress:latest
Shell
복사

yaml 파일로 변경

version: '3.9'

services:
  db:
    image: mysql:8
    volumes:
    - db:/var/lib/mysql
    restart: unless-stopped
    environment:
    - MYSQL_ROOT_PASSWORD=seosh817
    - MYSQL_DATABASE=seosh817
    - MYSQL_USER=seosh817
    - MYSQL_PASSWORD=seosh817
    networks:
    - wordpress

  wordpress:
    depends_on:
    - db
    image: wordpress:latest
    ports:
    - "8000:80"
    restart: unless-stopped
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: seosh817
      WORDPRESS_DB_PASSWORD: seosh817
      WORDPRESS_DB_NAME: seosh817
    networks:
    - wordpress

volumes:
  db: {}

networks:
  wordpress: {}
YAML
복사

위의 docker-compose.yml 파일을 보면 서비스로 db, wordpress 두개가 존재한다.

그리고 볼륨으로 db, 네트워크로 wordpress를 생성하고 서비스에서 해당 볼륨과 네트워크를 사용하는 구조로 되어있다.

어떠한 설정도 하지 않으면 도커 컴포즈는 현재 디렉토리의 docker-compose.yml 파일을 읽어 로컬의 도커 엔진에게 컨테이너 생성을 요청한다. docker compse up 명령어로 도커 컴포즈 프로젝트를 실행할 수 있다.

docker-compose up -d
YAML
복사

컴포즈 파일(YAML 형식)의 작성 요령 - 첫 줄에 도커 컴포즈 버전을 기재 - 주 항목 services, networks, volumes 아래에 설정 내용을 기재 - 항목 간의 상하 관계는 공백을 사용한 들여쓰기로 나타낸다. - 들여쓰기는 같은 수의 배수만큼의 공백을 사용한다. - 이름은 주 항목 아래에 들여쓰기한 다음 기재한다. - 컨테이너 설정 내용은 이름 아래에 들여쓰기한 다음 기재한다. - 여러 항목을 기재하려면 줄 앞에 ‘-’을 붙인다. - 이름 뒤에는 콜론(:)을 붙인다. - 콜론 뒤에는 반드시 공백이 와야 한다.(바로 줄바꿈하는 경우는 예외) - # 뒤의 내용은 주석으로 간주된다. - 문자열은 작은따옴표(’) 또는 큰따옴표(”)로 감싸 작성한다.

컴포즈 파일의 항목

•

주 항목

항목	내용
services	컨테이너를 정의한다.
networks	네트워크를 정의한다.
volumes	볼륨을 정의한다.

•

자주 나오는 정의 내용

항목	docker run 커맨드의 해당 옵션 또는 인자	내용
images	이미지 인자	사용할 이미지를 지정
networks	—net	접속할 네트워크를 지정
volumes	-v, —mount	스토리지 마운트를 설정
ports	-p	포트 설정
environment	-e	환경변수 설정
depends_on	없음	다른 서비스에 대한 의존관계를 정의
restart	없음	컨테이너 종료 시 재시작 여부를 설정

example-voting-app

Docker에서 공식적으로 제공하는 예제 샘플

example-voting-app

dockersamples

•

아키텍처 설명

◦

두 옵션 사이에서 투표할 수 있도록 하는 Python 프론트엔드 웹 앱

◦

새로운 투표를 수집하는 Redis

◦

투표를 Consume하고 도트넷(.NET) 워커에서 저장하는 .NET Worker

◦

도커 볼륨에 의해 지원되는 Postgres 데이터베이스

◦

실시간으로 투표 결과를 보여주는 Node.js 웹 앱

git clone https://github.com/Y-gw/example-voting-app.git

먼저 기존 방식대로 매뉴얼하게 하나씩 빌드해보자.

•

이미지 빌드

$ docker build -t vote ./vote
$ docker build -t result ./result
$ docker build -t worker ./worker
Shell
복사

•

컨테이너 실행

# detached 모드로 위의 컨테이너들을 실행
$ docker run -d --name=redis redis
$ docker run -d -e POSTGRES_PASSWORD=postgres --name=db postgres
$ docker run -d --name=vote -p 5001:80 vote
$ docker run -d --name=result -p 5002:80 result
$ docker run -d --name=worker worker
Shell
복사

•

network 통신 확인

## vote(python app) container로 들어가서 redis와의 통신을 ping을 통해 확인
$ docker exec -it --user root vote sh
$ apt-get update && apt update
$ apt install -y iputils-ping
$ ping redis
>> ping: cannot resolve redis: Unknown host
Shell
복사

•

docker images

◦

redis와 postgres는 공식 이미지들이라 빌드할 필요가 없다.

•

위와 같이 이렇게 내가 일일히 하나씩 실행하면 동작할까?

◦

각 컴포넌트들 간의 네트워크 연결이 안되고 있음!

◦

컨테이너 간 통신이 안되고 있음을 ping을 통해 확인 가능하다 

•

네트워크 issue 세부 정보

◦

python app에서는 아래와 같이 redis를 호출해서 인스턴스를 가져온다.

◦

vote/app.py

def get_redis():
		"""
    Redis 인스턴스를 가져오는 함수이다.

    이 함수는 Flask의 g 객체를 사용하여 Redis 인스턴스를 싱글톤으로 관리한다.
    싱글톤 패턴을 사용하여 한 번의 요청에 대해 동일한 Redis 인스턴스를 계속 사용한다.

    Returns:
        Redis: Redis - 클라이언트 인스턴스를 반환한다.

    Raises:
        ConnectionError: Redis - 서버에 연결할 수 없는 경우 발생한다.
        TimeoutError: Redis - 서버와의 연결이 시간 초과되는 경우 발생한다.
		"""
				
    if not hasattr(g, 'redis'):
				# g 객체에 Redis 인스턴스가 없는 경우에만 Redis 클라이언트를 생성한다.
        # host는 "redis"로 설정되어 있으며, db는 0으로 설정되어 있다.
        # socket_timeout은 연결 시도 시간을 5초로 설정한다.
        g.redis = Redis(host="redis", db=0, socket_timeout=5)
    return g.redis
Python
복사

◦

result/server.js

var pool = new pg.Pool({
	connectionString:
	'postgres://postgres:postgres@db/postgres'
});
JavaScript
복사

postgres 연결시 postgres:postgres를 사용하고 있음을 주의깊게 볼 것!

@ 다음에 오는 이름은 컨테이너 이름

→ Docker Compose 파일에서 db라는 이름으로 PostgreSQL 컨테이너를 정의

◦

worker/Program.cs

var pgsql = OpenDbConnection("Server=db;Username=postgres;Password=postgres;");
var redisConn = OpenRedisConnection("redis");
C#
복사

worker에서는 postgresql과 redis를 동시에 통신

이 부분에서 서로의 존재를 몰라 에러가 발생 → 통신 X

네트워크 issue 해결방법

•

docker의 network 기능 사용

◦

전에는 docker run의 link 옵션을 사용

•

network를 하나 만들고 모든 컨테이너들을 이 네트워크 안으로 지정

◦

연결 상황에 따라 별개의 네트워크를 만들고 사용도 가능함

▪

아래에서는 2가지 네트워크를 통해 컨테이너들 간 통신 그룹을 만들 예정

▪

back-tier

▪

front-tier

◦

매뉴얼 예제에서는 mynetwork 라는 네트워크를 하나 만들고 진행 예정

docker network create

다시 전체 과정을 실행해보자.

•

이미지 빌드

$ docker build -t vote ./vote
$ docker build -t result ./result
$ docker build -t worker ./worker
Shell
복사

•

컨테이너 정리

# 만약 중요한 것이 없다면 아래와 같이 수행
$ docker container rm -f $(docker container ls -aq)

# 중요한 컨테이너가 있을 경우
$ docker ps
$ docker stop {컨테이너 id}
$ docker rm {컨테이너 id}
Shell
복사

•

네트워크 생성

$ docker network create mynetwork
Shell
복사

•

컨테이너 실행 (--network 태그 지정)

$ docker run -d --name=redis --network mynetwork redis
# password 설정과 함께 docker run
$ docker run -d --name=db -e POSTGRES_PASSWORD=password --network mynetwork postgres

$ docker run -d --name=vote -p 5001:80 --network mynetwork vote

$ docker run -d --name=result -p 5002:80 --network mynetwork result

$ docker run -d --name=worker --network mynetwork worker
Shell
복사

•

redis와 통신 확인

$ docker exec -it --user root vote sh
$ apt-get update && apt update && apt install -y iputils-ping
$ apt install -y iputils-ping

$ ping redis

# ping redis -> 아래와 같이 통신이 되는 것을 확인 가능!
PING redis (172.22.0.2) 56(84) bytes of data.
64 bytes from redis.mynetwork (172.22.0.2): icmp_seq=1 ttl=64 time=0.934 ms
64 bytes from redis.mynetwork (172.22.0.2): icmp_seq=2 ttl=64 time=0.099 ms
64 bytes from redis.mynetwork (172.22.0.2): icmp_seq=3 ttl=64 time=0.135 ms
64 bytes from redis.mynetwork (172.22.0.2): icmp_seq=4 ttl=64 time=0.079 ms
64 bytes from redis.mynetwork (172.22.0.2): icmp_seq=5 ttl=64 time=0.252 ms
64 bytes from redis.mynetwork (172.22.0.2): icmp_seq=6 ttl=64 time=0.235 ms
Shell
복사

Docker compose를 통한 실행

앞서 5개의 Container를 일일히 실행했을 때의 문제점

•

Postgres를 실행하는 부분이 제대로 동작하지 않았음

# $ ping db
PING db (192.168.107.3) 56(84) bytes of data.
64 bytes from db.mynetwork (192.168.107.3): icmp_seq=1 ttl=64 time=0.183 ms
64 bytes from db.mynetwork (192.168.107.3): icmp_seq=2 ttl=64 time=0.048 ms
64 bytes from db.mynetwork (192.168.107.3): icmp_seq=3 ttl=64 time=0.055 ms

# 응? 통신은 되는데..?
Shell
복사

◦

이는 Postgres 컨테이너를 실행할 때 적절한 환경 변수를 지정하지 않아 발생한 문제.

◦

Worker 컨테이너 내에서 OpenDbConnection 함수를 호출할 때, Postgres 서버와의 연결 정보가 잘못 설정되었기 때문에 동작하지 않았음.

◦

docker run -d --name=db -e POSTGRES_PASSWORD=password --network mynetwork postgres

◦

worker/Program.cs

var pgsql = OpenDbConnection("Server=db;Username=postgres;Password=postgres;");
var redisConn = OpenRedisConnection("redis");
C#
복사

•

이를 해결하려면 Container를 실행할 때 아래 2개의 환경변수를 넘겨주어야 함

◦

POSTGRES_USER: "postgres"

◦

POSTGRES_PASSWORD: "postgres"

→ 이걸 docker-compose 환경 설정 파일을 통해 넘기면서 해결해볼 예정

docker-compose.yml로 포팅

•

앞서 컨테이너를 하나씩 실행할 때 네트워킹 부분은 제대로 동작하지 않았음.

•

docker volume이란?

◦

Docker volume은 Docker 컨테이너가 데이터를 저장하거나 공유하기 위한 방법. 

◦

컨테이너는 기본적으로 독립적인 파일 시스템을 가지고 있으며, 컨테이너가 삭제되면 그 안의 데이터도 함께 삭제된다. 그러나 Docker volume을 사용하면 컨테이너의 데이터를 호스트 머신의 파일 시스템에 영구적으로 저장하고 유지할 수 있다.

•

services 키 보기

•

docker-compose.mac.yml

# v2 and v3 are now combined!
# docker-compose v1.27+ required
# % docker-compose version
# Docker Compose version v2.15.1
services:
  vote:
    build: ./vote
    # use python rather than gunicorn for local dev
    command: python app.py
    ports:
      - "5001:80"

  result:
    build: ./result
    # use nodemon rather than node for local dev
    entrypoint: nodemon server.js
    ports:
      - "5002:80"

  worker:
    build: ./worker

  redis:
    image: redis:alpine

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: "postgres"
      POSTGRES_PASSWORD: "postgres"
YAML
복사

•

Demo

## 먼저 청소 한 번 하기
$ docker container rm -f $(docker container ls -aq)
# docker image rm -f $(docker image ls -q)

## 확인해보기
$ docker ps -a
$ docker images

## 그리고 나서 앞의 docker-compose.mac.yml의 내용을 바탕으로 실행해보기
$ docker-compose -f docker-compose.mac.yml build
$ docker-compose -f docker-compose.mac.yml up -d

## db 컨테이너 접속
docker exec -it --user=postgres example-voting-app-db-1 sh

/ $ whoami
postgres
/ $ psql
psql (15.4)
Type "help" for help.

## \c: Connect to database
postgres=# \c
You are now connected to database "postgres" as user "postgres".

## \dt: List tables
postgres=# \dt
         List of relations
 Schema | Name  | Type  |  Owner   
--------+-------+-------+----------
 public | votes | table | postgres
(1 row)

postgres=# select * from votes;
       id        | vote 
-----------------+------
 cb9d5ad7206be28 | a
(1 row)

exit

$ docker-compose -f docker-compose.mac.yml down
>> ✔ Container example-voting-app-worker-1  Removed                                                                                                                                                     0.6s 
✔ Container example-voting-app-db-1      Removed                                                                                                                                                     0.8s 
✔ Container example-voting-app-vote-1    Removed                                                                                                                                                     1.0s 
✔ Container example-voting-app-result-1  Removed                                                                                                                                                     0.7s 
✔ Container example-voting-app-redis-1   Removed                                                                                                                                                     0.9s 
✔ Network example-voting-app_default     Removed
Shell
복사

네트워크 정의를 통한 docker-compose 개선

•

모든 네트워크를 다 통일 시키는 것은 바람직 하지 않다.

◦

네트워크를 논리적으로 분리시켜주는 것이 애플리케이션의 보안성, 확장성, 유연성 및 서비스 분리 측면에서 더 바람직

◦

예시 : 백엔드 내 앞 로직, 백 로직

•

docker-compose.yml로 포팅: networks 정의

◦

front tier : 사용자에게 노출

◦

back tier : 사용자에게 노출X

◦

이를 통한 network isolation. 혹시라도 생길 수 있는 문제 차단

격리(Isolation): 각 서비스를 네트워크로 분리함으로써, 서로 다른 서비스 간의 네트워크 격리를 구현할 수 있습니다. 이는 각 서비스의 보안을 강화하고, 한 서비스의 장애나 과부하가 다른 서비스에 영향을 미치는 것을 방지할 수 있습니다.

세분화(Segmentation): 네트워크를 back-tier와 front-tier로 분리함으로써, 백엔드 서비스와 프론트엔드 서비스를 구분할 수 있습니다. 백엔드 서비스는 내부 네트워크(back-tier)에 속하고, 프론트엔드 서비스는 내부 및 외부 네트워크(front-tier)에 속합니다. 이는 보안을 강화하고, 외부로부터의 직접적인 액세스를 제한하여 안전한 서비스 구축을 돕습니다.

docker-compose.yml로 포팅: services들에 네트워크 지정

•

기존

services:
 redis:
 image: redis:alpine
 db:
 image: postgres:15-alpine
 vote:
 build: ./vote
 ports:
 - 5001:80
 result:
 build: ./result
 ports:
 - 5002:80
 worker:
 build: ./worker
YAML
복사

•

변경 

services:
 redis:
	 …
	 networks:
	 - back-tier
 db:
	 …
	 networks:
	 - back-tier
 vote:
	 …
	 networks:
	 - back-tier
	 - front-tier
 result:
	 …
	 networks:
	 - back-tier
	 - front-tier
 worker:
	 …
	 networks:
	 - back-tier

networks:
 back-tier:
 front-tier:
YAML
복사

docker-compose.yml로 포팅: volumes 정의

•

어느 컨테이너 서비스의 데이터가 계속해서 저장되어야 하는가?

◦

PostgreSQL

•

db의 내용이 persistent해야함 ⇒ 볼륨 생성 (네임드 볼륨)

volumes:
	db-data:
YAML
복사

•

docker-compose.yml로 포팅: services들에 볼륨 지정

services:
 redis:
	 db:
 vote:
 result:
 worker:
YAML
복사

services:
 redis:
	# db 데이터가 저장되는 컨테이너 내부 디렉토리 장소와 네임드 볼륨을 매핑
	 db:
	 volumes:
	 - db-data:/var/lib/postgresql/data
 vote:
 result:
 worker:

volumes:
 db-data:
YAML
복사

docker-compose.yml로 포팅: vote 서비스 개선

•

depends_on : 서비스들간의 의존성이 있을 경우, 먼저 실행되어야 하는 서비스들을 여기 기술해야한다.

◦

더 나아가서 해당 서비스의 health check도 포함해줌

•

healthcheck : 해당 서비스의 건강을 나타내주는 체크를 기술

•

docker-compose.yml의 command와 entrypoint

◦

command: 이미지 Dockerfile의 CMD를 덮어쓰는데 사용

◦

entrypoint: 이미지 Dockerfile의 ENTRYPOINT를 덮어쓰는데 사용

•

docker-compose.yml의 healthcheck

◦

역시 Dockerfile에서 기술 가능한 기능이며 docker-compose에서 아래와 같이 덮어쓰기 가능

healthcheck:
 test: ["CMD", "curl", "-f", "http://localhost"] 
	# 0 for success 1 for failure
 interval: 1m30s
 timeout: 10s # 실행 시간 10초 넘어가면 fail
 retries: 3
 start_period: 40s
Docker
복사

•

docker-compose.yml의 depends_on

◦

해당 서비스가 실행되기 위해서 먼저 실행되어야 하는 서비스들을 여기 기술

▪

short form:

depends_on:
- db
- redis
YAML
복사

▪

long form:

depends_on:
	db:
		condition: service_healthy
	redis:
		condition: service_started
YAML
복사

depends_on의 condition으로 가능한 값

▪

service_started:

•

컨테이너가 시작되었는지 여부

▪

service_healthy:

•

의존성이 건강 상태를 나타내는 healthcheck에 따라 시작 전에 "건강"한 상태인지 확인.

•

True or False ⇒ 0 for success 1 for failure

▪

service_completed_successfully:

•

의존성에 종속된 서비스가 성공적으로 완료되기를 기대하고, 완료 후에 종속 서비스를 시작합니다.

•

처음 초기화해주는 서비스

docker-compose.yml로 포팅: db 서비스 개선

•

이 환경 변수를 통해 Postgres DB 설정이 됨. 이에 대해서 앞서 살펴보았음

•

host volume과 named volume을 사용하고 있음

◦

host volume : 직접 호스트 pc의 디렉토리 주소와 컨테이너 내부 주소를 매핑

•

docker-compose.yml의 environment

◦

해당 서비스가 컨테이너 안에서 실행될 때 환경변수들을 지정 (Dockerfile의 ENV)

◦

2가지 문법이 존재

▪

Map 문법 → 위의 docker compose file은 이 것을 사용

environment:
	RACK_ENV: development
	SHOW: "true"
		USER_INPUT:
Docker
복사

▪

Array 문법:

environment:
- RACK_ENV=development
- SHOW=true
	- USER_INPUT
Docker
복사

docker-compose.yml로 포팅: redis 서비스 개선

•

volume, health check, network 설정

docker-compose.yml로 포팅: worker 서비스 개선

•

build 키워드 밑에 빌드 관련 정보를 더 남겨서 docker compose 정보들을 기록 가능

◦

도커 파일 명, 도커파일 위치한 디렉토리

build:
      context: ./my_app    # 도커파일이 위치한 디렉토리 경로
      dockerfile: Dockerfile.prod  # 도커 파일 명
      args:
        - ENV=production  # 빌드 시에 사용할 환경 변수 설정
Docker
복사

docker-compose.yml로 포팅: result 서비스 개선 (node)

•

entrypoint : Dockerfile의 entrypoint를 오버라이딩

최종 Docker-compose.yml 리뷰

•

주의 : 다시 한번 Monterey Mac에서 포트 5000번을 사용할 수 없기에 vote 앱의 포트번호를 수정해야함 (아무 port를 부여할 것, 5001, 5002 제외)

•

vote와 result의 포트번호를 각각 5001과 5002로 수정한 버전이 위의 버전

# version is now using "compose spec"
# v2 and v3 are now combined!
# docker-compose v1.27+ required

services:
  vote:
    build: ./vote
    # use python rather than gunicorn for local dev
    command: python app.py
    depends_on:
      redis:
        condition: service_healthy
    healthcheck: 
      test: ["CMD", "curl", "-f", "http://localhost"]
      interval: 15s
      timeout: 5s
      retries: 3
      start_period: 10s
    volumes:
     - ./vote:/app
    ports:
      - "5000:80"
    networks:
      - front-tier
      - back-tier

  result:
    build: ./result
    # use nodemon rather than node for local dev
    entrypoint: nodemon server.js
    depends_on:
      db:
        condition: service_healthy 
    volumes:
      - ./result:/app
    ports:
      - "5001:80"
      - "5858:5858"
    networks:
      - front-tier
      - back-tier

  worker:
    build:
      context: ./worker
    depends_on:
      redis:
        condition: service_healthy 
      db:
        condition: service_healthy 
    networks:
      - back-tier

  redis:
    image: redis:alpine
    volumes:
      - "./healthchecks:/healthchecks"
    healthcheck:
      test: /healthchecks/redis.sh
      interval: "5s"
    networks:
      - back-tier

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: "postgres"
      POSTGRES_PASSWORD: "postgres"
    volumes:
      - "db-data:/var/lib/postgresql/data"
      - "./healthchecks:/healthchecks"
    healthcheck:
      test: /healthchecks/postgres.sh
      interval: "5s"
    networks:
      - back-tier

  # this service runs once to seed the database with votes
  # it won't run unless you specify the "seed" profile
  # docker compose --profile seed up -d
  seed:
    build: ./seed-data
    profiles: ["seed"]
    depends_on:
      vote:
        condition: service_healthy 
    networks:
      - front-tier
    restart: "no"

volumes:
  db-data:

networks:
  front-tier:
  back-tier:
YAML
복사

참고로 위의 docker compose file은 아래와 같이 실행이 되지 않는다. (그저 이렇게 개선이 될 수 있다는 점을 알려주고 싶었을 뿐) → 아래의 에러를 해결할 수 있다면 당신은 이미..

example-voting-app-db-1      | 2023-07-25 15:45:47.023 UTC [1] LOG:  database system is ready to accept connections
dependency failed to start: container example-voting-app-db-1 is unhealthy
Python
복사

Reference

[Docker] 도커 컴포즈(Docker compose) - 개념 정리 및 사용법

이번 포스트에서는 도커 컴포즈에 대해 정리하겠습니다. 도커 컴포즈란? 도커 컴포즈는 단일 서버에서 여러개의 컨테이너를 하나의 서비스로 정의해 컨테이너의 묶음으로 관리할 수 있는 작업 환경을 제공하는 관리 도구입니다. 도커 컴포즈를 사용하는 이유 여러 개의 컨테이너가 하나의 어플리케이션으로 동작할 때 도커 컴포즈를 사용하지 않는다면, 이를 테스트하려면 각 컨테이너를 하나씩 생성해야 합니다. 예를 들면, 웹 어플리케이션을 테스트하려면 웹 서버 컨테이너, 데이터베이스 컨테이너 두 개의 컨테이너를 각각 생성해야 합니다. 즉, 아래와 같이 두개의 run 명령어를 입력해야합니다. $ docker run --name wordpress_db -d mysql:8 $ docker run -d -p 8080:80 \ --l..

https://seosh817.tistory.com/387

실습으로 배우는 Docker 입문 | 4. Docker Compose를 사용하여 여러 컨테이너 배포

지금까지는 하나의 이미지 또는 컨테이너를 취급하는 방법을 진행해봤다. 그러나 실제 개발에서는 데이터베이스와 Web 서버 등의 여러 공정을 조합하여 시스템을 구성하는 것이 일반적이다. Docker를 사용한 시스템에서는 하나의 관심사를 하나의 컨테이너에 할당한다(Each container should have only one concern) 공식 문서에서도 권장되고 필연적으로 여러 컨테이너를 취급하는 경우가 종종 있다. 본 문서는 개발 및 테스트 환경을 위한 로컬 호스트에서 여러 컨테이너를 시작하는 방법으로 Docker Compose라는 도구를 소개한다. 여러 컨테이너 관리 도구 Docker Compose 개요 Docker Compose는 여러 컨테이너로 구성된 Docker 응용 프로그램의 설정을 작성하고 실행하기 위한 도구이다.

https://www.devkuma.com/docs/docker/get-started/4-deploying-multiple-containers-using-docker-compose/

[BOAZ] Docker compose 이론 및 실습