Gazette Linux n°180 — novembre 2010 Anderson Silva afsilva CHEZ gmail POINT com Steve 'Ashcrow' Milner Prénom Nom du traducteur Adaptation française adresse_électronique CHEZ fournisseur POINT code_pays Prénom Nom du relecteur Relecture de la version française adresse_électronique CHEZ fournisseur POINT code_pays Article paru dans le n°180 de la Gazette Linux de novembre 2010. Cet article est publié selon les termes de la Open Publication License. La Linux Gazette n'est ni produite, ni sponsorisée, ni avalisée par notre hébergeur principal, SSC, Inc. 2010 Anderson Silva Steve 'Ashcrow' Milner Année de traduction Prénom Nom du traducteur Année de relecture Prénom Nom du relecteur In today's world, web development is all about turnaround. Businesses want to maximize production outcome while minimizing development and production time. Small, lean development teams are increasingly becoming the norm in large development departments. Enter Django: a popular Python web framework that invokes the RWAD (rapid web application development) and DRY (don't repeat yourself) principles with clean, pragmatic design. This article is not about teaching you how to program in Python, nor how to use the Django framework. It's about showing how to promote your Django applications onto an existing Apache or Lighttpd environment. We will conclude with a simple way that you can improve the performance of your Django application by using caching to speed up access time. This article also assumes that you are running Fedora as your web application server, but all the packages mentioned in this article are also available in many OS's including under the Extra Packages for Enterprise Linux repository, which means these instructions should also be valid under >Red Hat Enterprise Linux or CentOS servers.

You must have Django installed: $ yum install Django If you want to serve Django apps under Apache you will need mod_wsgi: $ yum install httpd mod_wsgi If you want to serve Django apps under Lighttpd: $ yum install lighttpd lighttpd-fastcgi python-flup Installing memcached to speed up Django apps: $ yum install memcached python-memcached

Create a development workspace. $ mkdir -p $LOCATION_TO_YOUR_DEV_AREA $ cd $LOCATION_TO_YOUR_DEV_AREA Start a new base Django project. This creates the boiler plate project structure. $ django-admin startproject my_app Start the Django development web server on port 8080 (or whatever other port you'd like). The development web server is just for testing and verification. Do not use it as a production application server! $ python manage.py runserver 8080 Run your Django project under Apache with mod_wsgi by enabling mod_wsgi. Note that to do this you will need to have your project in an SELinux friendly location (don't use home directories!) as well as readable by apache. On Fedora mod_wsgi is auto added upon install via /etc/httpd/conf.d/wsgi.conf. Upon restarting of apache, the module will be loaded. Create virtual hosts by creating a new file at /etc/httpd/conf.d/myapp.conf. WSGIScriptAlias / /path/to/myapp/apache/django.wsgi DocumentRoot /var/www/html/ ServerName your_domain_name ErrorLog logs/my_app-error.log CustomLog logs/my_app-access_log common In step we defined a script alias and now we need to create the wsgi file it references. import os import sys import django.core.handlers.wsgi # Append our project path to the system library path sys.path.append('/path/to/') # Sets the settins module so Django will work properly os.environ['DJANGO_SETTINGS_MODULE'] = 'myapp.settings' # sets application (the default wsgi app) to the Django handler application = django.core.handlers.wsgi.WSGIHandler()

The first thing you must do is start up your FastCGI server. ./manage.py runfcgi method=prefork socket=/var/www/myapp.sock pidfile=django_myapp.pid Then modify your lighttpd.conf file to use the FastCGI server. server.document-root = "/var/www/django/" fastcgi.server = (     "/my_app.fcgi" => (         "main" => (             # Use host / port instead of socket for TCP fastcgi             # "host" => "127.0.0.1",             # "port" => 3033,             "socket" => "/var/www/my_app.sock",             "check-local" => "disable",         )     ), ) alias.url = (     "/media/" => "/var/www/django/media/", ) url.rewrite-once = (     "^(/media.*)$" => "$1",     "^/favicon\.ico$" => "/media/favicon.ico",     "^(/.*)$" => "/my_app.fcgi$1", )

Django has many different caching backends, including database, memory, filesystem, and the ever popular memcached. According to http://www.danga.com/memcached/, memcached is a high-performance, distributed memory object caching system, generic in nature, but intended for use in speeding up dynamic web applications by alleviating database load. It's used by high traffic sites such as Slashdot and Wikipedia. This makes it a prime candidate for caching in your cool new web app. First, install memcached. $ yum install memcached Next, install the python bindings for memcached. $ yum install python-memcached Next, verify that memcached is running using the memcached's init script. $ /etc/init.d/memcached status memcached (pid 6771) is running... If it's not running, you can manually start it. $ /sbin/service memcached start If you want to make sure it will automatically start every time after a reboot: $ /sbin/chkconfig --level 35 memcached on Now that you have verified that memcached is running, you will want to tell your Django application to use memcached as it's caching backend. You can do this by adding a CACHE_BACKEND entry to your settings.py file. CACHE_BACKEND = 'memcached://127.0.0.1:11211/' The format is "backend://host:port/" or "backend:///path" depending on the backend chosen. Since we are using memcached, we have the option to run multiple daemons on different servers and share the cache across multiple machines. If you want to do this all you must do is add in the servers:port combinations in the CACHE_BACKEND and separate them by semicolons. In this example we share the cache across three different memcached servers: CACHE_BACKEND = 'memcached://127.0.0.1:11211;192.168.0.10:11211;192.168.0.11/' For more information on the different types of caching that can be performed in the Django framework, please refer to their official documentation. Finally, whenever you are ready to get your applications into production, you can always write your own Django service script, so your application can start up at boot time. The original article was published on June 5th, 2008 by Red Hat Magazine, and revised for the 2010 November Issue of Linux Gazette.

Anderson Silva works as an IT Release Engineer at Red Hat, Inc. He holds a BS in Computer Science from Liberty University, a MS in Information Systems from the University of Maine. He is a Red Hat Certified Architect and has authored several Linux based articles for publications like: Linux Gazette, Revista do Linux, and Red Hat Magazine. Anderson has been married to his High School sweetheart, Joanna (who helps him edit his articles before submission), for 11 years, and has 3 kids. When he is not working or writing, he enjoys photography, spending time with his family, road cycling, watching Formula 1 and Indycar races, and taking his boys karting, Steve 'Ashcrow' Milner works as a Security Analyst at Red Hat, Inc. He is a Red Hat Certified Engineer and is certified on ITIL Foundations. Steve has two dogs, Anubis and Emma-Lee who guard his house. In his spare time Steve enjoys robot watching, writing open code, caffeine, climbing downed trees and reading comic books. L'adaptation française de ce document a été réalisée dans le cadre du Projet de traduction de la Gazette Linux. Vous pourrez lire d'autres articles traduits et en apprendre plus sur ce projet en visitant notre site : . Si vous souhaitez apporter votre contribution, n'hésitez pas à nous rejoindre, nous serons heureux de vous accueillir.