diff options
Diffstat (limited to 'studio/static/doc/flask-docs/deploying/fastcgi.html')
-rw-r--r-- | studio/static/doc/flask-docs/deploying/fastcgi.html | 259 |
1 files changed, 0 insertions, 259 deletions
diff --git a/studio/static/doc/flask-docs/deploying/fastcgi.html b/studio/static/doc/flask-docs/deploying/fastcgi.html deleted file mode 100644 index 7431826..0000000 --- a/studio/static/doc/flask-docs/deploying/fastcgi.html +++ /dev/null @@ -1,259 +0,0 @@ - -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>FastCGI — Flask 0.8 documentation</title> - - <link rel="stylesheet" href="../_static/flasky.css" type="text/css" /> - <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: '../', - VERSION: '0.8', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="../_static/jquery.js"></script> - <script type="text/javascript" src="../_static/underscore.js"></script> - <script type="text/javascript" src="../_static/doctools.js"></script> - <link rel="top" title="Flask 0.8 documentation" href="../index.html" /> - <link rel="up" title="Deployment Options" href="index.html" /> - <link rel="next" title="uWSGI" href="uwsgi.html" /> - <link rel="prev" title="CGI" href="cgi.html" /> - - - <link rel="apple-touch-icon" href="../_static/touch-icon.png" /> - - <link media="only screen and (max-device-width: 480px)" href="../_static/small_flask.css" type= "text/css" rel="stylesheet" /> - - </head> - <body> - <div class="related"> - <h3>Navigation</h3> - <ul> - <li class="right" style="margin-right: 10px"> - <a href="../genindex.html" title="General Index" - accesskey="I">index</a></li> - <li class="right" > - <a href="uwsgi.html" title="uWSGI" - accesskey="N">next</a> |</li> - <li class="right" > - <a href="cgi.html" title="CGI" - accesskey="P">previous</a> |</li> - <li><a href="../index.html">Flask 0.8 documentation</a> »</li> - <li><a href="index.html" accesskey="U">Deployment Options</a> »</li> - </ul> - </div> - - <div class="document"> - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <div class="section" id="fastcgi"> -<span id="deploying-fastcgi"></span><h1>FastCGI<a class="headerlink" href="#fastcgi" title="Permalink to this headline">¶</a></h1> -<p>FastCGI is a deployment option on servers like <a class="reference external" href="http://nginx.org/">nginx</a>, <a class="reference external" href="http://www.lighttpd.net/">lighttpd</a>, -and <a class="reference external" href="http://www.cherokee-project.com/">cherokee</a>; see <a class="reference internal" href="uwsgi.html#deploying-uwsgi"><em>uWSGI</em></a> and -<a class="reference internal" href="others.html#deploying-other-servers"><em>Other Servers</em></a> for other options. To use your WSGI -application with any of them you will need a FastCGI server first. The -most popular one is <a class="reference external" href="http://trac.saddi.com/flup">flup</a> which we will use for this guide. Make sure -to have it installed to follow along.</p> -<div class="admonition-watch-out admonition "> -<p class="first admonition-title">Watch Out</p> -<p class="last">Please make sure in advance that any <tt class="docutils literal"><span class="pre">app.run()</span></tt> calls you might -have in your application file are inside an <tt class="docutils literal"><span class="pre">if</span> <span class="pre">__name__</span> <span class="pre">==</span> -<span class="pre">'__main__':</span></tt> block or moved to a separate file. Just make sure it’s -not called because this will always start a local WSGI server which -we do not want if we deploy that application to FastCGI.</p> -</div> -<div class="section" id="creating-a-fcgi-file"> -<h2>Creating a <cite>.fcgi</cite> file<a class="headerlink" href="#creating-a-fcgi-file" title="Permalink to this headline">¶</a></h2> -<p>First you need to create the FastCGI server file. Let’s call it -<cite>yourapplication.fcgi</cite>:</p> -<div class="highlight-python"><div class="highlight"><pre><span class="c">#!/usr/bin/python</span> -<span class="kn">from</span> <span class="nn">flup.server.fcgi</span> <span class="kn">import</span> <span class="n">WSGIServer</span> -<span class="kn">from</span> <span class="nn">yourapplication</span> <span class="kn">import</span> <span class="n">app</span> - -<span class="k">if</span> <span class="n">__name__</span> <span class="o">==</span> <span class="s">'__main__'</span><span class="p">:</span> - <span class="n">WSGIServer</span><span class="p">(</span><span class="n">app</span><span class="p">)</span><span class="o">.</span><span class="n">run</span><span class="p">()</span> -</pre></div> -</div> -<p>This is enough for Apache to work, however nginx and older versions of -lighttpd need a socket to be explicitly passed to communicate with the -FastCGI server. For that to work you need to pass the path to the -socket to the <tt class="xref py py-class docutils literal"><span class="pre">WSGIServer</span></tt>:</p> -<div class="highlight-python"><div class="highlight"><pre><span class="n">WSGIServer</span><span class="p">(</span><span class="n">application</span><span class="p">,</span> <span class="n">bindAddress</span><span class="o">=</span><span class="s">'/path/to/fcgi.sock'</span><span class="p">)</span><span class="o">.</span><span class="n">run</span><span class="p">()</span> -</pre></div> -</div> -<p>The path has to be the exact same path you define in the server -config.</p> -<p>Save the <cite>yourapplication.fcgi</cite> file somewhere you will find it again. -It makes sense to have that in <cite>/var/www/yourapplication</cite> or something -similar.</p> -<p>Make sure to set the executable bit on that file so that the servers -can execute it:</p> -<div class="highlight-text"><div class="highlight"><pre># chmod +x /var/www/yourapplication/yourapplication.fcgi -</pre></div> -</div> -</div> -<div class="section" id="configuring-lighttpd"> -<h2>Configuring lighttpd<a class="headerlink" href="#configuring-lighttpd" title="Permalink to this headline">¶</a></h2> -<p>A basic FastCGI configuration for lighttpd looks like that:</p> -<div class="highlight-python"><pre>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"</pre> -</div> -<p>Remember to enable the FastCGI, alias and rewrite modules. This -configuration binds the application to <cite>/yourapplication</cite>. If you want -the application to work in the URL root you have to work around a -lighttpd bug with the -<a class="reference external" href="http://werkzeug.pocoo.org/docs/contrib/fixers/#werkzeug.contrib.fixers.LighttpdCGIRootFix" title="(in Werkzeug v0.7)"><tt class="xref py py-class docutils literal"><span class="pre">LighttpdCGIRootFix</span></tt></a> middleware.</p> -<p>Make sure to apply it only if you are mounting the application the URL -root. Also, see the Lighty docs for more information on <a class="reference external" href="http://redmine.lighttpd.net/wiki/lighttpd/Docs:ModFastCGI">FastCGI and -Python</a> -(note that explicitly passing a socket to run() is no longer necessary).</p> -</div> -<div class="section" id="configuring-nginx"> -<h2>Configuring nginx<a class="headerlink" href="#configuring-nginx" title="Permalink to this headline">¶</a></h2> -<p>Installing FastCGI applications on nginx is a bit different because by -default no FastCGI parameters are forwarded.</p> -<p>A basic flask FastCGI configuration for nginx looks like this:</p> -<div class="highlight-python"><pre>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; -}</pre> -</div> -<p>This configuration binds the application to <cite>/yourapplication</cite>. If you -want to have it in the URL root it’s a bit simpler because you don’t -have to figure out how to calculate <cite>PATH_INFO</cite> and <cite>SCRIPT_NAME</cite>:</p> -<div class="highlight-python"><pre>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; -}</pre> -</div> -</div> -<div class="section" id="running-fastcgi-processes"> -<h2>Running FastCGI Processes<a class="headerlink" href="#running-fastcgi-processes" title="Permalink to this headline">¶</a></h2> -<p>Since Nginx and others do not load FastCGI apps, you have to do it by -yourself. <a class="reference external" href="http://supervisord.org/configuration.html#fcgi-program-x-section-settings">Supervisor can manage FastCGI processes.</a> -You can look around for other FastCGI process managers or write a script -to run your <cite>.fcgi</cite> file at boot, e.g. using a SysV <tt class="docutils literal"><span class="pre">init.d</span></tt> script. -For a temporary solution, you can always run the <tt class="docutils literal"><span class="pre">.fcgi</span></tt> script inside -GNU screen. See <tt class="docutils literal"><span class="pre">man</span> <span class="pre">screen</span></tt> for details, and note that this is a -manual solution which does not persist across system restart:</p> -<div class="highlight-python"><pre>$ screen -$ /var/www/yourapplication/yourapplication.fcgi</pre> -</div> -</div> -<div class="section" id="debugging"> -<h2>Debugging<a class="headerlink" href="#debugging" title="Permalink to this headline">¶</a></h2> -<p>FastCGI deployments tend to be hard to debug on most webservers. Very -often the only thing the server log tells you is something along the -lines of “premature end of headers”. In order to debug the application -the only thing that can really give you ideas why it breaks is switching -to the correct user and executing the application by hand.</p> -<p>This example assumes your application is called <cite>application.fcgi</cite> and -that your webserver user is <cite>www-data</cite>:</p> -<div class="highlight-python"><pre>$ 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</pre> -</div> -<p>In this case the error seems to be “yourapplication” not being on the -python path. Common problems are:</p> -<ul class="simple"> -<li>Relative paths being used. Don’t rely on the current working directory</li> -<li>The code depending on environment variables that are not set by the -web server.</li> -<li>Different python interpreters being used.</li> -</ul> -</div> -</div> - - - </div> - </div> - </div> - <div class="sphinxsidebar"> - <div class="sphinxsidebarwrapper"><p class="logo"><a href="../index.html"> - <img class="logo" src="../_static/flask.png" alt="Logo"/> -</a></p> - <h3><a href="../index.html">Table Of Contents</a></h3> - <ul> -<li><a class="reference internal" href="#">FastCGI</a><ul> -<li><a class="reference internal" href="#creating-a-fcgi-file">Creating a <cite>.fcgi</cite> file</a></li> -<li><a class="reference internal" href="#configuring-lighttpd">Configuring lighttpd</a></li> -<li><a class="reference internal" href="#configuring-nginx">Configuring nginx</a></li> -<li><a class="reference internal" href="#running-fastcgi-processes">Running FastCGI Processes</a></li> -<li><a class="reference internal" href="#debugging">Debugging</a></li> -</ul> -</li> -</ul> -<h3>Related Topics</h3> -<ul> - <li><a href="../index.html">Documentation overview</a><ul> - <li><a href="index.html">Deployment Options</a><ul> - <li>Previous: <a href="cgi.html" title="previous chapter">CGI</a></li> - <li>Next: <a href="uwsgi.html" title="next chapter">uWSGI</a></li> - </ul></li> - </ul></li> -</ul> - <h3>This Page</h3> - <ul class="this-page-menu"> - <li><a href="../_sources/deploying/fastcgi.txt" - rel="nofollow">Show Source</a></li> - </ul> -<div id="searchbox" style="display: none"> - <h3>Quick search</h3> - <form class="search" action="../search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> -</div> -<script type="text/javascript">$('#searchbox').show(0);</script> - </div> - </div> - <div class="clearer"></div> - </div> - <div class="footer"> - © Copyright 2010, Armin Ronacher. - Created using <a href="http://sphinx.pocoo.org/">Sphinx</a>. - </div> - </body> -</html>
\ No newline at end of file |