1. Docker Compose란?
- 여러 개의 Docker 컨테이너를 하나의 서비스 단위로 정의하고, 일괄적으로 실행/관리할 수 있게 도와주는 도구
- 즉, 여러 개의 Container를 한 번에 묶어서 관리 가능!!
1) 사용하는 이유
- 복잡한 애플리케이션 구성 간소화
- 여러 컨테이너(MySQL, Redis, Spring Boot, Frontend 등)를 하나의 compose.yml 파일에 정의해 일괄 실행 가능. - 명령어 단순화
- 복잡한 Docker CLI 명령어 없이 docker compose up 한 줄이면 실행 가능.
- 아래의 명령어를 compose.yml 파일 작성과 docker compose up 명령어를 이용하여 실행 가능 - $ docker run -e MYSQL_ROOT_PASSWORD=pwd1234 -p 3306:3306 -v /Users/jaeseong/Documents/Develop/docker-mydb/sql_data:/var/lib/mysql -d mysql
- 환경별 구성 관리
- 개발/운영 환경을 나누거나 특정 서비스만 수정하는 작업이 수월해짐. - 버전 관리에 용이
- 모든 설정이 .yml 파일에 있기 때문에 Git 등으로 이력을 관리하기 쉬움.
🛠️ 2. 기본 명령어 정리
| 명령어 | 설명 |
| docker compose up | 컨테이너 실행 (포그라운드) |
| docker compose up -d | 컨테이너 실행 (백그라운드) |
| docker compose ps | 실행 중인 컨테이너 확인 |
| docker compose logs | 전체 컨테이너 로그 보기 |
| docker compose down | 컨테이너 중단 및 삭제 |
| docker compose up --build | 코드 변경 시 이미지 재빌드 후 실행 |
| docker compose pull | 이미지 다운로드 또는 업데이트 |
⚠️ docker-compose (v1)는 더 이상 사용되지 않으며, docker compose (v2)를 사용할 것을 권장
📂 3. compose.yml 기본 구조
services:
서비스명:
container_name: 컨테이너_이름
image: 사용할_이미지
build: .
ports:
- "호스트포트:컨테이너포트"
volumes:
- ./로컬경로:/컨테이너경로
environment:
- 환경변수=값4. 실습 예제 모음
1) Nginx 웹서버 실행
#compose.yml
# docker run --name webserver -p 80:80 nginx 와 같은 기능
services:
my-web-server:
container_name: webserver
image: nginx
ports:
- 80:80🧪 실행 명령
docker compose up -d2) Redis 캐시 서버 실행
# compose.yml
# docker run -p 6379:6379 redis 와 같은 기능
services:
my-cache-server:
image: redis
ports:
- 6379:6379
🧪 테스트 명령
docker exec -it [컨테이너명] bash
redis-cli
127.0.0.1:6379> set key value
127.0.0.1:6379> get key3) MySQL 데이터베이스 실행
# compose.yml
# docker run -e MYSQL_ROOT_PASSWORD=pwd1234 -v C:\Users\chaeh\Documents\Develop\compose-practice/mysql_data:/var/lib/mysql -p 3306:3306 mysql 와 같은 기능
services:
my-db:
image: mysql
environment:
- MYSQL_ROOT_PASSWORD=pwd1234
volumes:
- ./mysql_data:/var/lib/mysql # compose.yml 파일이 있는 경로에서 상대 경로로 볼륨을 지정 가능
ports:
- 3306:3306
docker compose up -d볼륨 확인
- MySQL 데이터는 ./mysql_data 폴더에 지속적으로 저장
4) 백엔드: Spring Boot 실행
# Dockerfile
FROM openjdk:17-jdk
COPY build/libs/*SNAPSHOT.jar /app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]# compose.yml
# ./gradlew clean build
# docker build -t my-app .
# docker run -p 8080:8080 my-app 와 같은 기능
services:
my-server:
build: .
ports:
- 8080:8080
🧪 빌드 및 실행
./gradlew clean build
docker compose up -d --build5) 백엔드: Nest.js 실행
# Dockerfile
FROM node
WORKDIR /app
COPY . .
RUN npm install
RUN npm run build
EXPOSE 3000
ENTRYPOINT ["node", "dist/main.js"]# compose.yml
# docker build -t my-server .
# docker run -p 3000:3000 my-server 와 같은 기능
services:
my-server:
build: .
ports:
- 3000:3000docker compose up -d --build6) 프론트엔드: Next.js 실행
# Dockerfile
FROM node:20-alpine
WORKDIR /app
COPY . .
RUN npm install
RUN npm run build
EXPOSE 3000
ENTRYPOINT ["npm", "run", "start"]# compose.yml
# docker build -t web-server .
# docker run -p 80:3000 web-server 와 같은 기능
services:
my-web-server:
build: .
ports:
- 80:3000
docker compose up -d --build7) 정적 HTML/CSS + Nginx 실행
# index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<link rel="stylesheet" href="style.css">
</head>
<body>
<h1>My Web Page</h1>
</body>
</html># Dockerfile
FROM nginx
COPY ./ /usr/share/nginx/html# compose.yml
# docker build -t web-server .
# docker run -p 80:80 web-server 와 같은 기능
services:
my-web-server:
build: .
ports:
- 80:805. Docker CLI ↔ Compose 변환 사이트
| 기능 | 사이트 |
| Docker CLI → Compose 변환 | Composerize |
| Compose → Docker CLI 변환 | Decomposerize |
6. 컨테이너 정리
docker compose down모든 컨테이너, 네트워크를 정리합니다.(생성된 컨테이너를 삭제함. 연결된 볼륨은 삭제 x) 데이터가 삭제되지 않도록 주의!!
'DOCKER' 카테고리의 다른 글
| [Docker] AWS EC2에 서버 배포하기(Express 서버 배포하기) (0) | 2025.06.21 |
|---|---|
| [Docker] DockerCompose에 2개 이상의 Container 관리하기 (0) | 2025.06.20 |
| [Docker] Dockerfile를 사용하여 dockerimage 직접 만들기 (0) | 2025.06.19 |
| [Docker] Docker Container 데이터 유실 방지하기 - Volume 사용하기 (0) | 2025.06.19 |
| [Docker] Docker CLI 익히기 (0) | 2025.06.18 |