what is Docker Compose? | 🐳 도커 컴포즈를 알아보자 | 실습편

🐳 🐳 🐳 🐳 🐳

 

참고 - 얄팍한 코딩사전 : 가장 쉽게 배우는 도커 - YouTube

 

 

🐳 목표 🐳

도커, 도커 컴포즈를 안다.

개념 + 실습을 남에게 설명할 수 있다.

 

학습 목표 느낌~

내일 동아리에서 도커 컴포즈를 발표해야 한다.

ㅋㅋㅋㅋ. ^^.

 

🐳 시작하기 전에.. 🐳

나의 이해도를 점검해보자!

 

그동안 동아리에서 뭘 해봤나..

뭔가 .. 이것저것 깔았다!

 

도커 깔기

도커 이미지로 mysql 다운

+ 간단한 문법

하둡 + 스파크

spark ML

카프카

 

-> 그리고 컴포즈..

 

그리고 이해가 부족한 것 같아서

데이터 엔지니어링 인프라도 공부를 해 보았다. 

 

---

🐳 그리고 얄코! 🐳

얄코의 도커 실습 구조도

 

로컬 환경의 웹을 docker로 환경 구성을 한다!

🐳 docker image - node.js ㄴ🐳🐳 frontend - dockerfile1 ㄴ🐳🐳 backend - dockerfile2 ㄴ🐳🐳 database - dockerfile3 🐳🐳🐳 docker-compose - .yml

 

🐳 목차 🐳

🐳 step 1 🐳

docker image

🐳 step 2 🐳

dockerfile

- i) frontend

- ii) backend

- iii) database

🐳 step 3 🐳

docker compose

 

 

🐳 step 1. docker image 🐳

 

(1)

실습을 위한 폴더 생성

 

실습 환경 : IDE에서 terminal 실행한 후 + WSL에 들어감,,

 

* 주의 *

윈도우는 Users > [사용자 이름] 내부에 폴더 생성하여야 함

 

(2)

실습을 위한 git 다운

 

git clone https://github.com/tomatozoo/docker-compose-without-dockerfile.git

 

* 얄코의 실습 리포지토리에서 dockerfile과 docker-compose.yml 파일을 삭제한 것임 *

 

(원래의) 실습 폴더는 방명록을 등록하는 간단한 웹페이지인데 

 

🐳 docker-practice -> application ㄴ🐳frontend -> service 1    ㄴ .css    ㄴ .js    ㄴ .html    ㄴ dockerfile ㄴ🐳backend -> service 2    ㄴ .py    ㄴ dockerfile ㄴ🐳database -> service 3    ㄴ .sql    ㄴ dockerfile 🐳 docker-compose.yml

 

로 구성되어 있다.

(여기 올린 git 리포지토리에는 없음 :))

 

도커에서 전체 리포지토리는 'application'이라고 하고

내부를 구성하는 frontend, backend, database, search engine 등을 'service'라고 한다.

 

 

(3)

이 실습에서는 로컬 환경에 node.js가 없다고 가정하고

도커 이미지를 다운 받는다.

 

$ docker run -it node

...

node image가 이미 있으면, 로컬 환경에서 설치하고

없으면 docker hub에서 찾아서 다운 받는 명령어라고 한다.

 

Welcome to Node.js v16.8.0.
Type ".help" for more information.
>

짠~

설치하지 않았지만, 이렇게 node.js이 나타나게 된다.

 

 

Docker Hub

 

위 사이트에 들어가면,

개발에 필요한 환경을 이미지 형태로 다운 받을 수 있다.

 

이때

도커의 이미지란, 리눅스의 컴퓨터의 특정 상태를 박제해놓은 것을 의미한다. 

 

node 이미지는 리눅스에 node.js가 설치된 것을 그대로 고정한 것이고

일단 로컬에서 찾아보고,

없으면 docker hub에서 찾아서 다운을 받는다. 

 

도커 이미지가 설계도라면

컨테이너는 도커 이미지를 바탕으로 만든 건물이다. 

 

 

$ docker images
REPOSITORY                 TAG       IMAGE ID       CREATED        SIZE
node                       latest    1016313cda78   2 days ago     907MB

docker images를 통해 node image가 생겼음을 확인할 수 있다.

 

tomato@DESKTOP-IP2MBOJ:/mnt/c/Users/82109/Source/Repos/practice-docker$ docker ps
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS         PORTS     NAMES
e1b735810b4c   node      "docker-entrypoint.s…"   7 minutes ago   Up 7 minutes             relaxed_yonath

