Docker Compose 생성기 — 무료 온라인 도구

서비스를 선택하고 볼륨, 네트워크, 환경 변수가 포함된 프로덕션용 docker-compose.yml을 생성하세요.

Docker Compose란?

Docker Compose는 멀티 컨테이너 애플리케이션을 정의하고 실행하기 위한 도구입니다. 하나의 docker-compose.yml 파일로 전체 애플리케이션 스택 — 웹 서버, 데이터베이스, 캐시 및 기타 서비스 — 과 이들의 연결 및 통신 방법을 정의합니다. docker-compose up 명령 하나로 모든 것이 시작됩니다.

Docker Compose는 로컬 개발 환경, CI/CD 파이프라인, 그리고 소규모 프로덕션 배포에 이상적입니다. 모든 개발자가 동일한 환경 설정을 사용하도록 보장하여 "내 컴퓨터에서는 되는데" 문제를 제거합니다.

일반적인 Docker Compose 스택

  • Node.js + PostgreSQL + Redis: 관계형 저장소와 캐싱이 포함된 일반적인 REST API 백엔드
  • Python + MySQL: Django 또는 Flask 웹 애플리케이션에 자주 사용
  • Nginx + Node.js: Node.js 애플리케이션 앞에 리버스 프록시로 Nginx 배치
  • 풀스택: Nginx + Node.js + PostgreSQL + Redis: 리버스 프록시, API, 데이터베이스, 캐시가 포함된 프로덕션 환경

Docker Compose 볼륨 & 네트워크 팁

  • 컨테이너 재시작 간에 데이터를 유지하려면 항상 데이터베이스 데이터에 네임드 볼륨을 사용하세요
  • 서비스 간 통신에는 커스텀 브리지 네트워크를 사용하세요 — 서비스 이름으로 서로 접근할 수 있습니다
  • 민감한 값(비밀번호, API 키)은 compose 파일에 하드코딩하는 대신 .env 파일을 사용하세요
  • 프로덕션 서비스에는 장애 시 자동 재시작을 위해 restart: unless-stopped를 설정하세요
  • 데이터베이스가 준비될 때까지 종속 서비스를 지연시키려면 healthcheck를 사용하세요

Docker Compose에 대한 자주 묻는 질문

docker compose up과 docker compose start의 차이점은 무엇인가요?

docker compose up은 필요에 따라 이미지를 풀링하거나 빌드하면서 컨테이너를 처음부터 생성하고 시작합니다. docker compose start는 이전에 생성되어 중지된 컨테이너만 재시작하며 새 컨테이너를 생성할 수 없습니다. 백그라운드(분리) 모드로 실행하려면 docker compose up -d를 사용하세요. Dockerfile이 변경된 경우 --build를 추가하여 이미지를 강제로 다시 빌드합니다.

Docker Compose에서 서비스 간에 어떻게 통신하나요?

같은 Docker Compose 네트워크에 있는 서비스는 서비스 이름을 호스트명으로 사용하여 서로 통신합니다. 데이터베이스 서비스 이름이 db이면, 애플리케이션은 localhost:5432 대신 db:5432로 연결합니다. Docker Compose는 같은 compose 파일에 정의된 모든 서비스를 위한 기본 브리지 네트워크를 자동으로 생성합니다. 더 세밀한 제어를 위해 커스텀 네임드 네트워크를 만들 수 있습니다.

컨테이너 재시작 간에 데이터베이스 데이터를 유지하려면 어떻게 하나요?

compose 파일에서 네임드 볼륨을 사용하세요. 볼륨이 없으면 컨테이너가 중지될 때 내부의 모든 데이터가 손실됩니다. 서비스 아래에 볼륨을 정의하세요: volumes: - postgres_data:/var/lib/postgresql/data, 그런 다음 최상위 레벨에 선언하세요: volumes: postgres_data:. 네임드 볼륨은 Docker가 관리하며 docker compose down에서도 유지됩니다 — docker compose down -v만이 볼륨을 제거합니다.

Docker Compose에서 restart: unless-stopped는 무엇을 의미하나요?

restart: unless-stopped는 컨테이너가 충돌하거나 Docker 데몬이 재시작될 때(예: 서버 재부팅 후) Docker가 자동으로 컨테이너를 재시작하지만, docker compose stop으로 명시적으로 중지한 컨테이너는 재시작하지 않음을 의미합니다. 이것은 프로덕션 서비스에 권장되는 설정입니다. 다른 옵션: no(재시작 안 함), always(명시적 중지 후에도 항상 재시작), on-failure(비정상 종료 코드일 때만 재시작).

관련 개발자 도구