Docker - Docker compose란?

 

0. docker compose란?

docker-compose는  여러개의 도커 컨테이너를 하나의 애플리케이션으로 묶어 정의할 수 있도록 도와주는 하나의 툴이다.

 

1. compose 생성법 및 유의사항

docker compose 파일을 생성하는 법은 docker-compose.yml 라는 확장자를 가진 파일을 생성하면 된다. docker compose는 yml 파일 형식으로 구성되어져 있기에 들여쓰기가 틀리면 제대로 작동하지 않는다. 들여쓰기에 유의해서 작성하면 된다.

 

2. 예시

version: "3"
services:

  php:
    image: php:8.0.9-fpm
    container_name: php
    build:
      context: .
      dockerfile: ./Dockerfile
    volumes:
      - ./source/laravel:/workspace/example-test-app
      
  nginx:
    image: nginx:latest
    restart: always
    container_name: nginxgood
    ports:
      - "80:80"
    volumes:
      - ./nginx_update/nginx.conf:/etc/nginx/nginx.conf

php와 nginx라는 이미지를 묶어 docker-compose up 이라는 명령어를 입력할 시, 해당 이미지들을 묶어 컨테이너로 올리게 된다.

 

• services : 하단에 하나의 컨테이너로 묶을 각각의 이미지에 대한 정보들을 나열한다.
• image : 도커허브에 올라와있는 가져올 이미지며을 명시한다.
• container_name : 각 이미지를 담을 컨테이너 명을 뜻한다.

각각의 컨테이너 이름을 php, nginxgood으로 정의하였다. 컴포즈 파일을 정의하여 올렸을 경우, 하나의 큰 틀 안에 php, nginxgood이라는 이름으로 정의된 컨테이너들이 존재한다는 것을 확인할 수 있다.

 

• build : build아래에 지정된 경로에 존재하는 도커파일을 실행시켜 도커파일에 포함된 명령어에 따라 해당 이미지를 자신의 입맛에 맞게 바꿀 수 있다.
• context : 도커파일이 존재하는 경로를 나타낸다.
• dockerfile : 커스텀하게 만들 도커 이미지를 빌드할 때 사용한다. 자신이 생성한 Dockerfile을 경로와 함께 지정한다.
• ports : 해당 컨테이너의 포트번호를 지정한다. 포트의 지정 방식은 '로컬 포트번호 : 컨테이너 포트번호' 로 지정한다. nginx 컨테이너의 포트가 80번 포트로 지정되어 생성된 후, 외부로 공개가 된다. 생성된 컨테이너의 포트와 명시된 로컬 포트번호와 연결되어 사용이 가능해진다. 

  ---

   로컬 포트번호(8090) : 컨테이너 포트번호(80) 으로 지정되어 실행되었다고 가정해보자. nginxgood 컨테이너에 80번 포트로 웹서버가 작동하고 있다. 로컬에서 nginx를 통해 배포된 웹 애플리케이션의 내용을 확인해보기 위해서는 해당 컨테이너 포트번호와 연결된 로컬 포트번호를 활용하여 해당 내용을 확인할 수 있다. 도메인명이 localhost로 지정되어 서비스되는 경우, localhost:8090으로 웹 애플리케이션의 내용을 확인할 수 있다.

 

• volumes : '로컬 경로 : 컨테이너 경로' 로 구성된다. nginx라는 컨테이너의 /etc/nginx 경로에 nginx.conf라는 파일이 존재한다. 해당 파일을 로컬 ./nginx_update경로에 있는 nginx.conf라는 파일로 덮어씌움을 의미한다. volumes명령어를 통해 로컬환경에 작성된 소스코드를 도커환경에 적용시킬 수 있다.

 

3. 실행법

docker-compose up # docker-compose를 실행한다

docker-compose down # docker-compose를 종료한다.

docker-compose up -d

-d 옵션이 붙게되면 백그라운드에서 도커 컴포즈를 실행시킨다.