Docker Compose는 여러 개의 컨테이너를 정의하고 실행하는 데 유용한 도구입니다. 그러나 많은 사용자들이 처음 사용하는 과정에서 여러 가지 실수를 범하게 되며, 이는 개발 및 배포 과정에서 문제를 일으킬 수 있습니다. 이번 글에서는 Docker Compose에서 자주 발생하는 실수와 그 해결 방법에 대해 살펴보겠습니다.

1. 잘못된 YAML 문법

Docker Compose 파일인 docker-compose.yml은 YAML 형식으로 작성됩니다. YAML 문법은 들여쓰기에 민감하므로, 잘못된 들여쓰기가 발생하면 실행 오류가 발생할 수 있습니다. 예를 들어:

version: '3'
services:
  web:
    image: nginx
    ports:
      - "80:80"
    volumes:
    - ./html:/usr/share/nginx/html  # 잘못된 들여쓰기

이 경우 volumes 항목이 잘못 들여쓰기 되어 있습니다. 이를 수정하면 정상적으로 작동합니다.

version: '3'
services:
  web:
    image: nginx
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html  # 올바른 들여쓰기

2. 환경 변수 설정 오류

Docker Compose 파일에서 환경 변수를 사용하는 경우, 설정을 잘못하면 컨테이너가 의도한 대로 작동하지 않을 수 있습니다. 예를 들어, .env 파일에서 환경 변수를 정의했는데, Docker Compose 파일에 적절히 적용하지 않으면 문제가 발생합니다.

.env 파일: 
MYSQL_ROOT_PASSWORD=rootpassword
docker-compose.yml 파일: 
version: '3'
services:
  db:
    image: mysql
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}

위와 같이 환경 변수를 잘못 설정하면, 컨테이너 실행 시 환경 변수가 적용되지 않아 데이터베이스가 정상적으로 작동하지 않을 수 있습니다. 환경 변수를 올바르게 사용해야 합니다.

3. 컨테이너 간의 네트워크 문제

Docker Compose는 기본적으로 서비스 간의 네트워크를 자동으로 생성합니다. 그러나 서비스 간 통신을 위해 올바른 네트워크 구성을 하지 않으면 연결 문제가 발생할 수 있습니다. 예를 들어, 두 서비스가 서로 다른 네트워크에 설정되어 있으면 통신이 불가능합니다.

version: '3'
services:
  app:
    image: myapp
    networks:
      - app-network

  db:
    image: mysql
    networks:
      - db-network  # 이 경우 app 서비스와 db 서비스가 통신할 수 없다.

networks:
  app-network:
  db-network:

이 문제를 해결하기 위해서는 두 서비스를 동일한 네트워크에 설정해야 합니다.

version: '3'
services:
  app:
    image: myapp
    networks:
      - my-network

  db:
    image: mysql
    networks:
      - my-network  # 동일한 네트워크에 설정

networks:
  my-network:

4. 볼륨 마운트 오류

Docker Compose를 사용할 때, 로컬 파일 시스템과 컨테이너 간의 데이터 공유를 위해 볼륨을 설정하는 경우가 많습니다. 그러나 경로를 잘못 설정하면 데이터가 올바르게 마운트되지 않거나, 데이터가 손실될 수 있습니다.

예를 들어, 다음과 같이 설정한 경우:

version: '3'
services:
  web:
    image: nginx
    volumes:
      - /path/to/local:/usr/share/nginx/html  # 잘못된 경로

이 경우 /path/to/local이 존재하지 않으면 마운트에 실패합니다. 따라서 마운트할 로컬 경로가 반드시 존재해야 합니다. 올바른 경로를 사용해야 합니다.

5. 불필요한 이미지 빌드

Docker Compose를 사용할 때, docker-compose up 명령어를 사용하면 자동으로 이미지를 빌드합니다. 그러나 코드 변경이 없는데도 불구하고 매번 이미지를 다시 빌드하면 불필요한 리소스 낭비가 발생합니다. 이를 방지하기 위해 docker-compose up --no-build 옵션을 사용하여 이미지를 다시 빌드하지 않도록 할 수 있습니다.

docker-compose up --no-build

또한, 이미지를 수동으로 빌드하려면 docker-compose build 명령어를 사용할 수 있습니다.

마무리

Docker Compose는 컨테이너 기반의 애플리케이션을 효율적으로 관리하는 데 매우 유용한 도구입니다. 그러나 여러 가지 실수를 범할 수 있으며, 이를 이해하고 해결하는 것은 개발자의 중요한 과제입니다. 위에서 설명한 실수와 해결 방법을 참고하여 Docker Compose를 보다 효과적으로 활용할 수 있기를 바랍니다. 실수를 통해 배우는 과정에서 한층 더 성장할 수 있을 것입니다.