FastCGI

FastCGI — это вариант развертывания на серверах, таких как nginx, lighttpd и cherokee; см. uWSGI и Контейнеры WSGI для автономной работы для других вариантов. Чтобы использовать ваше WSGI-приложение с любым из них, вам сначала потребуется сервер FastCGI. Наиболее популярным является flup, который мы будем использовать в этом руководстве. Убедитесь, что он установлен, чтобы следовать инструкциям.

Создание файла .fcgi

Сначала нужно создать файл сервера FastCGI. Назовём его yourapplication.fcgi.

#!/usr/bin/python
from flup.server.fcgi import WSGIServer
from yourapplication import app

if __name__ == '__main__':
    WSGIServer(app).run()

Этот файл достаточно для работы Apache, однако nginx и более старые версии lighttpd требуют явного указания сокета для связи с сервером FastCGI. Для этого необходимо передать путь к сокету в WSGIServer:

WSGIServer(application, bindAddress='/path/to/fcgi.sock').run()

Путь должен точно соответствовать пути, указанному в конфигурации сервера.

Сохраните файл yourapplication.fcgi в месте, где вы сможете его найти. Логично хранить его в /var/www/yourapplication или в аналогичном каталоге.

Убедитесь, что в файле установлен бит исполнения, чтобы сервера могли его запустить:

# chmod +x /var/www/yourapplication/yourapplication.fcgi

Настройка Apache

Приведённый выше пример подходит для базового развертывания Apache, но ваш файл .fcgi будет отображаться в вашем URL-адресе приложения, например, example.com/yourapplication.fcgi/news/. Существуют несколько способов настроить приложение таким образом, чтобы yourapplication.fcgi не отображался в URL. Предпочтительным способом является использование директив конфигурации ScriptAlias и SetHandler для перенаправления запросов на сервер FastCGI. Следующий пример использует FastCgiServer для запуска 5 экземпляров приложения, которые будут обрабатывать все входящие запросы:

LoadModule fastcgi_module /usr/lib64/httpd/modules/mod_fastcgi.so

FastCgiServer /var/www/html/yourapplication/app.fcgi -idle-timeout 300 -processes 5

<VirtualHost *>
    ServerName webapp1.mydomain.com
    DocumentRoot /var/www/html/yourapplication

    AddHandler fastcgi-script fcgi
    ScriptAlias / /var/www/html/yourapplication/app.fcgi/

    <Location />
        SetHandler fastcgi-script
    </Location>
</VirtualHost>

Эти процессы будут управляться Apache. Если вы используете автономный сервер FastCGI, можно использовать директиву FastCgiExternalServer вместо неё. Обратите внимание, что в следующем примере путь является условным и используется только как идентификатор для других директив, таких как AliasMatch:

FastCgiServer /var/www/html/yourapplication -host 127.0.0.1:3000

Если вы не можете установить ScriptAlias, например, на совместном веб-хостинге, можно использовать WSGI-средства для удаления yourapplication.fcgi из URL-адресов. Настройте .htaccess:

<IfModule mod_fcgid.c>
   AddHandler fcgid-script .fcgi
   <Files ~ (\.fcgi)>
       SetHandler fcgid-script
       Options +FollowSymLinks +ExecCGI
   </Files>
</IfModule>

<IfModule mod_rewrite.c>
   Options +FollowSymlinks
   RewriteEngine On
   RewriteBase /
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteRule ^(.*)$ yourapplication.fcgi/$1 [QSA,L]
</IfModule>

Установите yourapplication.fcgi:

#!/usr/bin/python
#: optional path to your local python site-packages folder
import sys
sys.path.insert(0, '<your_local_path>/lib/python2.6/site-packages')

from flup.server.fcgi import WSGIServer
from yourapplication import app

class ScriptNameStripper(object):
   def __init__(self, app):
       self.app = app

   def __call__(self, environ, start_response):
       environ['SCRIPT_NAME'] = ''
       return self.app(environ, start_response)

