Django를 virtaualenv에 설치하고, 새 프로젝트를 만들고, 프로젝트에 cd 한다.

pip install Django
django-admin.py startproject mysite
cd mysite

도메인 및 포트 정보

이 튜토리얼에선 우리는 당신의 도메인을 example.com. 로 부를것이다. 자신의 FQDN 또는 IP 주소로 대체해라.

처음부터 Django runserver가 기본적으로 수행하는 것 처럼, 우리는 웹 서버가 게시할 포트 8000을 사용할 것이다. 물론 원하는 모든 포트를 사용할 수 있지만 이 포트를 선택했으므로 웹 서버가 이미 수행중인 것과 충돌하지 않는다.


기본 uWSGI 설치 및 구성

uWSGI를 virtualenv에 설치해라.

pip install uwsgi

물론 uWSGI를 설치하는 다른 방법이 있지만 이 방법은 다른 어떤 방법과 마찬가지로 좋다. 파이썬 개발 패키지가 설치되어 있어야 한다. 데비안 또는 우분투와 같은 데비안에서 파생된 시스템의 경우, 설치해야 할 것은 pythonX.Y-dev 이다. 여기서 X.Y는 파이썬의 버전이다.


기본 테스트

 test.py 라는 파일을 만든다.

# test.py
def application(env, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    return [b"Hello World"] # python3
    #return ["Hello World"] # python2

Note

파이썬3 에는 bytes()가 필요하다는 것을 고려해라.

uWSGI 실행

uwsgi --http :8000 --wsgi-file test.py

옵션의 의미 : 

  • http :8000: 프로토콜 http, 포트 8000
  • wsgi-file test.py: 지정된 파일을 로드, test.py

이렇게 하면 포트 8000의 브라우저에 ‘hello world’ 이라는 메시지가 직접 전달된다.

http://example.com:8000

확인해보고, 실행이 된다면 다음 구성 요소 스택이 작동함을 의미한다

the web client <-> uWSGI <-> Python

Django 프로젝트 테스트

이제 우리는 uWSGI가 test.py 모듈 대신 Django 사이트를 실행하기를 원한다.

아직 그렇게 하지 않았다면 mysite 프로젝트가 실제 작동하는지 확인해보아라.

python manage.py runserver 0.0.0.0:8000

작동하는 경우 uWSGI를 사용하여 실행하시오.

uwsgi --http :8000 --module mysite.wsgi
  • module mysite.wsgi: 지정된 wsgi 모듈을로드합니다.

브라우저에서 서버를 가리키고, 사이트가 나타나면 uWSGI가 virtualenv에서 장고 응용 프로그램을 제공 할 수 있음을 의미하며 이 스택은 올바르게 작동하는 것이다.

the web client <-> uWSGI <-> Django

N이제는 브라우저가 uWSGI에 직접 말하도록 하지 않을 것이다. 이것이 웹 서버의 일이며, 이는 중간자 역할을 할 것이다.


nginx 기본

nginx 설치

sudo apt-get install nginx
sudo /etc/init.d/nginx start    # start nginx

그리고 지금 nginx가 80번 포트의 웹 브라우저에서 제공하는지 확인해라. nginx: “Welcome to nginx!” 라는 메시지를 받아야 한다. 이는 전체 스택의 다음 구성 요소가 함께 작동 함을 의미한다.

the web client <-> the web server

다른 포트가 이미 포트 80에서 제공되고 있고 거기에 nginx를 사용하려면 다른 포트에서 서비스하도록 nginx를 다시 구성해야한다. 이 튜토리얼에서는 포트 8000을 사용하려 한다.


당신의 사이트에 nginx 구성

uWSGI 배포판의 nginx 디렉토리 또는 https://github.com/nginx/nginx/blob/master/conf/uwsgi_params 에서 구할 수 있는 uwsgi_params 파일이 필요하다. 

프로젝트 디렉토리에 복사해라. 잠시 후 우리는 nginx에게 그것을 가리키도록 할것이다.

이제 mysite_nginx.conf 라는 파일을 만들고 안에 다음과 같이 입력하여라.

# mysite_nginx.conf

# the upstream component nginx needs to connect to
upstream django {
    # server unix:///path/to/your/mysite/mysite.sock; # for a file socket
    server 127.0.0.1:8001; # for a web port socket (we'll use this first)
}

# configuration of the server
server {
    # the port your site will be served on
    listen      8000;
    # the domain name it will serve for
    server_name .example.com; # substitute your machine's IP address or FQDN
    charset     utf-8;

    # max upload size
    client_max_body_size 75M;   # adjust to taste

    # Django media
    location /media  {
        alias /path/to/your/mysite/media;  # your Django project's media files - amend as required
    }

    location /static {
        alias /path/to/your/mysite/static; # your Django project's static files - amend as required
    }

    # Finally, send all non-media requests to the Django server.
    location / {
        uwsgi_pass  django;
        include     /path/to/your/mysite/uwsgi_params; # the uwsgi_params file you installed
    }
}

이 conf 파일은 nginx에게 파일 시스템의 미디어와 정적 파일을 제공할 뿐만 아니라 장고의 개입이 필요한 요청을 처리하도록 지시한다. 대용량 배포의 경우 한 서버에서 static/media 파일을 처리하고 또 다른 처리에서는 Django 응용 프로그램을 처리하도록 하는 것이 좋지만 지금은 정상적으로 수행될 것이다.

이 파일을 /etc/nginx/sites-enabled 에서 심볼릭 링크를 함으로 nginx 가 볼 수 있다.

sudo ln -s ~/path/to/your/mysite/mysite_nginx.conf /etc/nginx/sites-enabled/

정적 파일 배포

nginx를 실행하기 전에 모든 장고 정적 파일을 정적 폴더에 수집해야한다. 우선 mysite/setting.py 를 수정해야한다.

STATIC_ROOT = os.path.join(BASE_DIR, "static/")

그리고 실행

python manage.py collectstatic

nginx 기본 테스트

nginx 다시시작

sudo /etc/init.d/nginx restart

미디어 파일이 올바르게 제공되는지 확인하려면 media.png 라는 이미지를  /path/to/your/project/project/media 디렉토리에 추가한 다음  http://example.com:8000/media/media.png 에 방문해라. - 작동한다면, 적어도 nginx 파일을 올바르게 제공하는지 알게 된다.

nginx를 재시작 하는 것만으로는 안되지만, 실제로 멈추었다가 다시 시작한다면 문제가 있는지, 어디에 있는지 알 수 있다.


nginx, uWSGI 그리고 test.py

nginx가 "hello world" 를 말해보게 해보자 (Let’s get nginx to speak to the “hello world” test.py application.)

uwsgi --socket :8001 --wsgi-file test.py

이 옵션을 제외하고는 이전과 거의 같다.

  • socket :8001: 프로토콜 uWSGI, 포트 8001 사용

한편 nginx는 해당 포트의 uWSGI와 통신하고 포트 8000의 외부 세계와 통신하도록 구성되었다. 이곳을 방문 :

http://example.com:8000/

확인해보아라, 그리고 이것이 우리의 스택이다.

the web client <-> the web server <-> the socket <-> uWSGI <-> Python

한편 http://example.com:8001 에서 uWSGI 출력을 살펴볼 수 있다. - uWSGI가 아니라 http를 말하고 있기 때문에 작동하지 않을 것이다. 하지만 터미널에 uWSGI의 출력이 표시되어야 한다.


포트 대신 Unix 소켓 사용

지금까지 우리는 TCP 포트 소켓을 사용했다. 왜냐하면 더 간단하기 때문이다. 하지만 포트보다 Unix 소켓을 사용하는것이 더 낫다. 오버헤드가 적기 때문이다.

 mysite_nginx.conf 를 다음과 같이 변경.

server unix:///path/to/your/mysite/mysite.sock; # for a file socket
# server 127.0.0.1:8001; # for a web port socket (we'll use this first)

nginx 를 다시 시작해라. 

uWSGI 를 다시 실행해라.

uwsgi --socket mysite.sock --wsgi-file test.py

이번에는 socket 옵션을 사용하여 uWSGI에게 사용할 파일을 알려준다.

브라우저에서 http://example.com:8000/ 을 접속.


작동하지 않는 경우

nginx 오류 로그(/var/log/nginx/error.log)를 확인하고, 다음과 같은 메시지가 표시된다면

connect() to unix:///path/to/your/mysite/mysite.sock failed (13: Permission
denied)

