[Docker] 3. 도커 컴포즈(Docker compose)

 

 

도커 컴포즈(Docker compose)

도커 컴포즈는 도커 컨테이너 실행 순서와 흐름을 한눈에 볼 수 있습니다. 또한 실행에 관한 명세를 적어 놓으니 어떤 서비스들이 연관되어 있고 순서가 어떻게 진행되는지 볼 수 있습니다. 바로 상세 설명이 나오겠지만, 제가 생각하는 도커 컴포즈의 최대 장점은 "Docker run(실행)의 코드화"라고 생각합니다. 자세히 살펴보시죠.

 

Docker Compose란?

Docker Compose는 여러 개의 Docker 컨테이너를 정의하고 동시에 관리할 수 있도록 돕는 도구입니다. 단일 docker-compose.yml 파일에 애플리케이션의 모든 컨테이너 정의(서비스, 네트워크, 볼륨 등)를 작성하고, 명령 한 줄로 관련 컨테이너를 시작, 중지, 관리할 수 있습니다.

---

 

Docker Compose를 사용하는 이유

Docker Compose는 컨테이너 기반 애플리케이션 개발 및 배포에서 아래와 같은 이유로 매우 유용합니다:

1. 다중 컨테이너 관리

복잡한 애플리케이션은 종종 여러 컨테이너로 구성됩니다(예: 웹 서버, 데이터베이스, 캐시 서버 등).

Compose를 사용하면 각 컨테이너의 설정을 한곳에서 정의하고, 쉽게 전체 시스템을 시작하거나 중지할 수 있습니다.

• 예: frontend, backend, database 컨테이너를 한꺼번에 실행.

2. 간편한 설정 및 재사용성

컨테이너의 설정 정보를 docker-compose.yml 파일에 선언적으로 정의하므로:

• 설정을 공유하거나 버전 관리(Git)하기 쉽습니다.
• 팀원 간 동일한 개발 환경을 구축하기 용이합니다.

3. 개발 환경 구축 및 테스트

로컬 개발 환경에서 여러 컨테이너를 손쉽게 실행하여 프로덕션 환경과 유사한 상태를 재현할 수 있습니다.

• 예: docker-compose up을 통해 개발, 테스트, QA 환경을 동일하게 재현.

4. 네트워킹 및 연결 관리

Compose는 네트워크를 자동으로 설정하고, 서로 다른 컨테이너 간 통신을 간편하게 관리합니다.

• 예: backend 컨테이너가 database 컨테이너의 이름으로 접근 가능 (service name 기반).

5. 효율적인 배포 및 스케일링

Docker Compose는 Docker Swarm과 연계하여 스케일링 및 배포도 가능하며, 여러 인스턴스의 컨테이너를 쉽게 관리할 수 있습니다.

• 예: docker-compose up --scale web=3으로 웹 서버를 3개로 확장.

6. 볼륨 및 데이터 유지 관리

서비스 간 공유되는 데이터 볼륨을 쉽게 정의하고 관리할 수 있어 데이터 영속성을 유지합니다.

• 예: volumes를 통해 데이터베이스 데이터를 호스트 머신에 저장.

---

 

Docker Compose의 주요 구성 요소

1. Services: 컨테이너 단위의 실행 환경 정의.
   • 예: web, db와 같은 서비스.
2. Networks: 컨테이너 간 통신을 위한 네트워크 설정.
3. Volumes: 데이터 공유 및 영속성을 위한 볼륨 설정.

---

 

Docker Compose 사용 예시

docker-compose.yml 예제 파일

version: '3.8'

services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    networks:
      - app-network

  app:
    build:
      context: ./app
    volumes:
      - .:/app
    depends_on:
      - db
    networks:
      - app-network

  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - db-data:/var/lib/mysql
    networks:
      - app-network

volumes:
  db-data:

networks:
  app-network:

실행 방법

1. 컨테이너 실행: docker-compose up -d
2. 실행된 컨테이너 확인: docker-compose ps
3. 컨테이너 종료 및 삭제: docker-compose down

