Fun25 서버에서 nginx, wsgi, flask 설치하기

nginx <-> gunicorn <-> flask 를 연결하는 과정을 정리한다.

작업 환경

- Fun25 (링크) 서버 우분투 16.04 가상 서버를 사용

- 서버에서 /var/www/pystock 경로를 작업 경로로 사용

- 서버에 설치된 파이썬 3.5 버전을 사용

새로운 유저 생성

처음에는 root 계정만 주어지므로 새로운 유저를 생성하고, 생성한 유저로 플라스크를 기동하자. 아래 명령은 "pystock" 이라는 user를 생성하고 super user 권한을 갖도록 설정해준다.

# adduser pystock

# adduser pystock su

pystock 유저가 생성되면 pystock 으로 로그인하자.

※ putty, teraterm 다양한 클라이언트 프로그램을 통해 Fun25 서버에 접속할 수 있으며, 로그인 방법에 대한 설명은 생략한다.

필요한 패키지 설치

nginx, virtualenv 두 개의 모듈을 추가 설치한다.

$ sudo apt-get update

$ sudo apt-get install -y python-virtualenv nginx

virtualenv 설정

아래 명령은 /var/www/pystock 작업 경로를 만들고, 해당 경로에 venv라는 파이썬 3.5 가상 환경을 생성한다.

$ sudo mkdir -p /var/www/pystock && cd /var/www/pystock $ virtualenv venv --python=/usr/bin/python3.5

설정이 끝났으면 환경을 읽어온다. 명령창에 (venv) 문자열이 보이면 제대로 설치된 것이다.

$ source venv/bin/activate $ (venv)

플라스크

플라스크를 설치하고 간단한 앱을 만들자.

$ (venv) pip install flask

/var/www/pystock/pystock.py 파일을 만들고 아래 코드를 입력한다.

from flask import Flask app = Flask(__name__)

@app.route('/') def index(): return 'Hello Pystock!'

if __name__ == '__main__': app.run(host='0.0.0.0')

실행 시켜보자. default로 5000 번 포트로 앱이 실행된다.

$ (venv) python pystock.py * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)

비용이 저렴한 가상서버를 사용하기 때문에 (여러 사람이 같은 서버를 사용) 5000 포트를 바로 사용할 수 없다. 포트 포워딩 설정을 해줘야한다. 나의 서비스 -> 가상 서버 관리 (좌측 탭) -> 포트 포워딩 메뉴에서 5000 포트 + TCP 로 등록한다. 확인 버튼을 누르면 하나의 외부 포트를 할당받을 수 있다. 이는 서버에서 자동으로할당해 주는 값이므로 실행하는 환경마다 값이 다를 수 있다. 아래의 예제에서는 15107 포트를 할당 받았다.

이제 웹브라우저에서 접속해보자. 기본 도메인 : 외부 포트 (1510x)로 접속하면된다. Hello Pystock! 메시지를 확인 할 수 있다.

다시 콘솔창으로 돌아와서 CTRL + C를 눌러 플라스크 앱을 종료하고 이어서 nginx를 설정해보자.

nginx

nginx의 환경 설정하기에 앞서 정상 설치 여부를 확인해 보자. 우선 nginx를 시작한다. nginx는 기본으로 80 포트를 사용한다. 그래서 기본 도메인:80으로 접속해보면 nginx Welcome 화면을 확인할 수 있다. 물론 fun25 가상 서버를 사용하므로 80 대신에 포트포워딩 한 외부 포트 번호를 입력해야 한다.

$ sudo /etc/init.d/nginx start

설치시에 주어지는 기본 설정파일을 제거하고, 우리 환경에 맞는 설정 파일을 작성하자. "pystock" 이라는 이름의 환경 파일을 작성하는 예제이다. 필요한 경우 파일 이름은 변경해도 상관없지만 pystock 이름을 기준으로 설명한다.

