1. 홈
  2. 개발자
  3. docker-compose 생성기

docker-compose 생성기

서비스를 골라 담으면 compose.yaml과 .env.example이 만들어집니다.

다른 형식·기능까지 한 번에 하려면 서버 설정 파일 생성기 →

내 브라우저에서 처리 · 업로드 없음
서비스 추가
내 앱
비밀번호는 값을 쓰지 말고 ${변수} 로 두세요. 실제 값은 .env 파일에 넣습니다.
PostgreSQL
DB 는 비워 두면 같은 네트워크의 다른 서비스에서만 접속됩니다. 열어야 한다면 127.0.0.1:5432:5432 처럼 로컬만 지정하세요.
비밀번호는 값을 쓰지 말고 ${변수} 로 두세요. 실제 값은 .env 파일에 넣습니다.
compose.yaml
services: app: build: . restart: unless-stopped ports: - "3000:3000" environment: NODE_ENV: production networks: - app-net depends_on: postgres: condition: service_healthy postgres: image: postgres:17 restart: unless-stopped environment: POSTGRES_USER: app POSTGRES_DB: app POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env} volumes: - postgres-data:/var/lib/postgresql/data networks: - app-net healthcheck: test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER:-postgres}\""] interval: 10s timeout: 5s retries: 5 volumes: postgres-data: {} networks: app-net: driver: bridge
.env.example
# Copy to .env and fill in real values. Never commit .env to git. POSTGRES_PASSWORD=
실행 방법
# .env 를 만들고 비밀번호를 채웁니다 cp .env.example .env # 설정이 올바른지 확인 docker compose config # 백그라운드로 실행 docker compose up -d
운영에 반영하기 전에 생성된 파일을 검토하세요. 비밀번호는 .env 에만 두고 .env 는 git 에 올리지 마세요.

입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

사용 방법

  1. 상단의 서비스 추가 버튼으로 내 앱, Nginx, PostgreSQL, MySQL, MariaDB, MongoDB, Redis, RabbitMQ 를 필요한 만큼 추가합니다. 같은 종류를 여러 개 추가해도 이름이 겹치지 않게 번호가 붙습니다.
  2. 서비스 카드에서 이름, 이미지 태그, 포트, 환경 변수, 볼륨, 재시작 정책을 고칩니다. 내 앱은 이미지를 비워 두면 build 로 현재 폴더를 빌드합니다.
  3. 전용 네트워크와 healthcheck 옵션을 정합니다.
  4. 아래에 생성된 compose.yaml 과 .env.example 을 복사하거나 내려받아 같은 폴더에 두고, cp .env.example .env 로 비밀번호를 채운 뒤 docker compose up -d 로 실행합니다.

서비스 프리셋

서비스 기본 이미지 데이터 볼륨 비밀번호 변수
PostgreSQL postgres:17 postgres-data:/var/lib/postgresql/data POSTGRES_PASSWORD
MySQL mysql:8.4 mysql-data:/var/lib/mysql MYSQL_PASSWORD, MYSQL_ROOT_PASSWORD
MariaDB mariadb:11 mariadb-data:/var/lib/mysql MARIADB_PASSWORD, MARIADB_ROOT_PASSWORD
MongoDB mongo:8 mongo-data:/data/db MONGO_ROOT_PASSWORD
Redis redis:7-alpine redis-data:/data 없음 (포트 비공개)
RabbitMQ rabbitmq:4-management-alpine rabbitmq-data:/var/lib/rabbitmq RABBITMQ_PASSWORD
Nginx nginx:stable-alpine ./nginx.conf 를 읽기 전용 마운트 없음

이미지 태그는 입력칸에서 원하는 버전으로 바꿀 수 있습니다. 태그는 생성 시점의 예시이므로 Docker Hub 에서 실제 존재 여부와 지원 기간을 확인하세요.