docker ps

로 상태 확인

컨테이러 이름이 relaxed_yonath라서

docker exec -it [컨테이너 이름] bash로

리눅스 CLI에 접속해준다.

$ docker exec -it relaxed_yonath bash
root@e1b735810b4c:/#

컨테이너를 통해 가상의 환경에 접속한 것이다. 

 

아까 말했듯이,

도커는 리눅스 가상환경의 형태로 돌아간다. 

ls를 통해 기본 디렉토리 확인 가능함

 

 

🐳 step2. docker file 🐳

정해진 도커 이미지를 hub에서 다운 받고,

컨테이너로 만들어 터미널로 명령하는 것만으로는 충분하지 않다.

 

-> 그래서 Dockerfile을 이용한다.

 

필요에 맞게 

공식 이미지를 튜닝해서

딱 맞는 이미지로 만들어내게 된다. 

 

예를 들면, node.js와 http-server를 합치는 식(?)

 

이 실습 폴더에는 frontend, backend, database 하위 폴더에 모두

dockerfile이 있었는데.. 삭제했다 ^^

 

dockerfile의 기본적인 명령어를 공부하고

직접 frontend, backend, database의 dockerfile을 생성해보자!

 

 

(0)

🐳 dockerfile 명령어 알아보기 🐳

FROM - 베이스 이미지 저장 ex) FROM node:12.18.4 FROM 이미지명:버전정보 RUN - 이미지 생성 과정에서 명령어 실행 ex) RUN npm install -g http-server * npm : python의 pip격. Node Package Manager WORKDIR - 기본 디렉토리 설정 (같은 디렉토리에서 계속 작업하기 위해 사용) ex) WORKDIR /home/node/app 명령어 실행할 디렉토리 설정 (현위치) CMD - 도커 컨테이너가 실행되었을 때 실행되는 명령어 정의 ex) CMD ["http-server", "-p", "8080", "./public"] $ docker run --name frontend_container -v $(pwd):/home/node/app -p 8080:8080 frontend_image ?? ENV - 이미지 환경변수 지정. -e 옵션을 통해 기존 값을 가져올 수 있음.  ex) ENV MYSQL_USER mysql_user ENV MYSQL_PASSWORD mysql_password Environment variables in Compose | Docker Documentation 참고 COPY - 파일, 디렉토리를 이미지로 복사 도커환경에서 컨테이너 생성시 스크립트를 실행하는 폴더로 미리 작성된 스크립트들을 복사시킨다. ex) COPY ./scripts/ /docker-entrypoint-initdb.d/ MAINTAINER - 관리자 정보(이름, 이메일 등) ADD - ... COPY와 유사함 EXPOSE - 도커 컨테이너가 실행되었을 때 기다리는 포트(Listen) 지정

 

참고 - [Docker] 개념 정리 및 사용방법까지. (cultivo-hy.github.io)

: dockerfile reference

참고 - Get started with Docker Compose | Docker Documentation

 

# syntax=docker/dockerfile:1
FROM python:3.7-alpine
WORKDIR /code
ENV FLASK_APP=app.py
ENV FLASK_RUN_HOST=0.0.0.0
RUN apk add --no-cache gcc musl-dev linux-headers
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
EXPOSE 5000
COPY . .
CMD ["flask", "run"]

• Build an image starting with the Python 3.7 image.
• Set the working directory to /code.
• Set environment variables used by the flask command.
• Install gcc and other dependencies
• Copy requirements.txt and install the Python dependencies.
• Add metadata to the image to describe that the container is listening on port 5000
• Copy the current directory . in the project to the workdir . in the image.
• Set the default command for the container to flask run.

 

 

(1)

🐳 frontend 🐳

 

dockerfile 살펴보기

FROM node:12.18.4

# 이미지 생성 과정에서 실행할 명령어
RUN npm install -g http-server 

# 이미지 내에서 명령어를 실행할(현 위치로 잡을) 디렉토리 설정
WORKDIR /home/node/app

# 컨테이너 실행시 실행할 명령어
CMD ["http-server", "-p", "8080", "./public"]

# 이미지 생성 명령어 (현 파일과 같은 디렉토리에서)
# docker build -t {이미지명} .

# 컨테이너 생성 & 실행 명령어
# docker run --name {컨테이너명} -v $(pwd):/home/node/app -p 8080:8080 {이미지명}

 

이 도커파일을 도커 이미지로 생성한다.

 

$ docker build -t frontend_image .

