도커 설정(Django-Nginx-uWSGI-MySQL)

0. 도커 설치

# CentOS
# 1. Docker 설치
$ yum install docker-ce docker-ce-cli containerd.io
$ systemctl start docker
$ systemctl enable docker

# 2. docker-compose 설치
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ chmod +x /usr/local/bin/docker-compose
$ ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

1. Mysql 컨테이너

• Mysql은 Dockerfile을 작성하지 않고 도커허브에 올라와 있는 공식 image를 사용할 것이다.
• docker-compose.yml의 mysql 컨테이너 부분은 다음과 같다.

services:
  database:
    image: mysql:5.7        # mysql 5.7 공식 이미지
    container_name: mysql
    restart: always
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=${DB_ROOT_PASSWORD}
      - MYSQL_DATABASE=${DB_DATABASE}
    volumes:
      - ./database/mysql_data:/var/lib/mysql    # 컨테이너의 데이터를 호스트OS에 저장되도록 설정 
    command:
      - --character-set-server=utf8mb4          # 인코딩
      - --collation-server=utf8mb4_unicode_ci   # 인코딩

→ MYSQL_ROOT_PASSWORD 환경변수는 필수값이다

• 비밀번호가 유출되면 안되기 때문에 따로 작성해 놓을 수 있다.
• docker-compose.yml과 같은 경로에 .env 파일을 생성한다.

DB_ROOT_PASSWORD=rootpassword
DB_DATABASE=mypro

2. Backend 컨테이너 (Python, Django, uWSGI)

• Backend 도커파일

FROM python:3.8

ENV PYTHONUNBUFFERED 1            #

RUN apt-get -y update
RUN apt-get -y install build-essential python3-dev    # 파이썬 패키지 설치에 필요한 패키지 설치

RUN mkdir /usr/local/mypro

WORKDIR /usr/local/mypro

COPY requirements.txt .                               # 의존성 파일 먼저 복사하여 패키지 설치

RUN pip install --upgrade pip
RUN pip install -r requirements.txt

COPY . .

→ COPY requirements.txt .를 먼저 실행 해야 의존성 파일을 매번 다운받지 않아도 된다.
→ 그 후, COPY . .를 실행하여 backend폴더 전체를 컨테이너로 복사시킨다.

• uwsgi.ini (uWSGI 설정파일)

[uwsgi]
# Django-related settings
chdir           = /usr/local/mypro/
module          = mypro.wsgi:application

# process-related settings
master          = true
processes       = 10
socket          = /usr/local/mypro/uwsgi.sock     # 유닉스소켓
chmod-socket    = 666
vacuum          = true

# respawn processes after serving 1000 requests
max-requests = 1000
buffer-size = 65535

# respawn processes taking more than 60 seconds
harakiri = 60

# 배포시 0으로
py-autoreload = 0

logger = file:/var/log/uwsgi/uwsgi.log

3. Nginx 컨테이너

• Nginx 도커파일

FROM nginx:latest

COPY nginx.conf /etc/nginx/nginx.conf               # nginx 설정파일 복사
COPY mypro.conf /etc/nginx/conf.d/mypro.conf          # nginx 기본 설정파일 복사

CMD ["nginx", "-g", "daemon off;"]

→ Nginx는 CMD를 docker-compose.yml에 작성하지 않고 도커파일에 직접 작성한다

• mypro.conf (Nginx 설정파일)

upstream django {
     server unix:///usr/local/mypro/uwsgi.sock; 
}

server {
        listen 80;
        server_name 127.0.0.1;

	charset utf-8;

	location = /favicon.ico { access_log off; log_not_found off; }

	location / {
            include         /etc/nginx/uwsgi_params;
            uwsgi_pass      django;
        }
}

→ uWSGI 컨테이너가 생성한 uwsgi.sock을 사용한다.

4. docker-compose.yml 작성

• 이제 mysql + backend + nginx 컨테이너를 결합하기 위해 docker-compose.yml을 작성한다.
• docker-compose는 각 서비스의 Dockerfile을 빌드한 후 run하여 컨테이너를 실행시키고 각 컨테이너들을 서로 연결하는 역할을 합니다.

version: "3"
services:
  database:
    image: mysql:5.7
    container_name: mysql
    restart: always
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=${DB_ROOT_PASSWORD}
      - MYSQL_DATABASE=${DB_DATABASE}
    volumes:
      - ./database/mysql_data:/var/lib/mysql
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
  backend:
    image: europani/mypro_backend         # image 이름&태그 설정 (태그 : latest)
    build:                                # 해당 context의 dockerfile을 사용하여 build 진행
      context: ./backend
      dockerfile: Dockerfile-dev
    container_name: backend
    restart: always
    ports:
      - "8000:8000"
    volumes:
      - ./backend:/usr/local/mypro
      - ./log/backend:/var/log/uwsgi
    command: uwsgi --ini uwsgi.ini
  nginx:
    image: europani/mypro_nginx
    build:
      context: ./nginx
      dockerfile: Dockerfile-dev
    container_name: nginx
    restart: always
    ports:
      - "80:80"
    volumes:
      - ./backend:/usr/local/mypro
      - ./log/nginx:/var/log/nginx

• 디렉토리 구조
  프로젝트명 : mypro

/usr/local/mypro
 │
 ├── backend         
 │   ├── Dockerfile
 │   ├── .dockerignore
 │   ├── .gitignore     # backend용
 │   ├── manage.py
 │   ├── README.md
 │   ├── requirements.txt
 │   ├── config
 │   │   └── comfig.yml
 │   ├── mypro
 │   │   ├── __init__.py 
 │   │   ├── asgi.py 
 │   │   ├── settings.py 
 │   │   ├── urls.py 
 │   │   └── wsgi.py 
 │   ├── uwsgi.sock      # 유닉스소켓
 │   └── uwsgi.ini       # uWSGI 설정파일
 │
 ├── frontend           
 │   ├── Dockerfile
 │   ├── .gitignore
 │   ├── 
 │   
 ├── database           
 │   ├── .gitignore
 │   └── mysql_data       # DB 데이터
 │   
 ├── nginx           
 │   ├── Dockerfile
 │   ├── .gitignore
 │   ├── nginx.conf
 │   └── mypro.conf        # nginx 설정파일 
 │
 ├── .gitignore            # backend 제외한 나머지 폴더  
 ├── docker-compose.yml
 └── log/

• backend/.dockerignore
  • uwsgi.sock 파일은 도커 컨테이너로 복사되지 않도록 제외한다.

*.sock

5. 도커 허브에 업로드

• 빌드 되어 설정된 이미지의 이름&태그 그대로 도커허브에 업로드된다. (europani 계정)
• 도커 허브에 업로드 하기 위해 docker-compose.yml에서 image 이름을 계정이름을 포함하여 europani/mypro_backend로 설정한 것이다.

$ docker push europani/mypro_backend
$ docker push europani/mypro_nginx

정리

• Host OS : CentOS7
• 호스트OS에 도커를 설치 한 후 호스트OS위에 올려 독립적인 database, backend, nginx 도커 컨테이너를 올려 실행한다.
• 각 도커 컨테이너는 각 Dockerfile를 빌드하여 만들어진다.
• 각 각의 독립적인 컨테이너을 연결할 때는 docker-compose.yml를 이용한다.
• backend 코드가 변경시 docker-compose down / up 명령어를 사용하여 컨테이너를 갱신시켜 주고 Dockerfile이 변경시 빌드를 다시 한 다음 컨테이너를 갱신해야 한다.