[AWS CentOS] Django Nginx uWSGI 연동하기

Django Nginx uWsgi 연동하기

AWS에서 Free Tier 서버 기본 선택 시에 설치되는 instance이며,

CentOS 이며, django는 미리 구축한 상태입니다.

( 그러나 연동을 위한 설정은 해주지 않은 상태였습니다)

아래 같은 환경에서 진행하였다.

$ cat /etc/*release*

시작 전, 위의 환경과 크게 다르다면 유의하자

0. 준비물

django는 설치되어있다는 가정하에, settings에 static 폴더와 media 폴더 경로를 설정하지 않았다면 설정해준다.

$ settings.py STATIC_URL = '/static/' STATIC_ROOT = '/{프로젝트 경로}/assets/' STATICFILES_DIRS = [ os.path.join(BASE_DIR, 'static'), ] # media file (as a upload file) MEDIA_URL = '/media/' MEDIA_ROOT = os.path.join(BASE_DIR, 'media') DATA_UPLOAD_MAX_MEMORY_SIZE = 1024000000 # value in bytes 1GB here FILE_UPLOAD_MAX_MEMORY_SIZE = 1024000000

$ urls.py from django.conf import settings from django.conf.urls.static import static urlpatterns = [ ... ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

STATIC_ROOT 경로의 assets 폴더는 제가 직접 만든 폴더이며, 이는 static폴더로 대체가 불가능하다. static폴더 경로를 써줄 경우 아래와 같은 에러가 난다.

collectstatic 명령어로 static 파일을 모을 때, STATICFILES_DIRS 폴더에 등록한 폴더들의 파일들을 STATIC_ROOT로 모으게 되기 때문에, STATIC_ROOT를 포함시키면 안된다는 이유이다.

ImproperlyConfigured: The STATICFILES_DIRS setting should not contain the STATIC_ROOT setting

(https://stackoverflow.com/questions/27213752/collecting-staticfiles-throws-improperlyconfigured)

프로젝트 경로와 프로젝트의 venv (파이썬 가상환경) 경로를 인지해두자

1. Nginx

$amazon-linux-extras install nginx1.12

설치 시

nginx 설정파일 등 경로

/etc/nginx

주요 명령어

systemctl start nginx

systemctl restart nginx

systemctl stop nginx

2. uWSGI

$ yum install -y gcc $ (venv) pip3.7 install uwsgi

설치 후 옵션 설정

$ mkdir -p /etc/uwsgi/sites $ vi /etc/uwsgi/sites/django.ini

[uwsgi] ### Django Settings # base directory chdir = /프로젝트 경로 # manage.py가 있는 폴더 # python path home = /.../venv # 파이썬 가상환경에 파이썬을 설치해두었다면 venv 경로, bin 전까지 # virtualenv path virtualenv = /.../venv # bin 전까지 # wsgi.py path module = 프로젝트명.wsgi:application master = true processes = 5 uid = root socket = /var/run/uwsgi/django.sock # 경로기억해두자 chown-socket = root:nginx chmod-socket = 666 vacuum = true logto = /프로젝트 경로/uwsgi.log

Hot Ez Ex) mkdir에서 -p 옵션이란, 폴더를 만드는 도중에 없는 폴더까지 다 만들어주는 옵션이다.

서버 재실행 등의 상황에 대비해 uwsgi를 서비스에 등록한다

$ vi /etc/systemd/system/uwsgi.service [Unit] Description=uWSGI service [Service] ExecStartPre=/bin/mkdir -p /var/run/uwsgi ExecStartPre=/bin/chown root:nginx /var/run/uwsgi ExecStart=/.../venv/bin/uwsgi --emperor /etc/uwsgi/sites Restart=always Type=notify NotifyAccess=all [Install] WantedBy=multi-user.target $ systemctl start uwsgi $ systemctl enable uwsgi

3. uWSGI < - > Django는 OK, nginx < - > uwsgi를 위하여

이제 uwsgi이 설치되었고, 이것이 django 설치 시 설치되어있던 wsgi.py를 읽어 소켓에서 수신 대기하다가 (django.sock) uwsgi 프로토콜을 통하여 통신하게된다.

nginx는 이 uwsgi와 통신하기 위하여 reverse proxy 기능을 이용한다.

nginx가 uwsgi와 통신하도록 하기 위한 설정을 해주자.

$ sudo vi /etc/nginx/conf.d user nginx; worker_processes auto; pid /run/nginx.pid; # Load dynamic modules. See /usr/share/nginx/README.dynamic. include /usr/share/nginx/modules/*.conf; events { worker_connections 1024; } http { log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"'; error_log /var/log/nginx/error.log; access_log /var/log/nginx/access.log main; sendfile on; tcp_nopush on; tcp_nodelay on; keepalive_timeout 65; types_hash_max_size 2048; include /etc/nginx/mime.types; default_type application/octet-stream; # Load modular configuration files from the /etc/nginx/conf.d directory. # See http://nginx.org/en/docs/ngx_core_module.html#include # for more information. #include /etc/nginx/conf.d/*.conf; upstream django { server unix:/var/run/uwsgi/django.sock; } server { listen 80 default_server; listen [::]:80 default_server; server_name _; root /usr/share/nginx/html; # Load configuration files for the default server block. include /etc/nginx/default.d/*.conf; location = /favicon.ico { access_log off; log_not_found off; } location / { include uwsgi_params; uwsgi_pass django; } location /static/ { alias /{프로젝트 경로}/static/; expires 30d; } location /media/ { alias /{프로젝트 경로}/media/; } error_page 404 /404.html; location = /40x.html { } error_page 500 502 503 504 /50x.html; location = /50x.html { } } }

nginx 설치 시 기본 설정되어 있는 것에서 추가된 것 ↓

upstream django { server unix:/var/run/uwsgi/django.sock; } server { ... location / { include uwsgi_params; uwsgi_pass django; } location /static/ { alias /{프로젝트 경로}/static/; expires 30d; } location /media/ { alias /{프로젝트 경로}/media/; } }

경로 설정 시 특히 주의해야 할 것은 alias 와 root 차이를 아는 것이 중요하다.

이에 실수하면 django 관리자 페이지에서 css가 보이지 않는 등 static 파일을 가져오지 못하는 현상이 일어난다.

위 설정을 마치고 다시 nginx와 uwsgi를 restart 시켜주고,

80 포트로 진입해보면 OK

잘 마무리 되었다면, 자신이 설정하였거나 설정된 파일들의 경로를 잘 기억하자

nginx 설치 경로 (자동) : /etc/nginx

uwsgi 경로 (자동) : /etc/uwsgi

django.sock 경로 : /var/run/uwsgi/django.sock

service : /etc/systemd/system/uwsgi.service

마지막으로, 기존 8000 포트로 django 만을 작업할 때에는 서버의 변경사항이 바로바로 적용된다. 하지만, 연동 완료 직후부터는 80 포트의 경우 uwsgi를 재실행 시켜주어야만 적용된다.

80포트의 경우, 서버 파일 변경 이후 $systemctl restart uwsgi

from http://zladnrms.tistory.com/79 by ccl(A) rewrite - 2020-03-06 14:54:27