오케스트레이션의 시작: Docker Compose와 필수 명령어

도커 컴포즈란 무엇인가?

도커 컴포즈는 여러 개의 컨테이너 설정을 `docker-compose.yml`이라는 하나의 텍스트 파일에 미리 다 적어두고, 이 파일을 바탕으로 시스템 전체를 통째로 관리하는 도구입니다.

명령어의 선언적 전환 (명령어에서 주문서로)

터미널에 길게 치던 `docker run` 명령어는 "이렇게 실행해!"라고 하나하나 명령을 내리는 방식(명령형)입니다. 반면 `docker-compose.yml`은 "내가 원하는 서버 구성은 이거야. 알아서 만들어 줘!"라고 주문서를 던지는 방식(선언적)입니다.

도커 컴포즈 파일 안에는 위와 같은 여러 개의 서비스(Service)들을 나열하고, 각각 어떤 포트를 열지, 어떤 환경 변수를 쓸지 미리 다 적어둡니다.

version: '3.8'
services:
  web:
    image: nginx
    ports:
      - "8080:80"
  db:
    image: postgres:15
    environment:
      - POSTGRES_PASSWORD=secret
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  db-data:

도커 컴포즈의 핵심 필수 명령어 5가지

`docker-compose.yml` 파일이 있는 폴더에서 터미널을 열고, 아래 명령어들을 사용해 모든 컨테이너를 지휘할 수 있습니다. 바이브코딩을 할 때 이 5가지 명령어만 알면 웬만한 상황은 다 대처할 수 있습니다.

1. `docker compose up` (실행하기)

이 주문서에 적힌 모든 컨테이너를 한꺼번에 생성하고 실행합니다.

• `docker compose up -d`를 사용하면 백그라운드에서 조용히 실행됩니다. (-d는 detached 모드입니다.)

2. `docker compose down` (종료 및 정리하기)

실행 중인 모든 컨테이너를 중지하고 깔끔하게 삭제합니다.

• 도커 컴포즈가 알아서 만들었던 네트워크도 함께 정리해 줍니다. 매우 깔끔하게 시스템을 끄는 방법입니다.

3. `docker compose logs` (로그 확인하기)

서버에 에러가 났을 때 가장 먼저 쳐야 할 명령어입니다.

• `docker compose logs -f`를 치면, 터미널 화면에 실시간으로 찍히는 로그를 계속해서(follow) 보여줍니다. (종료할 때는 Ctrl+C)
• `docker compose logs -f web`처럼 서비스 이름을 뒤에 붙이면 특정 컨테이너의 로그만 볼 수 있습니다.

4. `docker compose ps` (상태 확인하기)

현재 도커 컴포즈로 띄워진 컨테이너들의 상태(실행 중인지, 꺼졌는지)와 매핑된 포트 정보를 한눈에 보여줍니다.

5. `docker compose exec` (컨테이너 내부로 들어가기)

실행 중인 특정 컨테이너 안에 들어가서 명령어를 쳐야 할 때 사용합니다. 예를 들어 DB 컨테이너 안에 들어가서 직접 쿼리를 날려보고 싶을 때 유용합니다.

• 예: `docker compose exec db bash` (db 컨테이너 안에 bash 쉘로 접속)