gunicorn 을 사용하는 이유

기본 flask 서버는 개발용이고 배포용으로 적합하지 않다고 한다. flask를 단독으로 실행하면 단일 프로세스가 생성되고 한개의 프로세스가 여러 Request 요청을 처리하게 된다. 즉 Request 요청이 많아지면 서버에 병목이 생기게 된다. WSGI는 여러개의 쓰레드를 생성하여 요청을 병렬로 처리해주기 때문에 단독으로 flask를 사용할 때 보다 성능상으로 뛰어나다.

nginx, gunicorn 설치

# install
        $ apt install nginx
        $ apt install gunicorn

샘플 코드 실행해보기

# 프로젝트 폳러 생성
        $ mkdir sample_flask
        $ cd sample_flask
        # 가상환경 생성
        $ python3 -m venv venv
        # 가상환경 activating
        $ . venv/bin/activate
        $ pip install flask
        $ pip install gunicorn
        # gunicorn 실행경로 확인
        # 정상적으로 설치가 되었으면 가상환경에 설치된 gunicorn 경로 표시
        $ which gunicorn
        # 패키지 확인
        $ pip freeze
        $ viㅡ app.py

flask app 코드

from flask import Flask
        app = Flask(__name__)
        @app.route("/")
        def index():
            return "hello world"
        if __name__ == "__main__":
            app.run()

gunicorn 연결

$ gunicorn --bind 0.0.0.0:8000 app:app &
        [2021-09-19 00:56:23 +0900] [274730] [INFO] Starting gunicorn 20.1.0
        [2021-09-19 00:56:23 +0900] [274730] [INFO] Listening at: http://0.0.0.0:8000 (274730)
        [2021-09-19 00:56:23 +0900] [274730] [INFO] Using worker: sync
        [2021-09-19 00:56:23 +0900] [274732] [INFO] Booting worker with pid: 274732
        # 접속 확인
        $ wget localhost:8000
        $ cat index.html
        hello world

이상 없으면 리눅스 서비스 등록하기

리눅스 서비스 생성

# /etc/systemd/system
        # flaskapp.service 생성
        [Unit]
        Description=gunicorn daemon
        After=network.target
        [Service]
        User=root
        Group=root
        WorkingDirectory=/home/username/sample_flask
        ExecStart=/home/username/sample_flask/venv/bin/gunicorn \
                --workers 5 \
                --bind unix:/tmp/gunicorn.sock \
                app:app
        [Install]
        WantedBy=multi-user.target

tmp 디렉터리에 gunicorn.sock 파일을 생성하여 바인딩 /tmp 디렉터리에 소켓 파일이 생성된다. 생성된 소켓파일은 웹서버에서 리버시 프록시를 구성할 때 사용할 수 있다.

서비스 파일을 생성하였으면 서비스를 실행해서 정상적으로 작동하는지 확인해보자.

$ systemctl start flaskapp
        $ systemctl status flaskapp
        ubuntu systemd[1]: Started gunicorn daemon.
        ubuntu gunicorn[3449]: [2021-09-19 01:45:39 +0900] [3449] [INFO] Starting gunicorn 20.1.0
        ubuntu gunicorn[3449]: [2021-09-19 01:45:39 +0900] [3449] [INFO] Listening at: unix:/tmp/gunicorn.sock>
        ubuntu gunicorn[3449]: [2021-09-19 01:45:39 +0900] [3449] [INFO] Using worker: sync

nginx conf 파일 생성

# /etc/nginx/conf.d
        # flaskapp.conf 생성
        server {
            listen 80;
            server_name 2yk.kr;
            location '/' {
                proxy_pass http://unix:/tmp/gunicorn.sock;
            }
        }

nginx를 재시작한다.

# 설정에 문제가 없는지 체크
        $ nginx -t
        nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
        # 문제가 없다면? 재시작
        $ sytemctl restart nginx

테스트를 하기 위해 브라우저를 통해 아이피 또는 도메인을 입력하여 접속한다

참조

[Python flask] nginx gunicorn 이용하여 flask앱 배포하기