Tornado (торнадо) – это неблокирующий, высоко производительный веб-сервер с открытыми исходным кодом. Авторами сервера являются создатели сервиса FriendFeed. Сервер реализован средствами языка Python и в силу своей неблокирующей природы (используется epoll) легко выдерживает тысячи одновременных подключений. Помимо всего прочего, Tornado поддерживает протокол WSGI, хотя и с небольшими ограничениями (будут не доступны асинхронные фичи сервера).
Механизм взаимодействия будет классическим:
* front-end – nginx, проксирующий все соединения, кроме статических файлов, на back-end
* back-end – tornado + django
Установка nginx
В первую очередь необходимо установить fron-end, коим будет являться весьма популярный http-сервер nginx. Установка проста:
sudo aptitude install nginx
Установка 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
К сожалению, tornado все еще отсутствует в стандартных репозиториях Debian / Ubuntu. Поэтому процесс установки будет выполняться непосредственно из исходных кодов. Подготовка к получению исходных кодов и компиляции:
sudo aptitude install git-core gitosis
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/bukashk0zzz.org.ua
Файл конфигурации должен выглядеть приблизительно следующим образом:
upstream backends {
server 127.0.0.1:8001;
server 127.0.0.1:8002;
}
server {
listen 80;
server_name tornado.bukashk0zzz.org.ua;
access_log /home/django-projects/bukashk0zzz/logs/nginx_access.log;
error_log /home/django-projects/bukashk0zzz/logs/nginx_error.log;
location = /robots.txt {
alias /home/django-projects/bukashk0zzz/media/robots.txt;
}
location = /favicon.ico {
alias /home/django-projects/bukashk0zzz/media/img/favicon.ico;
}
location /media/ {
alias /home/django-projects/bukashk0zzz/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/bukashk0zzz.org.ua \
/etc/nginx/sites-enabled/bukashk0zzz.org.ua
Чтобы новый хост заработал, необходимо перестартовать nginx:
sudo /etc/init.d/nginx restart
Запуск демона tornado
Для запуска Django-проекта осталось лишь запустить tornado-сервер на нужном порту с помощью wsgi-прослойки, написанной ранее:
python deploy/tornading.py 8001 &
python deploy/tornading.py 8002 &
Все. Django-проект запущен под nginx+tornado.