아마 nginx가 소켓을 사용할 수 있도록 소켓에 대한 권한을 관리해야 할 것이다.

다음을 시도:

uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=666 # (very permissive)

혹은:

uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=664 # (more sensible)

nginx가 당신의 소켓을 적절히 읽고 쓸 수 있도록 nginx의 그룹 (아마도 www-데이터)에 사용자를 추가해야 하거나 그 반대일 수 도 있다.

nginx 로그 출력을 터미널 창에서 계속 실행하면 문제를 해결하는 동안 쉽게 참조할 수 있을것이다.


uWSGI 및 nginx를 사용하여 django 응용프로그램 실행

django를 실행해 본다.

uwsgi --socket mysite.sock --module mysite.wsgi --chmod-socket=664

이제 uWSGI와 nginx는 "Hello World"모듈이 아니라 Django 프로젝트를 지원해야한다.


.ini 파일로 실행되도록 uWSGI 구성

우리는 uWSGI에서 사용했던 것과 동일한 옵션을 파일에 넣을 수 있으며, uWSGI에 해당 파일을 실행하도록 요청할 수 있다. 이를 통해 구성을 보다 쉽게 관리할 수 있다.

 `mysite_uwsgi.ini` 라는 파일을 생성 :

# mysite_uwsgi.ini file
[uwsgi]