생성 결과의 특징

  • 비밀번호는 파일에 쓰지 않습니다. DB 비밀번호는 ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env} 처럼 변수 참조로만 들어가고, .env 에 값이 없으면 docker compose 가 시작 전에 멈춥니다. .env.example 은 같은 변수 이름을 값 없이 나열합니다.
  • DB 는 호스트 포트를 열지 않습니다. 같은 네트워크의 앱 서비스는 서비스 이름(postgres, redis 등)으로 접속합니다. 꼭 열어야 하면 127.0.0.1:5432:5432 처럼 로컬 주소만 지정하세요.
  • 시작 순서: healthcheck 를 켜면 앱이 DB 의 service_healthy 를 기다립니다. PostgreSQL 은 pg_isready, MySQL 은 mysqladmin ping, Redis 는 redis-cli ping 으로 상태를 봅니다. 끄면 단순한 depends_on 목록만 나옵니다.
  • 이름 있는 볼륨은 최상위 volumes: 에 자동으로 등록되고, ./data:/data 같은 경로 바인드는 등록되지 않습니다.
  • PostgreSQL 이미지가 18 이상이면 데이터 마운트 경로를 /var/lib/postgresql 로 바꿔 줍니다. 17 이하는 /var/lib/postgresql/data 입니다.
  • 포트 매핑은 YAML 에서 80:80 이 60진수 숫자로 오해되지 않도록 항상 큰따옴표로 감쌉니다.

알아 둘 점

  • 환경 변수 값에 $ 를 글자 그대로 쓰려면 $$ 로 적어야 합니다. compose 는 $ 로 시작하는 표현을 변수로 치환합니다.
  • 키 이름에 PASSWORD, SECRET, TOKEN 이 들어간 항목에 값을 직접 적으면 경고를 보여 줍니다. 로컬 개발용이라도 그 파일이 저장소에 올라가지 않게 .env 로 옮기는 편이 안전합니다.
  • 최신 compose 파일에는 version: 키가 필요 없어서 생성하지 않습니다.
  • 생성된 파일은 운영에 반영하기 전에 검토하세요. 리소스 제한, 로그 설정, 백업 같은 운영 설정은 포함하지 않습니다. docker compose config 로 변수 치환 결과를 먼저 확인할 수 있습니다.
  • 앱용 이미지는 Dockerfile 생성기로, 앞단 프록시 설정은 Nginx 설정 생성기로 만들 수 있습니다. .env 형식 변환은 환경 변수 변환기, 생성된 YAML 의 구조 확인은 JSON YAML 변환기가 도와줍니다. Docker 없이 호스트에서 돌리려면 systemd 서비스 생성기를 참고하세요.

자주 묻는 질문

docker-compose.yml 과 compose.yaml 중 무엇을 쓰나요?

Docker Compose V2 는 compose.yaml 을 우선 찾고 docker-compose.yml 도 읽습니다. 이 도구는 현재 권장 이름인 compose.yaml 로 내려받게 합니다.

depends_on 을 썼는데 앱이 DB 보다 먼저 뜨면 어떻게 하나요?

단순 depends_on 은 컨테이너가 시작되기만 기다리고 DB 가 준비될 때까지는 기다리지 않습니다. healthcheck 옵션을 켜면 condition: service_healthy 로 준비될 때까지 기다립니다.

볼륨 데이터는 어디에 저장되나요?

이름 있는 볼륨은 Docker 가 관리하는 영역에 저장되고 docker compose down 을 해도 남습니다. 볼륨까지 지우려면 docker compose down -v 를 쓰는데, 데이터가 사라지니 주의하세요.

비밀번호를 compose.yaml 에 직접 적으면 안 되나요?

기술적으로는 되지만 파일이 저장소나 백업에 남습니다. 이 도구는 변수 참조와 .env 방식으로 만들고, 값을 직접 적으면 경고합니다.

입력한 내용이 서버로 전송되나요?

아니요. 파일은 모두 브라우저 안에서 만들어집니다.

입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.