Changes between Version 9 and Version 10 of Gunicorn

Timestamp:

Feb 18, 2015, 10:27:08 PM (9 years ago)

Author:

Ryan J Ollos

Comment:

More cosmetic changes.

Gunicorn

@@ -3 +3 @@
 [http://gunicorn.org/ Gunicorn] (Green Unicorn) is a Python WSGI HTTP Server for UNIX. It is a pre-fork worker model ported from Ruby's Unicorn project. The Gunicorn server is broadly compatible with various web frameworks, simply implemented, light on server resources, and fairly speedy.
 
- 1. Install gunicorn
+1. Install gunicorn
 
 Gunicorn is a Python project which lives on pypi, so we can use easy_install or pip to install gunicorn:
-
-{{{
-    $> pip install gunicorn
+{{{#!sh
+$> pip install gunicorn
 }}}
 
-I prefer to use a virtualenv (http://pypi.python.org/pypi/virtualenv), to not have to install gunicorn in a system wide fashion.
+I prefer to use a [http://pypi.python.org/pypi/virtualenv virtualenv], to not have to install gunicorn in a system wide fashion.
 
- 2. Write your wsgi file
+2. Write your wsgi file
 
-Gunicorn is [http://en.wikipedia.org/wiki/Web_Server_Gateway_Interface WSGI compliant], so we need a simple Python script `tracwsgi.py` that work as an entry point:
+Gunicorn is [http://en.wikipedia.org/wiki/Web_Server_Gateway_Interface WSGI compliant], so we need a simple Python script `tracwsgi.py` that functions as an entry point:
 
-{{{
+{{{#!python
 import sys
 import os
@@ -35 +34 @@
 Now to test it:
 
-{{{
-
+{{{#!sh
 $> gunicorn -w2 tracwsgi:application -b 0.0.0.0:8000
 2011-03-04 13:21:10 [14900] [INFO] Starting gunicorn 0.12.0
@@ -42 +40 @@
 2011-03-04 13:21:10 [14901] [INFO] Booting worker with pid: 14901
 2011-03-04 13:21:10 [14902] [INFO] Booting worker with pid: 14902
-
 }}}
 
-In your web browser go to http://yourIP:8000 and it should work.
+In your web browser go to http://localhost:8000 and it should work.
 How it works: gunicorn is looking for a method called "application" in the tracwsgi.py file.
 
- 3. Configure Nginx
+3. Configure Nginx
 
 So, now we have Gunicorn running, but we will make it work with Nginx which will redirect Trac requests to gunicorn:
 
-{{{
-
+{{{#!nginx
 upstream trac_gunicorn {
     server unix:///home/repos/projects/run/trac.sock;
@@ -79 +75 @@
     }
 }
-
 }}}
 
-'''Note''': Nginx will redirect requests to a UNIX socket. It can be a simple ip:port combination. It can be a multiple instance of gunicorn. Take a look in the Nginx documentation:
-http://wiki.nginx.org/HttpUpstreamModule
+'''Note''': Nginx will redirect requests to a UNIX socket. It can be a simple ip:port combination. It can be a multiple instance of gunicorn. Take a look in the [http://wiki.nginx.org/HttpUpstreamModule Nginx documentation].
 
 To add a basic or digest authentication, you'll have to provide a file as in the example above, created using htpasswd file.
 To make gunicorn listen on a unix socket, add this option:
 
-{{{
-
+{{{#!sh
 gunicorn -w2 -b unix:///home/repos/projects/run/trac.sock tracwsgi:application
-
 }}}
 
-'''Note''': It seems the WSGI entry point does not handle the Digest or Basic http authentication. To ensure the authentication middleware is passed, you have to hack a little bit the tracwsgi.py:
+'''Note''': It seems the WSGI entry point does not handle the digest or basic http authentication. To ensure the authentication middleware is passed, you have to hack a little bit the `tracwsgi.py`:
 
-{{{
-
+{{{#!python
 import sys
 import os
@@ -116 +107 @@
 '''Note''': if using digest authentication you must create the authentication handler outside of the application def, otherwise the !DigestAuthentication object won't retain state between requests. 
 
-{{{
+{{{#!python
 import sys
 import os