..

tomato@DESKTOP-IP2MBOJ:/mnt/c/Users/82109/Source/Repos/practice-docker/frontend$ docker images
REPOSITORY       TAG       IMAGE ID       CREATED          SIZE
frontend_image   latest    91c8ec3097f3   19 seconds ago   922MB

 

docker images

명령어로 frontend_image 이미지가 만들어졌음을 확인할 수 있다. 

 

$ docker run --name frontend_container -v $(pwd):/home/node/app -p 8080:8080 frontend_image

그 다음, 이미지로 컨테이너를 생성하고 실행시킨다. 

 

 

8080번으로 송출하였기 때문에

localhost:8080에 접속하면, 웹페이지를 볼 수 있다.

 

결과

 

(2)

🐳 database 🐳

 

도커 파일로 (1) 과정 반복

 

database의 도커 파일을 살펴보자. 

 

FROM mysql:5.7

# 이미지 환경변수들 세팅
# 실전에서는 비밀번호 등을 이곳에 입력하지 말 것!
# 서버의 환경변수 등을 활용하세요.
ENV MYSQL_USER mysql_user
ENV MYSQL_PASSWORD mysql_password
ENV MYSQL_ROOT_PASSWORD mysql_root_password
ENV MYSQL_DATABASE visitlog

# 도커환경에서 컨테이너 생성시 스크립트를 실행하는 폴더로
# 미리 작성된 스크립트들을 이동
COPY ./scripts/ /docker-entrypoint-initdb.d/

# 이미지 빌드 명령어 (현 파일과 같은 디렉토리에서)
# docker build -t {이미지명} .

# 실행 명령어 (터미널에 로그 찍히는 것 보기)
# docker run --name {컨테이너명} -it -p 3306:3306 {이미지명}

# 실행 명령어 (데몬으로 실행)
# docker run --name {컨테이너명} -p 3306:3306 -d {이미지명}

 

우선, database 폴더로 이동한다. 

(cd ..)

(cd database)

$ docker build -t database_image .

 

똑같이 도커파일을 이미지로 생성해주고,

 

 

tomato@DESKTOP-IP2MBOJ:/mnt/c/Users/82109/Source/Repos/practice-docker/database$ docker run --nam
e database_container -it -p 3306:3306 database_image

 

컨테이너 생성시킨다!

 

mysql은 3306 포트가 기본이라고 한다..

 

위 명령어 대신, - d : daemon 을 추가하면,

(뒤에서 연결하라는 뜻)

ID 만 표시되고,

terminal을 사용할 수 있다.

tomato@DESKTOP-IP2MBOJ:/mnt/c/Users/82109/Source/Repos/practice-docker$ docker run --name databas
e_container -p 3306:3306 -d database_image
6e89286cdd9307656b725e16ff8990ac6281b54771bf4caaf51720d03d4f6cc6

...

 

(3)

🐳 backend 🐳

 

백엔드도 똑~같이 해준다.

 

FROM python:3.8.5

# 이미지 생성 과정에서 실행할 명령어
RUN pip3 install flask flask-cors flask-mysql

# 이미지 내에서 명령어를 실행할(현 위치로 잡을) 디렉토리 설정
WORKDIR /usr/src/app

# 컨테이너 실행시 실행할 명령어
CMD ["python3", "backend.py"]

# 이미지 생성 명령어 (현 파일과 같은 디렉토리에서)
# docker build -t {이미지명} .

# 컨테이너 생성 & 실행 명령어
# docker run --name {컨테이너명} -v $(pwd):/usr/src/app -p 5000:5000 {이미지명}

도커 파일

tomato@DESKTOP-IP2MBOJ:/mnt/c/Users/82109/Source/Repos/practice-docker$ docker ps
CONTAINER ID   IMAGE            COMMAND                  CREATED              STATUS
 PORTS                                                  NAMES
6e89286cdd93   database_image   "docker-entrypoint.s…"   About a minute ago   Up About a minute   0.0.0.0:3306->3306/tcp, :::3306->3306/tcp, 33060/tcp   database_container

 

백엔드는 파이썬의 flask로 api 서버를 돌린다. 

서비스를 구성하는 세 요소가 dockerfile이라는 미시적 설계도로 설정된다. 

 

---

 

🐳 step3. docker-compose 🐳

하나하나 이미지로 만들고

실행시키기 번거롭기 때문에

 

거시적 설계도인 docker-compose를 이용한다. 

 

docker-compose.yml 예시 파일을 살펴보자.

 