$ (venv) sudo rm /etc/nginx/sites-enabled/default $ (venv) sudo touch /etc/nginx/sites-available/pystock $ (venv) sudo ln -s /etc/nginx/sites-available/pystock /etc/nginx/sites-enabled/pystock $ (venv) sudo vim /etc/nginx/sites-enabled/pystock

아래 설정은 80포트로 들어오는 입력을 5000번 포트로 보낸다. 사용자의 request가 80 포트로 올 경우, nginx는 flask가 동작하는 5000 포트로 명령을 연결해 준다.

server { location / { proxy_pass http://localhost:5000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /static { alias /var/www/pystock/static/; } }

이제 연결 파이썬 웹 어플리케이션을 실행해서 동작을 확인해 보자. 5000번 포트와 80 포트 어디로 접속해도 Hello Pystock 메시지를 확인할 수 있다. 확인 후 앱은 Ctrl + C를 눌러 종료.

$ (venv) sudo /etc/init.d/nginx start $ (venv) python pystock.py

gunicorn

웹싸이트에 수천명이 들어올리가 없겠지만 수천 명의 request를 처리하기 위해 wsgi 설정을 하자. wsgi에 대한 설명은 링크 로 대체한다. 본 글에서는 초보가 사용하기 좋은 gunicorn을 사용한다.

$ (venv) pip install gunicorn

아래 명령을 실행하면 gunicorn이 pystock.py를 실행시킨다. 5000번 포트와 80 포트 어디로 접속해도 Hello Pystock 메시지를 확인할 수 있다. 설정이 정말 쉽다. 이게 끝이다. 만약 파일이름을 본 글과 다르게 설정했다면 filename:app 으로 입력해주면된다. app은 flask 앱 소스코드의 app = Flask(__name__)를 가리킨다.

$ (venv) venv/bin/gunicorn pystock:app -b localhost:5000 [2017-09-03 12:43:33 +0900] [4994] [INFO] Starting gunicorn 19.7.1 [2017-09-03 12:43:33 +0900] [4994] [INFO] Listening at: http://127.0.0.1:5000 (4994) [2017-09-03 12:43:33 +0900] [4994] [INFO] Using worker: sync [2017-09-03 12:43:33 +0900] [4997] [INFO] Booting worker with pid: 4997

Supervisor

gunicorn을 손으로 매번 실행 시킬 수 없으니 자동으로 시작해주는 프로그램 supervisor를 설치하자. 글을 작성하는 현재 supervisor는 python 2.x 환경에서 동작한다. [HACK] fun25 서버는 파이썬 2.7.12를 사용하기 때문에 virtualenv를 사용하지 않고 바로 설치하도록 한다. ( 설정하기 귀찮다. 좋은게 좋은거다 )

$ (venv) sudo apt-get install -y supervisor

supervisor 설정파일로 pystock.conf를 작성한다. gunicorn의 경로를 virtualenv에 설치한 절대 경로로 입력해야한다. user는 초반에 생성했던 리눅스 유저 이름이다.

$ (venv) sudo vim /etc/supervisor/conf.d/pystock.conf

[program:pystock] command = /var/www/pystock/venv/bin/gunicorn pystock:app -b localhost:5000 directory = /var/www/pystock user = pystock

이제 supervisor를 동작시키자. pystock:started 라는 메시지가 보이면 성공!

$ (venv) sudo supervisorctl reread $ (venv) sudo supervisorctl update $ (venv) sudo supervisorctl start pystock pystock: started

Reference

https://realpython.com/blog/python/kickstarting-flask-on-ubuntu-setup-and-deployment/

http://alexandersimoes.com/hints/2015/10/28/deploying-flask-with-nginx-gunicorn-supervisor-virtualenv-on-ubuntu.html

https://stackoverflow.com/questions/13711486/gunicorn-error-no-such-file-nginx-gunicorn-supervisor

from http://mmyjh.tistory.com/270 by ccl(A) rewrite - 2020-03-06 16:20:26