Compose로 서버와 클라이언트 실행하기 · Docker
서비스의 구성과 실행 명령을 파일 하나로 묶습니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
Compose 모델
services는 실행할 컨테이너 설정이며 프로젝트 이름이 관련 리소스를 구분합니다. config로 해석된 결과를 먼저 확인하면 YAML 오류를 일찍 찾을 수 있습니다.
서비스 이름으로 연결
Compose의 기본 네트워크에서 서비스 이름이 DNS 이름이 됩니다. client가 web:80으로 요청하므로 호스트 포트 공개 없이 통신할 수 있습니다.
실행 순서와 준비 상태
컨테이너가 시작됐다고 애플리케이션이 바로 준비되는 것은 아닙니다. 이 예시는 HTTP 요청을 제한된 횟수만 재시도하며, 운영 구성에서는 healthcheck와 의존 조건도 검토합니다.
왜 필요한가요?
Compose 파일은 여러 컨테이너를 한 애플리케이션으로 실행할 때의 선언입니다. 서비스 이름·프로젝트 이름·실제 컨테이너 이름은 관련 있지만 같은 개념은 아닙니다.
차례대로 이해하기
선언과 적용 구분
config로 합쳐진 설정을 읽고 up으로 원하는 서비스 상태를 구성합니다. 같은 프로젝트의 기본 네트워크에서는 서비스 이름으로 연결할 수 있어 변경되는 컨테이너 IP를 설정에 고정할 필요가 줄어듭니다.
시작과 준비 분리
depends_on의 시작 순서만으로 DB가 요청을 받을 준비까지 끝났다고 보장하지 않습니다. healthcheck와 service_healthy 조건, 애플리케이션 자체 재시도처럼 준비를 확인하는 방법을 구분해야 합니다.
직접 실행하며 익혀보세요.
Docker Engine 또는 Docker Desktop(Linux 컨테이너), Compose v2, POSIX 셸과 curl이 필요합니다. 개인 실습 호스트에서 실행하고 study- 접두사의 리소스만 정리하세요. 이미지 다운로드에 네트워크가 필요합니다.
임시 폴더에 Compose 파일을 만들고 서버를 시작한 뒤 일회성 클라이언트로 접근하세요. -p study-compose로 다른 프로젝트와 리소스를 구분합니다.
study_compose_dir=$(mktemp -d)
cd "$study_compose_dir"
cat > compose.yaml <<'YAML'
services:
web:
image: nginx:stable-alpine
client:
image: busybox:1.36
command: ["sh", "-c", "for i in 1 2 3 4 5; do wget -qO- http://web && exit 0; sleep 1; done; exit 1"]
YAML
docker compose -p study-compose config
docker compose -p study-compose up -d web
docker compose -p study-compose run --rm client
docker compose -p study-compose logs --tail=10 web이렇게 확인하세요
클라이언트 출력에 nginx HTML이 나타나고 web 로그에 HTTP 요청이 남아야 합니다. compose config는 실행이 아니라 구성 확인입니다. 종료할 때 같은 폴더에서 같은 프로젝트 이름으로 down을 실행하세요.
실습 리소스 정리
결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.
docker compose -p study-compose down응용해보기
웹 서비스가 DB보다 늦게 시작했는데 연결 실패로 종료합니다. 단순한 sleep을 늘리는 대신 어떤 설계를 검토할까요?
생각해본 뒤 풀이 보기
DB 준비를 검사하는 healthcheck와 의존 조건, 웹 앱의 제한된 재시도·오류 처리를 검토합니다. 최초 시작뿐 아니라 DB가 나중에 재시작되는 상황도 앱이 감당해야 하므로 순서만으로 가용성을 해결하지 않습니다.
잠깐, 이해했는지 확인해볼까요?
Compose 기본 네트워크에서 client가 web 서비스에 사용할 호스트 이름은?
- web
- Dockerfile
- localhost가 항상 web
- 프로젝트 디렉터리의 절대 경로
생각해본 뒤 풀이 보기
web
같은 Compose 네트워크에서 서비스 이름 web으로 검색할 수 있습니다. client의 localhost는 client 자신입니다.