app = ScriptNameStripper(app)

if __name__ == '__main__':
    WSGIServer(app).run()

Настройка lighttpd

Базовая конфигурация FastCGI для lighttpd выглядит так:

fastcgi.server = ("/yourapplication.fcgi" =>
    ((
        "socket" => "/tmp/yourapplication-fcgi.sock",
        "bin-path" => "/var/www/yourapplication/yourapplication.fcgi",
        "check-local" => "disable",
        "max-procs" => 1
    ))
)

alias.url = (
    "/static/" => "/path/to/your/static"
)

url.rewrite-once = (
    "^(/static($|/.*))$" => "$1",
    "^(/.*)$" => "/yourapplication.fcgi$1"
)

Не забудьте включить модули FastCGI, alias и rewrite. Эта конфигурация связывает приложение с /yourapplication. Если вы хотите, чтобы приложение работало в корне URL, нужно обойти ошибку lighttpd с LighttpdCGIRootFix middleware.

Убедитесь, что применяете её только если вы устанавливаете приложение в корне URL. Также см. документацию Lighttpd для получения дополнительной информации о FastCGI и Python (обратите внимание, что явное передача сокета в run() больше не требуется).

Настройка nginx

Установка приложений FastCGI в nginx немного отличается, так как по умолчанию никакие параметры FastCGI не передаются.

Базовая конфигурация Flask FastCGI для nginx выглядит так:

location = /yourapplication { rewrite ^ /yourapplication/ last; }
location /yourapplication { try_files $uri @yourapplication; }
location @yourapplication {
    include fastcgi_params;
    fastcgi_split_path_info ^(/yourapplication)(.*)$;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param SCRIPT_NAME $fastcgi_script_name;
    fastcgi_pass unix:/tmp/yourapplication-fcgi.sock;
}

Эта конфигурация связывает приложение с /yourapplication. Если вы хотите разместить его в корне URL, это немного проще, так как вам не нужно вычислять PATH_INFO и SCRIPT_NAME:

location / { try_files $uri @yourapplication; }
location @yourapplication {
    include fastcgi_params;
    fastcgi_param PATH_INFO $fastcgi_script_name;
    fastcgi_param SCRIPT_NAME "";
    fastcgi_pass unix:/tmp/yourapplication-fcgi.sock;
}

Запуск процессов FastCGI

Так как nginx и другие сервера не загружают приложения FastCGI, вы должны сделать это самостоятельно. Supervisor может управлять процессами FastCGI. Вы можете поискать другие менеджеры процессов FastCGI или написать скрипт для запуска вашего файла .fcgi при запуске системы, например, используя скрипт SysV init.d. Для временного решения всегда можно запустить скрипт .fcgi внутри GNU screen. См. man screen для подробностей, и обратите внимание, что это ручное решение, которое не сохраняется после перезагрузки системы:

$ screen
$ /var/www/yourapplication/yourapplication.fcgi

Отладка

Развертывание FastCGI на большинстве веб-серверов обычно сложно отлаживать. Очень часто в логах сервера вы видите что-то вроде «преждевременное завершение заголовков». Чтобы отладить приложение, единственное, что действительно может дать вам представление о причинах сбоя, это переключение на правильного пользователя и выполнение приложения вручную.

Этот пример предполагает, что ваше приложение называется application.fcgi, а пользователь вашего веб-сервера — www-data.

$ su www-data
$ cd /var/www/yourapplication
$ python application.fcgi
Traceback (most recent call last):
  File "yourapplication.fcgi", line 4, in <module>
ImportError: No module named yourapplication

В данном случае ошибка, похоже, заключается в том, что «yourapplication» не указан в пути к python. Распространённые проблемы:

• Использование относительных путей. Не полагайтесь на текущую рабочую директорию.
• Использование кода, зависящего от переменных окружения, которые не заданы веб-сервером.
• Использование разных интерпретаторов Python.