[Docker] Django 앱 Docker 이미지로 배포하기

Intro

지인들과 사이드 프로젝트로 개발한 Django 앱을 deploy 해보는 예제로 Docker Image를 배포하는 간단한 hands on 을 소개해보겠습니다. Docker Image로 관리하는게 배포할 때 버전관리나 환경 구축 시에 편리할 것 같아서 Image화하였습니다. 아래의 Git Repository 가 개발한 Django 앱 입니다. 

https://github.com/FoodieZone/Backend 

GitHub - FoodieZone/Backend

작업 및 배포 환경 

• Host Server : ubuntu 22.04
• Cloud Service : AWS EC2 인스턴스
• Docker Engine 의 경우, Host Server 에 맞추어 설치했습니다. 

 

Django 앱을 Docker Image로 만들기 위해서는 Dockerfile을 작성해주어야 합니다. 

FROM python:3.9.16
LABEL maintainer="freemjstudio <mjwoo001@gmail.com>"
RUN apt-get -y update

RUN python3 -m venv venv && . venv/bin/activate
RUN mkdir /srv/dev-server
ADD src /srv/dev-server
COPY requirements.txt /srv/dev-server/requirements.txt

WORKDIR /srv/dev-server

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

CMD ["python3", "manage.py", "runserver", "0.0.0.0:8080"]
EXPOSE 8080

 

FROM

Python Base Image를 지정합니다. Dockerfile에서 반드시 지정해주어야 합니다. 

LABEL maintainer 

기존의 MAINTAINER 키워드로, 해당 docker Image의 작업자가 누구인지 정보를 남길 수 있습니다. 

RUN

shell 명령어 또는 list 에 담는 exec 형식으로 실행시킬 명령을 지정할 수 있습니다. 

ADD vs COPY 

ADD와 COPY 모두 파일을 현재 파일 시스템 (local) 에서 도커 컨테이너 내부의 파일 시스템으로 복사합니다. 차이점은 다음과 같습니다. 

• COPY : 소스 파일이나 특정 디렉토리를 컨테이너 내부의 지정된 경로로 복사합니다. 
• ADD : COPY 와 다른 추가 기능으로 URL 을 복사할 대상으로 사용할 수 있습니다.

WORKDIR 

해당 디렉토리로 이동하여 작업을 진행합니다. 

EXPOSE

Docker 컨테이너가 리스닝할 포트를 지정한다. 그렇지만 EXPOSE 자체로는 실제로 port 를 여는 것이 아니라, 컨테이너가 어떤 특정 포트를 사용할 것인지 알려주는 역할을 한다. 

 

Dockerfile을 작성한 경로에 다음의 명령어를 실행합니다. Docker Image 생성을 위한 디렉토리를 따로 하나 생성한 후 그 디렉토리에서 분리하여 작업해주는 것이 권장됩니다. 

$ docker build -t NEW_IMAGE_NAME .

 

실행 과정은 다음과 같습니다. Dockerfile은 명령 한줄마다 이미지를 하나씩 생성합니다. docker history 명령어로 실행된 작업 내용 히스토리를 조회해볼 수 있습니다. 

도커 이미지가 제대로 생성되었는지 확인합니다. docker images 명령어는 현재 host server에 저장되어 있는 image를 list up 합니다. 

$ docker images

 

repository 에 올리기 위해서 tag 를 변경해줍니다. '본인의 Docker Hub ID/'를 접두어로 추가하여 변경합니다. 

$ docker image tag DOCKER_IMAGE_ID YOUR_DOCKER_HUB_ID/DOCKER_IMAGE_NAME

 

docker Hub ID/PW를 사용하여 현재의 docker host환경에서 hub 로 인증을 한 후, 생성한 도커 이미지를 Hub에 올립니다. 

$ docker push freemjstudio/foodie-django

 

생성한 Docker Image 기반으로 컨테이너를 실행시킵니다. 여러개의 컨테이너를 동시에 띄우고 싶은 경우 Docker Compose 를 활용해볼 수 있습니다. -p 또는 --publish 플래그는 도커 호스트와 도커 컨테이너 간의 포트 매핑을 설정해주는 명령어 입니다. 이 경우 8080 포트로 포트포워딩해주었는데, 도커 파일을 작성시에 'EXPOSE 8080' 으로 Django App을 8080 포트를 사용할 것이라고 명시했기 때문입니다. 

$ docker run -d -p 8080:8080 DOCKER_IMAGE_NAME

배포 후, YOUR_HOST_ADDRESS:8080 으로 정상적으로 접속이 되는지 테스트해 볼 수 있습니다. 

 

이로써, Django 앱을 Dockerfile 작성을 통해 도커 이미지를 생성하고, 도커 이미지 기반의 컨테이너로 앱을 배포하는 과정에 대해 알아보았습니다. Django 앱 뿐만 아니라, 어떠한 어플리케이션이든 Dockerfile 작성 후 비슷한 과정으로 배포해볼 수 있을 것 같습니다. 

• Docker Hub에 올라간 장고 앱 배포 도커 이미지입니다. 

https://hub.docker.com/r/freemjstudio/foodie-django

Docker