# Django-related settings
# the base directory (full path)
chdir           = /path/to/your/project
# Django's wsgi file
module          = project.wsgi
# the virtualenv (full path)
home            = /path/to/virtualenv

# process-related settings
# master
master          = true
# maximum number of worker processes
processes       = 10
# the socket (use the full path to be safe
socket          = /path/to/your/project/mysite.sock
# ... with appropriate permissions - may be needed
# chmod-socket    = 664
# clear environment on exit
vacuum          = true

그리고 이 파일을 사용하여 uWSGI를 실행한다 :

uwsgi --ini mysite_uwsgi.ini # the --ini option is used to specify a file

다시 한번 Django 사이트가 예상대로 작동하는지 테스트 해라.


uWSGI 시스템 전체 설치

지금까지 uWSGI는 virtualenv에만 설치되었다. 배포 목적으로 시스템 전체에 설치해야 한다.

virtualenv 비활성화 :

deactivate

시스템 전체에 uWSGI를 설치 :

sudo pip install uwsgi

# Or install LTS (long term support).
pip install https://projects.unbit.it/downloads/uwsgi-lts.tar.gz

uWSGI wiki에서는 몇가지 설치절차를 설명한다. 시스템 전반에 걸쳐 uWSGI를 설치하기 전에 설택할 버전과 가장 적절한 설치 방법을 고려해야 한다.

이전과 마찬가지로 uWSGI를 실행할 수 있는지 확인해보아라. 

uwsgi --ini mysite_uwsgi.ini # the --ini option is used to specify a file


Emperor mode

uWSGI는 Emperor mode 에서 실행할 수 있다. 이 모드에서는 uWSGI 설정 파일의 디렉토리를 감시하고 발견된 각각의 인스턴스 ('vassals')를 생성한다.

설정 파일이 수정 될 때마다 Emperor는 vassal을 다시 시작한다.

# create a directory for the vassals
sudo mkdir /etc/uwsgi
sudo mkdir /etc/uwsgi/vassals
# symlink from the default config directory to your config file
sudo ln -s /path/to/your/mysite/mysite_uwsgi.ini /etc/uwsgi/vassals/
# run the emperor
uwsgi --emperor /etc/uwsgi/vassals --uid www-data --gid www-data

sudo를 사용하여 uWSGI를 실행해야 할 수도 있다.

sudo uwsgi --emperor /etc/uwsgi/vassals --uid www-data --gid www-data

옵션의 의미 :

  • emperor: vassals (config 파일)를 찾을 곳
  • uid: 프로세스가 시작되면 프로세스의 사용자 ID
  • gid: 일단 시작된 프로세스의 그룹 ID (the group id of the process once it’s started)

사이트를 확인하여라, 실행중이어야 한다.


시스템 부팅시 uWSGI 시작

마지막 단계는 시스템 시작시 자동으로 모든것을 수행하는 것이다.

많은 시스템에서 가장 쉬운 방법은 rc.local 파일을 사용하는 것이다.

 /etc/rc.local 을 편집하고 다음을 추가 :

/usr/local/bin/uwsgi --emperor /etc/uwsgi/vassals --uid www-data --gid www-data --daemonize /var/log/uwsgi-emperor.log

“exit 0” 가 있는 라인 전에 추가해야 한다.

And that should be it!


추가 구성

이것은 시작하기 위한 튜토리얼이었음을 알아야 한다. nginx 및 uWSGI 문서를 읽고 프로덕션 환경에 배포하기 전에 사용 가능한 옵션을 연구해야 한다.

nginx와 uWSGI 모두 친숙한 커뮤니티에서 이익을 얻을 수 있다. 친숙한 커뮤니티는 구성 및 사용법에 대한 귀중한 조언을 제공할 수 있다.


nginx

nginx의 일반적인 설정은 튜토리얼의 범위를 벗어난다, 당신은 제작 웹사이트를 8000번 포트가 아닌 80번 포트에서 수신하기를 원할것이다. (의역 ㅠ)

또한 Django가 아닌 파일을 제공하기 위해 별도의 nginx 위치 블록을 구성해야한다. 예를들어, uWSGI를 통해 정적파일을 제공하는 것은 비효율적이다. 대신 nginx에서 직접 서비스하고 uWSGI를 완전히 우회해라.


uWSGI

uWSGI는 이를 구성하는 여러가지 방법을 지원한다. uWSGI 문서 와 예제 를 참조하여라.

이 튜토리얼에서 프로덕션 환경에서 배포할 때 고려해야하는 일부 uWSGI 옵션에 대해 설명하려 한다. (예제 설정과 함께 여기 나열한다.)

env = DJANGO_SETTINGS_MODULE=mysite.settings # set an environment variable
safe-pidfile = /tmp/project-master.pid # create a pidfile
harakiri = 20 # respawn processes taking more than 20 seconds
limit-as = 128 # limit the project to 128 MB
max-requests = 5000 # respawn processes after serving 5000 requests
daemonize = /var/log/uwsgi/yourproject.log # background the process & log