update doc

This commit is contained in:
benoitc 2011-05-18 19:08:02 +02:00
parent 76aef105d5
commit fc300cc23c
4 changed files with 79 additions and 52 deletions

View File

@ -142,7 +142,7 @@ confuses the monitor services.</p>
<div class="section" id="runit">
<h3><a class="toc-backref" href="#contents">Runit</a></h3>
<p>A popular method for deploying Gunicorn is to have it monitored by <a class="reference external" href="http://smarden.org/runit/">runit</a>.
An <a class="reference external" href="http://github.com/benoitc/gunicorn/blob/master/examples/gunicorn_rc">example service</a> definition:</p>
Here is an <a class="reference external" href="http://github.com/benoitc/gunicorn/blob/master/examples/gunicorn_rc">example service</a> definition:</p>
<pre class="literal-block">
#!/bin/sh
@ -157,6 +157,12 @@ if [ -f $PID ]; then rm $PID; fi
cd $ROOT
exec $GUNICORN -c $ROOT/gunicorn.conf.py --pid=$PID $APP
</pre>
<p>Save this as <tt class="docutils literal"><span class="pre">/etc/sv/[app_name]/run</span></tt>, and make it executable
(<tt class="docutils literal">chmod u+x <span class="pre">/etc/sv/[app_name]/run</span></tt>).
Then run <tt class="docutils literal">ln <span class="pre">-s</span> <span class="pre">/etc/sv/[app_name]</span> <span class="pre">/etc/service/[app_name]</span></tt>.
If runit is installed, gunicorn should start running automatically as soon
as you create the symlink.</p>
<p>If it doesn't start automatically, run the script directly to troubleshoot.</p>
</div>
<div class="section" id="supervisor">
<h3><a class="toc-backref" href="#contents">Supervisor</a></h3>

View File

