Docker Compose

Date

2024/12/09

Docker Compose

Docker Compose는 다중 컨테이너 애플리케이션을 정의하고 실행하기 위한 도구이다. 전체 애플리케이션의 서비스를 구성해서 각각 실행시키는 것이 아닌 하나의 명령어로 여러 컨테이너로 구성된 서비스를 시작할 수 있다. 이를 통해 개발 및 배포 경험을 간소화하고 효율적인 관리가 가능하다. Docker Compose의 주요 기능은 다음과 같다.

•

단일 YAML 파일

◦

모든 서비스, 네트워크, 볼륨을 관리할 수 있는 YAML 구성 파일 사용

•

단일 명령으로 실행

◦

구성 파일에서 모든 서비스를 생성하고 시작하는 단일 명령어로 작업

•

다양한 환경 지원

◦

Production, Staging, Develop, Test 및 CI Workflow 등 모든 환경에서 작동

•

전체 라이프사이클 관리

◦

서비스 시작, 중지, 재빌드

◦

실행 중인 서비스의 상태 확인

◦

서비스의 로그 출력 스트리밍

◦

서비스에서 일회성 명령 실행

Docker Compose의 장점

간소화된 관리

단일 YAML 파일: 여러 컨테이너를 단일 YAML 파일로 정의하여, 애플리케이션 스택을 쉽게 관리할 수 있다.

효율적인 협업

공유 용이성: Compose 파일을 공유하여, 팀원 간의 협업을 원활히 하며, 동일한 환경을 사용할 수 있다.

빠른 개발 사이클

캐싱 기능: 변경되지 않은 서비스는 기존 컨테이너를 재사용하여, 애플리케이션 환경을 빠르게 변경하고 테스트 할 수 있다.

이식성

환경 변수 지원: Compose 파일에서 변수를 사용하여, 다양한 환경(개발, 테스트, 프로덕션)에 맞게 쉽게 구성을 조정할 수 있다.

자동화된 테스트 환경

격리된 테스트 환경: 테스트를 위한 격리된 환경을 쉽게 생성/파괴할 수 있어 CI/CD 프로세스에 적합하다.

Setting

docker compose를 사용하여도 상관 없다.

Docker Compose Standalone

•

Docker Compose

◦

일반적으로 Docker와 함께 설치되어 사용

◦

Docker daemon에 의존하며, Docker가 실행 중인 환경에서만 작동

◦

docker compose 로 실행

•

Docker Compose Standalone

◦

Docker 환경과 독립적으로 실행할 수 있는 버전

◦

특정환경에서 Docker Compose를 사용할 수 있도록 설계되어 있어 Docker와의 직접적인 의존성이 없음

◦

docker-compose 로 실행

Docker Compose와 Docker Compose Standalone의 주요 차이는 실행 환경, 설치 방법, 사용 사례에서의 유연성이다. 일반적인 개발 환경에서는 Docker Compose가 적합하지만, 특정 환경이나 CI/CD 워크플로우에서는 Standalone 버전이 더 유용할 수 있다.

Install the Docker Compose Standalone

https://docs.docker.com/compose/install/standalone/#on-linux

sudo curl -SL "https://github.com/docker/compose/releases/download/v2.30.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

chmod +x /usr/local/bin/docker-compose

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

# 버전확인
docker-compose -v
Shell
복사

주요 명령어

# 확인
docker-compose ps

# .yml 파일의 설정정보로 컨테이너 실행
## 존재하지 않는 network 등 자원 자동 생성
docker-compose up

## Dockerfile 변경사항 생긴경우, 새롭게 반영하여 빌드
### -d detach 모드
docker-compose up --build -d

# 로그 출력
docker-compose logs

# 컨테이너 정지
docker-compose stop

# 컨테이너 시작
docker-compose start

# 컨테이너 재시작
docker-compose restart

# 컨테이너 종료 및 삭제
docker-compose down
Shell
복사

https://docs.docker.com/reference/cli/docker/compose/

Practical Exercise

실습 환경은 다음과 같다:

OS: Ubuntu
Backend:
  - Framework: Springboot 
  - Build Tool: maven
Database: MySQL
Network: Bridge Network

Prerequisites

•

bind mount할 디렉토리 생성

◦

mkdir -p ~/data/mysql

•

프로젝트 빌드 → .jar

•

Dockerfile 생성 

FROM openjdk:17
COPY app-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]
Docker
복사

YAML

services:
  db:
    container_name: mysql-server
    image: mysql:latest
    ports:
      - 3306:3306
    volumes:
      - /home/ubuntu/data/mysql:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: app
      MYSQL_USER: app
      MYSQL_PASSWORD: app
    networks:
      - app-network
    healthcheck:
      test: ['CMD-SHELL', 'mysqladmin ping -h 127.0.0.1 -u root --password=$$MYSQL_ROOT_PASSWORD']
      interval: 10s
      timeout: 2s
      retries: 100

  backend:
    container_name: backend-server
    build:
      context: .
      dockerfile: ./Dockerfile
    ports:
      - 8080:8080
    environment:
      MYSQL_HOST: db
    depends_on:
      db:
        condition: service_healthy
    networks:
      - app-network

networks:
  app-network:
    driver: bridge
YAML
복사

•

environment: 환경변수

•

healthcheck: 연결 상태 확인

•

depends_on: 의존 서비스

◦

해당 yaml에서는 db가 실행되고 healthcheck가 정상적으로 이뤄져야 backend 서비스가 실행됨

Docker Compose

Learn how to use Docker Compose to define and run multi-container applications with this detailed introduction to the tool.

https://docs.docker.com/compose/