---

 

최신 Docker Compose

docker-compose up/down 등으로 실행하는 것은 파이썬 기반의 version1이며 더이상 지원되지 않습니다(다만 관리는 계속 됨). 최신버전은 compose.yaml로 관리되며 docker compose up/down식의 Go기반의 v2입니다.

Docker compose v2 실습

docker compose --help

# compose.yaml 서비스에 build가 존재하는 모든 것들 빌드 진행
docker compose build

# 서비스 및 네트워크 생성
docker compose up

# 서비스 및 네트워크 삭제
docker compose down

# 서비스 및 네트워크 생성(백그라운드)
docker compose up -d

# 컴포즈 프로젝트 현황(서비스는 프로젝트의 하위)
docker compose ls

# 항상 빌드 하면서 up 시키기
# 컴포즈는 동일한 이미지 이름이 존재하는 경우, build를 생략함
docker compose up -d --build

docker compose logs -h

docker compose logs -f

docker compose down

 

 

 

docker compose ls, docker compose images

두 명령어는 Docker Compose 환경에서 정보를 조회하는 데 사용되지만, 서로 다른 대상과 정보를 제공합니다.

---

1. docker compose ls

• 목적: Docker Compose로 관리 중인 프로젝트 목록을 표시.
• 주요 정보:
  • 각 프로젝트의 이름.
  • 프로젝트가 실행되고 있는 상태(Status).
  • 구성 파일의 경로(Working Directory).
• 사용 이유:
  • 여러 Docker Compose 프로젝트를 관리할 때 각각의 상태를 한눈에 확인.
  • 실행 중인 프로젝트를 식별하거나 작업 디렉토리를 확인.
• 출력 예시:
  • NAME: Docker Compose 프로젝트 이름.
  • STATUS: 해당 프로젝트의 컨테이너 상태(running, exited 등).
  • CONFIG FILES: 사용된 docker-compose.yml 파일 경로.

$ docker compose ls
NAME                STATUS       CONFIG FILES
my_project          running      ./docker-compose.yml
another_project     exited       ./another-dir/docker-compose.yml

---

2. docker compose images

• 목적: 특정 Docker Compose 프로젝트에서 사용된 Docker 이미지 목록을 표시.
• 주요 정보:
  • 이미지 이름과 태그.
  • 컨테이너 이름.
  • 이미지 ID.
  • 이미지 크기.
• 사용 이유:
  • 프로젝트에서 사용된 이미지 정보를 확인.
  • 이미지 태그를 검토하거나, 필요 없는 이미지를 제거하기 전에 참고.
• 출력 예시:
  • Container: Compose 프로젝트에서 정의된 서비스 이름.
  • Repository: 사용된 Docker 이미지의 리포지토리 이름.
  • Tag: Docker 이미지 태그.
  • Image ID: 이미지의 고유 ID.
  • Size: 이미지의 크기.

$ docker compose images
Container           Repository      Tag       Image ID       Size
my_project_web      nginx           latest    a1b2c3d4e5f6   23MB
my_project_db       postgres        14.1      f6e5d4c3b2a1   40MB

---

 

차이점 요약

 

명령어	주요 대상	출력 정보	사용 목적
docker compose ls	Docker Compose 프로젝트	프로젝트 이름, 상태, 구성 파일 경로	여러 프로젝트를 관리하거나 상태를 한눈에 파악할 때.
docker compose images	Docker Compose 이미지	컨테이너, 이미지 이름/태그, ID, 크기	특정 프로젝트에서 사용된 Docker 이미지 정보를 확인할 때.

---

 

사용 예시

1. 프로젝트 상태 확인

$ docker compose ls
NAME                STATUS       CONFIG FILES
my_app              running      ./docker-compose.yml

2. 특정 프로젝트의 이미지 정보 확인

$ docker compose images
Container           Repository      Tag       Image ID       Size
my_app_web          python          3.10      abc12345       150MB
my_app_db           mysql           8.0       def67890       300MB