@ -79,15 +79,14 @@ def app(environ, start_response):
</ul>
</div>
<div class="blurb">
<h3>Version 0.12.1 - 2011-03-23</h3>
<h3>Version 0.12.2 / 2011-05-18</h3>
<ul>
<li>Add "on_starting" hook. This hook can be used to set
anything before the arbiter really start</li>
<li>Support bdist_rpm in setup</li>
<li>Improve content-length handling (pep 3333)</li>
<li>Improve Django support</li>
<li>Fix daemonizing (#142)</li>
<li>Fix ipv6 handling</li>
<li>Add wsgi.file_wrapper optimised for FreeBSD, Linux & MacOSX (use
sendfile if available)</li>
<li>Fix django run_gunicorn command. Make sure we reload the application
code.</li>
<li>Fix django localisation</li>
<li>Compatible with gevent 0.14dev</li>
</ul>
</div>
<div id="footer">

View File

@ -29,6 +29,17 @@
<div id="content">
<div class="document">
<div class="section" id="id1">
<h2><a class="toc-backref" href="#contents">0.12.2 / 2011-05-18</a></h2>
<ul class="simple">
<li>Add wsgi.file_wrapper optimised for FreeBSD, Linux &amp; MacOSX (use
sendfile if available)</li>
<li>Fix django run_gunicorn command. Make sure we reload the application
code.</li>
<li>Fix django localisation</li>
<li>Compatible with gevent 0.14dev</li>
</ul>
</div>
<div class="section" id="id2">
<h2><a class="toc-backref" href="#contents">0.12.1 / 2011-03-23</a></h2>
<ul class="simple">
<li>Add &quot;on_starting&quot; hook. This hook can be used to set anything before
@ -40,7 +51,7 @@ the arbiter really start</li>
<li>Fix ipv6 handling</li>
</ul>
</div>
<div class="section" id="id2">
<div class="section" id="id3">
<h2><a class="toc-backref" href="#contents">0.12.0 / 2010-12-22</a></h2>
<ul class="simple">
<li>Add support for logging configuration using a ini file.
@ -58,7 +69,7 @@ it and use it.</li>
<li>Set the number of workers to zero on WINCH</li>
</ul>
</div>
<div class="section" id="id3">
<div class="section" id="id4">
<h2><a class="toc-backref" href="#contents">0.11.2 / 2010-10-30</a></h2>
<ul class="simple">
<li>Add SERVER_SOFTWARE to the os.environ</li>
@ -71,7 +82,7 @@ it and use it.</li>
<li>Fix readline in wsgi.input</li>
</ul>
</div>
<div class="section" id="id4">
<div class="section" id="id5">
<h2><a class="toc-backref" href="#contents">0.11.1 / 2010-09-02</a></h2>
<ul class="simple">
<li>Implement max-requests feature to prevent memory leaks.</li>
@ -83,7 +94,7 @@ it and use it.</li>
<li>Workaround to prevent Gevent worker to segfault on MacOSX.</li>
</ul>
</div>
<div class="section" id="id5">
<div class="section" id="id6">
<h2><a class="toc-backref" href="#contents">0.11.0 / 2010-08-12</a></h2>
<ul class="simple">
<li>Improve dramatically performances of Gevent and Eventlet workers</li>
@ -92,7 +103,7 @@ it and use it.</li>
<li>Fix latency issue in async workers</li>
</ul>
</div>
<div class="section" id="id6">
<div class="section" id="id7">
<h2><a class="toc-backref" href="#contents">0.10.1 / 2010-08-06</a></h2>
<ul class="simple">
<li>Improve gevent's workers. Add &quot;egg:gunicorn#gevent_wsgi&quot; worker using
@ -106,7 +117,7 @@ need really fast connections and don't need streaming, keepalive or ssl.</li>
<li>Fix gevent dns issue</li>
</ul>
</div>
<div class="section" id="id7">
<div class="section" id="id8">
<h2><a class="toc-backref" href="#contents">0.10.0 / 2010-07-08</a></h2>
<ul class="simple">
<li>New HTTP parser.</li>
@ -126,7 +137,7 @@ the preload flag can help a bit in small memory VM's.</li>
<li>New documentation website.</li>
</ul>
</div>
<div class="section" id="id8">
<div class="section" id="id9">
<h2><a class="toc-backref" href="#contents">0.9.1 / 2010-05-26</a></h2>
<ul class="simple">
<li>Support https via X-Forwarded-Protocol or X-Forwarded-Ssl headers</li>
@ -135,7 +146,7 @@ the preload flag can help a bit in small memory VM's.</li>
<li>Fix umask in unix socket</li>
</ul>
</div>
<div class="section" id="id9">
<div class="section" id="id10">
<h2><a class="toc-backref" href="#contents">0.9.0 / 2010-05-24</a></h2>
<ul class="simple">
<li>Added <em>when_ready</em> hook. Called just after the server is started</li>
@ -148,7 +159,7 @@ are forked.</li>
<li>Documentation improvements</li>
</ul>
</div>
<div class="section" id="id10">
<div class="section" id="id11">
<h2><a class="toc-backref" href="#contents">0.8.1 / 2010-04-29</a></h2>
<ul class="simple">
<li>Fix builtins import in config</li>
@ -157,7 +168,7 @@ are forked.</li>
<li>Delay application loading until after processing all configuration</li>
</ul>
</div>
<div class="section" id="id11">
<div class="section" id="id12">
<h2><a class="toc-backref" href="#contents">0.8.0 / 2010-04-22</a></h2>
<ul class="simple">
<li>Refactored Worker management for better async support. Now use the -k option
@ -165,7 +176,7 @@ to set the type of request processing to use</li>
<li>Added support for <a class="reference external" href="http://www.tornadoweb.org/">Tornado</a></li>
</ul>
</div>
<div class="section" id="id12">
<div class="section" id="id13">
<h2><a class="toc-backref" href="#contents">0.7.2 / 2010-04-15</a></h2>
<ul class="simple">
<li>Added --spew option to help debugging (installs a system trace hook)</li>
@ -173,13 +184,13 @@ to set the type of request processing to use</li>
<li>Fix a bug in start_response on error</li>
</ul>
</div>
<div class="section" id="id13">
<div class="section" id="id14">
<h2><a class="toc-backref" href="#contents">0.7.1 / 2010-04-01</a></h2>
<ul class="simple">
<li>Fix bug when responses have no body.</li>
</ul>
</div>
<div class="section" id="id14">
<div class="section" id="id15">
<h2><a class="toc-backref" href="#contents">0.7.0 / 2010-03-26</a></h2>
<ul class="simple">
<li>Added support for <a class="reference external" href="http://eventlet.net">Eventlet</a> and <a class="reference external" href="http://gevent.org">Gevent</a> based workers.</li>
@ -189,28 +200,28 @@ to set the type of request processing to use</li>
<li>Fix <a class="reference external" href="http://www.python.org/dev/peps/pep-0333/">PEP 333</a> compliance for the write callable.</li>
</ul>
</div>
<div class="section" id="id15">
<div class="section" id="id16">
<h2><a class="toc-backref" href="#contents">0.6.5 / 2010-03-11</a></h2>
<ul class="simple">
<li>Fix pidfile handling</li>
<li>Fix Exception Error</li>
</ul>
</div>
<div class="section" id="id16">
<div class="section" id="id17">
<h2><a class="toc-backref" href="#contents">0.6.4 / 2010-03-08</a></h2>
<ul class="simple">
<li>Use cStringIO for performance when possible.</li>
<li>Fix worker freeze when a remote connection closes unexpectedly.</li>
</ul>
</div>
<div class="section" id="id17">
<div class="section" id="id18">
<h2><a class="toc-backref" href="#contents">0.6.3 / 2010-03-07</a></h2>
<ul class="simple">
<li>Make HTTP parsing faster.</li>
<li>Various bug fixes</li>
</ul>
</div>
<div class="section" id="id18">
<div class="section" id="id19">
<h2><a class="toc-backref" href="#contents">0.6.2 / 2010-03-01</a></h2>
<ul class="simple">
<li>Added support for chunked response.</li>
@ -221,7 +232,7 @@ temporary data.</li>
<li>Workers are now murdered by age (the oldest is killed first).</li>
</ul>
</div>
<div class="section" id="id19">
<div class="section" id="id20">
<h2><a class="toc-backref" href="#contents">0.6.1 / 2010-02-24</a></h2>
<ul class="simple">
<li>Added gunicorn config file support for Django admin command</li>
@ -229,7 +240,7 @@ temporary data.</li>
<li>Removed TTIN/TTOU from workers which blocked other signals.</li>
</ul>
</div>
<div class="section" id="id20">
<div class="section" id="id21">
<h2><a class="toc-backref" href="#contents">0.6 / 2010-02-22</a></h2>
<ul class="simple">
<li>Added setproctitle support</li>
@ -237,14 +248,14 @@ temporary data.</li>
permissions, new uid/gid permissions are only set for workers.</li>
</ul>
</div>
<div class="section" id="id21">
<div class="section" id="id22">
<h2><a class="toc-backref" href="#contents">0.5.1 / 2010-02-22</a></h2>
<ul class="simple">
<li>Fix umask</li>
<li>Added Debian packaging</li>
</ul>
</div>
<div class="section" id="id22">
<div class="section" id="id23">
<h2><a class="toc-backref" href="#contents">0.5 / 2010-02-20</a></h2>
<ul class="simple">
<li>Added <a class="reference external" href="configuration.html">configuration file</a> handler.</li>
@ -266,28 +277,29 @@ permissions, new uid/gid permissions are only set for workers.</li>
<div class="contents topic" id="contents">
<p class="topic-title first">Contents</p>
<ul class="simple">
<li><a class="reference internal" href="#id1" id="id23">0.12.1 / 2011-03-23</a></li>
<li><a class="reference internal" href="#id2" id="id24">0.12.0 / 2010-12-22</a></li>
<li><a class="reference internal" href="#id3" id="id25">0.11.2 / 2010-10-30</a></li>
<li><a class="reference internal" href="#id4" id="id26">0.11.1 / 2010-09-02</a></li>
<li><a class="reference internal" href="#id5" id="id27">0.11.0 / 2010-08-12</a></li>
<li><a class="reference internal" href="#id6" id="id28">0.10.1 / 2010-08-06</a></li>
<li><a class="reference internal" href="#id7" id="id29">0.10.0 / 2010-07-08</a></li>
<li><a class="reference internal" href="#id8" id="id30">0.9.1 / 2010-05-26</a></li>
<li><a class="reference internal" href="#id9" id="id31">0.9.0 / 2010-05-24</a></li>
<li><a class="reference internal" href="#id10" id="id32">0.8.1 / 2010-04-29</a></li>
<li><a class="reference internal" href="#id11" id="id33">0.8.0 / 2010-04-22</a></li>
<li><a class="reference internal" href="#id12" id="id34">0.7.2 / 2010-04-15</a></li>
<li><a class="reference internal" href="#id13" id="id35">0.7.1 / 2010-04-01</a></li>
<li><a class="reference internal" href="#id14" id="id36">0.7.0 / 2010-03-26</a></li>
<li><a class="reference internal" href="#id15" id="id37">0.6.5 / 2010-03-11</a></li>
<li><a class="reference internal" href="#id16" id="id38">0.6.4 / 2010-03-08</a></li>
<li><a class="reference internal" href="#id17" id="id39">0.6.3 / 2010-03-07</a></li>
<li><a class="reference internal" href="#id18" id="id40">0.6.2 / 2010-03-01</a></li>
<li><a class="reference internal" href="#id19" id="id41">0.6.1 / 2010-02-24</a></li>
<li><a class="reference internal" href="#id20" id="id42">0.6 / 2010-02-22</a></li>
<li><a class="reference internal" href="#id21" id="id43">0.5.1 / 2010-02-22</a></li>
<li><a class="reference internal" href="#id22" id="id44">0.5 / 2010-02-20</a></li>
<li><a class="reference internal" href="#id1" id="id24">0.12.2 / 2011-05-18</a></li>
<li><a class="reference internal" href="#id2" id="id25">0.12.1 / 2011-03-23</a></li>
<li><a class="reference internal" href="#id3" id="id26">0.12.0 / 2010-12-22</a></li>
<li><a class="reference internal" href="#id4" id="id27">0.11.2 / 2010-10-30</a></li>
<li><a class="reference internal" href="#id5" id="id28">0.11.1 / 2010-09-02</a></li>
<li><a class="reference internal" href="#id6" id="id29">0.11.0 / 2010-08-12</a></li>
<li><a class="reference internal" href="#id7" id="id30">0.10.1 / 2010-08-06</a></li>
<li><a class="reference internal" href="#id8" id="id31">0.10.0 / 2010-07-08</a></li>
<li><a class="reference internal" href="#id9" id="id32">0.9.1 / 2010-05-26</a></li>
<li><a class="reference internal" href="#id10" id="id33">0.9.0 / 2010-05-24</a></li>
<li><a class="reference internal" href="#id11" id="id34">0.8.1 / 2010-04-29</a></li>
<li><a class="reference internal" href="#id12" id="id35">0.8.0 / 2010-04-22</a></li>
<li><a class="reference internal" href="#id13" id="id36">0.7.2 / 2010-04-15</a></li>
<li><a class="reference internal" href="#id14" id="id37">0.7.1 / 2010-04-01</a></li>
<li><a class="reference internal" href="#id15" id="id38">0.7.0 / 2010-03-26</a></li>
<li><a class="reference internal" href="#id16" id="id39">0.6.5 / 2010-03-11</a></li>
<li><a class="reference internal" href="#id17" id="id40">0.6.4 / 2010-03-08</a></li>
<li><a class="reference internal" href="#id18" id="id41">0.6.3 / 2010-03-07</a></li>
<li><a class="reference internal" href="#id19" id="id42">0.6.2 / 2010-03-01</a></li>
<li><a class="reference internal" href="#id20" id="id43">0.6.1 / 2010-02-24</a></li>
<li><a class="reference internal" href="#id21" id="id44">0.6 / 2010-02-22</a></li>
<li><a class="reference internal" href="#id22" id="id45">0.5.1 / 2010-02-22</a></li>
<li><a class="reference internal" href="#id23" id="id46">0.5 / 2010-02-20</a></li>
</ul>
</div>
</div>

View File

@ -8,6 +8,16 @@ _TOC_TOP_
_TOC_BOT_
0.12.2 / 2011-05-18
-------------------
- Add wsgi.file_wrapper optimised for FreeBSD, Linux & MacOSX (use
sendfile if available)
- Fix django run_gunicorn command. Make sure we reload the application
code.
- Fix django localisation
- Compatible with gevent 0.14dev
0.12.1 / 2011-03-23
-------------------