DockerComposedocker-compose오케스트레이션

Docker Compose 기본 (up / down / logs)

초보개발자2026. 7. 21.조회 171추천 0

변수 입력3개

COMPOSE_FILE

PORT

HEALTH_PATH

Docker Compose의 up, stop, down은 영향 범위가 다릅니다. 특히 down -v는 Compose가 만든 volume까지 제거할 수 있으므로 데이터베이스가 있다면 사용하지 않는 것이 기본입니다.

{{COMPOSE_FILE}}로 정의된 Docker Compose 서비스를 안전하게 실행하고 종료하려고 해.
설정 검증, 변경 사항 확인, 실행, health 확인, 로그 확인, 안전한 종료 순서로 설명해 줘.
volume 삭제 위험과 롤백 방법도 포함해 줘.

1. 설정과 이미지 확인

변수 치환이 끝난 최종 설정을 검증합니다. 출력에는 secret이 포함될 수 있으므로 공유하지 마세요.

docker compose -f '{{COMPOSE_FILE}}' config --quiet
docker compose -f '{{COMPOSE_FILE}}' config --services
docker compose -f '{{COMPOSE_FILE}}' images

2. 이미지 준비와 실행

docker compose -f '{{COMPOSE_FILE}}' pull
docker compose -f '{{COMPOSE_FILE}}' up -d

로컬 Dockerfile을 다시 빌드해야 할 때만 --build를 사용합니다.

docker compose -f '{{COMPOSE_FILE}}' up -d --build

3. 상태와 실제 동작 검증

docker compose -f '{{COMPOSE_FILE}}' ps
docker compose -f '{{COMPOSE_FILE}}' logs --tail=100
docker compose -f '{{COMPOSE_FILE}}' config --images

health check가 있으면 healthy 상태를 기다리고, 외부 API도 직접 확인하세요.

curl --fail --show-error http://127.0.0.1:{{PORT}}/{{HEALTH_PATH}}

4. 종료 명령 구분

컨테이너를 보존한 채 중지:

docker compose -f '{{COMPOSE_FILE}}' stop

컨테이너와 기본 네트워크 제거:

docker compose -f '{{COMPOSE_FILE}}' down

down -v는 volume을 제거하므로 영구 데이터가 있는 환경에서는 백업 없이 실행하지 마세요. 문제가 생기면 이전 image tag와 compose 파일로 되돌린 뒤 다시 up -d하고 데이터 호환성을 검증합니다.

공식 문서: https://docs.docker.com/reference/cli/docker/compose/

댓글 0개

아직 댓글이 없습니다.