사용 방법
- 상단의 서비스 추가 버튼으로 내 앱, Nginx, PostgreSQL, MySQL, MariaDB, MongoDB, Redis, RabbitMQ 를 필요한 만큼 추가합니다. 같은 종류를 여러 개 추가해도 이름이 겹치지 않게 번호가 붙습니다.
- 서비스 카드에서 이름, 이미지 태그, 포트, 환경 변수, 볼륨, 재시작 정책을 고칩니다. 내 앱은 이미지를 비워 두면
build로 현재 폴더를 빌드합니다. - 전용 네트워크와 healthcheck 옵션을 정합니다.
- 아래에 생성된
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 방식으로 만들고, 값을 직접 적으면 경고합니다.
입력한 내용이 서버로 전송되나요?
아니요. 파일은 모두 브라우저 안에서 만들어집니다.
입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.