이미지의 version을 정하고,

각 service(database, backend, frontend)의 옵션들을 정해준다고 이해하면 된다. 

version: '3'
services:
  database:
    # Dockerfile이 있는 위치
    build: ./database
    # 내부에서 개방할 포트 : 외부에서 접근할 포트
    ports:
      - "3306:3306"
  backend:
    build: ./backend
    # 연결할 외부 디렉토리 : 컨테이너 내 디렉토리
    volumes:
      - ./backend:/usr/src/app
    ports:
      - "5000:5000"
    # 환경변수 설정
    environment: 
      - DBHOST=database
  frontend:
    build: ./frontend
    # 연결할 외부 디렉토리 : 컨테이너 내 디렉토리
    volumes:
      - ./frontend:/home/node/app
    ports:
      - "8080:8080"

 

결국, 앞서 일일이 컨테이너를 실행시켜준 것을

대신하기 위해 도커 컴포즈가 있으니까 말이다.

 

프론트엔드의 경우

$ docker build -t frontend_image .

$ docker run --name frontend_container -v $(pwd):/home/node/app -p 8080:8080 frontend_image

프론트엔드 컨테이너를 생성하는 명령어 조건이

(포트넘버 8080:8080 , 경로 .. /app 등)

services:
  frontend:
    build: ./frontend
    # 연결할 외부 디렉토리 : 컨테이너 내 디렉토리
    volumes:
      - ./frontend:/home/node/app
    ports:
      - "8080:8080"

compose 파일로 옮겨왔다는 것을 알 수 있다.

 

벡엔드나 데이터베이스도 마찬가지다. 

 

---

dockerfile, docker-compose.yml

파일을 다 구성했다면,

 

이제 터미널에서 실행시켜보자!

 

tomato@DESKTOP-IP2MBOJ:/mnt/c/Users/82109/Source/Repos/practice-docker$ docker-compose up

실습 폴더에서 docker-compose up 명령을 해주면..

 

로컬 호스트에서 웹사이트가 돌아가는 것을 확인할 수 있다.

 

추가적인 과정 :)

도커 컴포즈 기본 명령어

[Docker CE] docker-compose 기본 명령어 정리 :: Nirsa (tistory.com)

docker-compose --version

버전 확인

 

docker-compose up [옵션] [서비스명]

컨테이너 생성 + 실행

이때 옵션의 종류에는

1) -d : 백그라운드 실행 daemon

2) --no-deps : 링크 서비스 실행하지 않음

3) --build : 이미지 빌드

4) -t : 타임아웃 지정

 

docker-compose ps

컨테이너 상태 확인

 

docker-compose logs

컨테이너 로그 출력

 

docker-compose run

컨테이너 로그 출력

docker-compose up 명령어를 이용해 생성 및 실행된 컨테이너에서 임의의 명령을 실행하기 위해 사용 합니다.

컨테이너들을 모두 삭제할 경우 docker-compose start가 아닌, docker-compose up으로 다시 컨테이너들을 생성 해주어야 합니다. 만약 특정 서비스에서 /bin/bash를 실행시켜 쉘 환경으로 진입하고 싶다면 아래와 같은 명령어를 이용하면 됩니다. 참고로 서비스명과 컨테이너명은 다른겁니다.

서비스명은 docker-compose.yml의 services: 밑에 작성한 서비스 이름 입니다.

 

# 서비스 시작
docker-compose start

# 서비스 정지
docker-compose stop

# 서비스 일시 정지
docker-compose pause

# 서비스 일시 정지 해제
docker-compose unpause

# 서비스 재시작
docker-compose restart

서비스 시작 / 정지 / 일시정지 / 재시작

 

docker-compose rm

컨테이너 일괄 삭제

 

 

docker-compose kill [옵션]

docker-compose kill -s SIGINT

docker-compose kill

컨테이너 강제 정지

-s SIGINT 사용시 SIGINT 전달

사용하지 않으면 SIGKILL 전송

서비스 지정하면, 특정 서비스만 kill할 수 있음

 

 

 

docker-compose down

컨테이너 일괄 정지 및 삭제

 

 

 

docker-compose down --rmi all

컨테이너 일괄 삭제 (이미지까지 모두 삭제)

 

 

 

docker-compose port [서비스명] [포트번호]

프라이빗 포트번호 설정

 

 

docker-compose config

docker-compose 파일 내용 확인

 

 

추천 - Quickstart: Compose and Django | Docker Documentation

Quickstart: Compose and Django