[Docker] Docker Compose 완전 정복: 개념부터 실습, CLI 명령어까지 정리

Docker Compose란?!

여러 개의 Docker 컨테이너들을 하나의 서비스로 정의라고 구성해 하나의 묶음으로 관리할 수 있게 도와주는 툴이다!

 

Docker Compose를 사용하는 이유

여러 개의 컨테이너를 관리하는 데 용이하다.

여러 개의 컨테이너로 이루어진 복잡한 애플리케이션을 한 번에 관리할 수 있게 해준다. 여러 컨테이너를 하나의 환경에서 실행하고 관리하는 데 도움이 된다.

복잡한 명령어로 실행시키던 걸 간소화 시킬 수 있다.

Docker Compose를 사용하면 컨테이너를 실행시킬 때마다 복잡한 명령어를 입력하지 않아도 된다.
단순히 docker compose up 명령어만 실행시키면 된다.

 

Docker Compose 전체 흐름 느껴보기

1. compose.yml 파일 작성하기

services:
  my-web-server:  
    container_name: webserver
    image: nginx
    ports: 
      - 80:80

👉  services : my-web-server : Docker Compose에서 하나의 컨테이너를 서비스(Service)라고 부른다. 이 옵션은 서비스에 이름을 붙이는 기능이다.
👉  container_name: web-server : 컨테이너를 띄울 때 붙이는 별칭이다. CLI에서 --name web-server 역할과 동일하다.
👉  image: nginx : 컨테이너를 실행시킬 때 어떤 이미지를 사용할 지 정의하는 명령어이다. $ docker run [이미지명] 과 동일한 역할이다.
👉  ports : 포트 매핑은 어떻게 할 지를 설정하는 옵션이다. CLI에서 -p 80:80 역할과 동일하다.

2. compose 파일 실행시키기

$ docker compose up -d

3. compose 실행 현황 보기

$ docker compose ps
$ docker ps

4. compose로 실행된 컨테이너 삭제

$ docker compose down

 

자주 사용하는 Docker Compose CLI 명령어

아래 명령어들은 compose.yml 파일이 존재하는 디렉토리에서 실행시켜야 한다.

compose 파일 작성

services:
  websever:
    container_name: webserver
    image: nginx
    ports: 
      - 80:80

compose.yml에서 정의한 컨테이너 실행

$ docker compose up    # 포그라운드에서 실행
$ docker compose up -d # 백그라운드에서 실행

Docker Compose로 실행시킨 컨테이너 확인하기

# compose.yml에 정의된 컨테이너 중 실행 중인 컨테이너만 보여준다. 
$ docker compose ps 

# compose.yml에 정의된 모든 컨테이너를 보여준다.
$ docker compose ps -a

Docker Compose 로그 확인하기

# compose.yml에 정의된 모든 컨테이너의 로그를 모아서 출력한다.
$ docker compose logs

컨테이너를 실행하기 전에 이미지 재빌드하기

$ docker compose up --build # 포그라운드에서 실행
$ docker compose up --build -d # 백그라운드에서 실행

참고: docker compose up vs docker compose up --build

👉  docker compose up : 이미지가 없을 때만 빌드해서 컨테이너를 실행시킨다. 이미지가 이미 존재하는 경우 이미지를 빌드하지 않고 컨테이너를 실행시킨다.
👉  docker compose up --build : 이미지가 있건 없건 무조건 빌드를 다시 해서 컨테이너를 실행시킨다.

이미지 다운 받기 / 업데이트하기

$ docker compose pull

👉  compose.yml에서 정의된 이미지를 다운 받거나 업데이트 한다.
      로컬 환경에 이미지가 없다면 이미지를 다운 받는다.
      로컬 환경에 이미 이미지가 있는데, Dockerhub의 이미지와 다른 이미지일 경우 이미지를 업데이트 한다.

Docker Compose에서 이용한 컨테이너 종료하기

$ docker compose down

 

Docker Compose로 Redis, MySQL, Spring Boot 실행시키기

Redis compose.yml

services:
  my-cache-server:
    image: redis
    ports: 
      - 6379:6379

MySQL compose.yml

services:
  my-db:
    image: mysql
    environment:
      MYSQL_ROOT_PASSWORD: pwd1234
    volumes:
      - ./mysql_data:/var/lib/mysql
    ports:
      - 3306:3306

👉  environment: ... : CLI에서 -e MYSQL_ROOT_PASSWORD=password 역할과 동일하다.
👉  volumes: ... : CLI에서 -v {호스트 경로}:/var/lib/mysql 역할과 동일하다.

Spring Boot compose.yml

services:
  my-server:
    build: .
    ports:
      - 8080:8080

👉  build . : compose.yml이 존재하는 디렉토리(.)에 있는 Dockerfile로 이미지를 생성해 컨테이너를 띄우겠다는 의미이다.

compose 파일 실행시키기

$ docker compose up -d --build

 

Docker CLI ↔ Docker Compose 쉽게 작성하기

Docker CLI → compose.yml로 변환

https://www.composerize.com/

Composerize

compose.yml → Docker CLI로 변환

https://www.decomposerize.com/

Decomposerize