Установка и настройка Django, Nginx и Tornado

Tornado (торнадо) - это неблокирующий, высоко производительный веб-сервер с открытыми исходным кодом. Сервер реализован средствами языка Python и в силу своей неблокирующей природы (используется epoll) легко выдерживает тысячи одновременных подключений. Помимо всего прочего, Tornado поддерживает протокол WSGI, хотя и с небольшими ограничениями (будут не доступны асинхронные фичи сервера).

Учитывая все это, можно предположить, что возможность запуска Django с помощью Tornado может стать достойной альтернативой описанному ранее способу запуска Django через FastCGI.

Механизм взаимодействия будет классическим:

front-end - nginx, проксирующий все соединения, кроме статических файлов, на back-end
back-end - tornado + django

Установка Nginx

В первую очередь необходимо установить front-end, коим будет являться весьма популярный http-сервер Nginx. Установка проста:

$ sudo aptitude install nginx

Установка Django

Далее необходимо установить фреймворк Django.

Получение исходного кода фреймворка:

$ mkdir ~/django
$ cd ~/django
$ wget http://www.djangoproject.com/download/1.1.1/tarball/
$ tar xzf Django-1.1.1.tar.gz

Установка Django:

$ python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()"
/usr/lib/python2.5/site-packages
$ sudo ln -s ~/django/Django-1.1.1/django /usr/lib/python2.5/site-packages/django
$ sudo ln -s ~/django/Django-1.1.1/django/bin/django-admin.py /usr/local/bin
$ python -c "import django; print django.VERSION;"
(1, 1, 1, 'final', 0)

Установка Tornado

Поэтому процесс установки будет выполняться непосредственно из исходных кодов. Подготовка к получению исходных кодов и компиляции:

# устанавливаем git, чтобы скачать исходный код tornado
$ sudo aptitude install git-core gitosis
# устанавливаем пакет необходимый для сборки в Debian / Ubuntu
$ sudo aptitude install python-dev build-essential

После этого необходимо получить исходный код tornado:

$ cd ~ && git clone git://github.com/facebook/tornado.git

И, наконец, выполнить установку tornado:

$ cd ~/tornado && sudo python setup.py install

Проверяем корректность установки:

$ python -c "import tornado; print 'tornado installation successfully completed';"
tornado installation successfully completed

Настройка wsgi

Чтобы заставить работать Django-код под Tornado, необходимо написать wsgi-прослойку, запускающую tornado-сервер на определенном порту и подключающую django-проект по протоколу wsgi. Код должен выглядеть приблизительно так:

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# location: deploy/tornading.py

import os
import sys

# настройки
DJANGO_ROOT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
DJANGO_APPS_DIR = os.path.join(DJANGO_ROOT_DIR, 'apps')

def daemon(iport):
    import tornado.wsgi
    import tornado.ioloop
    import tornado.httpserver

    # настраиваем Django
    sys.path.insert(0, DJANGO_APPS_DIR)
    os.environ['DJANGO_SETTINGS_MODULE'] = 'settings'
    import django.core.handlers.wsgi
    application = django.core.handlers.wsgi.WSGIHandler()

    # подключаем Tornado
    container = tornado.wsgi.WSGIContainer(application)
    http_server = tornado.httpserver.HTTPServer(container)
    http_server.listen(iport)
    tornado.ioloop.IOLoop.instance().start()

if __name__ == "__main__":
    # на вход должен быть передан порт,
    # на котором будет запущен tornado-сервер
    daemon(int(sys.argv[1]))

При этом предполагается, что код проекта распределен следующим образом:

$ tree -d  -L 1
.               # корень django-проекта
|-- apps        # django-приложения
|-- cache
|-- deploy
|-- logs
|-- media
`-- templates   # django-шаблоны


Настройка nginx

После того, как tornado-сервер запущен, можно переходить к настройке nginx:

$ sudo vim /etc/nginx/sites-available/mysite.ru

Файл конфигурации должен выглядеть приблизительно следующим образом:

upstream backends {
    server 127.0.0.1:8001;
    server 127.0.0.1:8002;
}

server {
    listen   80;
    server_name tornado.mysite.ru;

    access_log /home/django-projects/mysite_ru/logs/nginx_access.log;
    error_log /home/django-projects/mysite_ru/logs/nginx_error.log;

    location = /robots.txt {
        alias /home/django-projects/mysite_ru/media/robots.txt;
    }

    location = /favicon.ico {
        alias /home/django-projects/mysite_ru/media/img/favicon.ico;
    }

    location /media/ {
        alias /home/django-projects/mysite_ru/media/;
        expires 30d;
    }

    location /media_admin/ {
        alias /usr/lib/python2.6/dist-packages/django/contrib/admin/media/;
        expires 30d;
    }

    location / {
        proxy_pass http://backends;
        proxy_redirect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Далее, необходимо включить хост:

$ sudo ln -s /etc/nginx/sites-available/mysite.ru \
         /etc/nginx/sites-enabled/mysite.ru

Чтобы новый хост заработал, необходимо перестартовать nginx:

$ sudo /etc/init.d/nginx restart

Запуск демона Tornado

Для запуска Django-проекта осталось лишь запустить Tornado-сервер на нужном порту с помощью wsgi-прослойки, написанной ранее:

$ python deploy/tornading.py 8001 &
$ python deploy/tornading.py 8002 &

Все. Django-проект запущен под Nginx + Tornado.

Для того, чтобы убедиться, что все настроено правильно, необходимо открыть в браузере url: "http://tornado.mysite.ru" (или тот, который прописан в Вашем виртуальном хосте Nginx) и убедиться в наличии надписи:

It worked!
Congratulations on your first Django-powered page.

Остается лишь написать скрипт для автозапуска Tornado-серверов и мониторинга их работоспособности.