Πως να χρησιμοποιήσετε το Django με το uWSGI

Το uWSGI είναι ένας γρήγορος, αυτό-θεραπευόμενος και φιλικός προς τον developer και τον διαχειριστή application container server ο οποίος είναι γραμμένος αμιγώς σε C.

Δείτε επίσης

Τα εγχειρίδια του uWSGI παρέχουν ένα tutorial που καλύπτουν το Django, τον nginx και το uWSGI (ένας από τους πολλούς συνδυασμούς για να κάνετε deployment). Τα άρθρα, παρακάτω, εστιάζουν στο πως να ενσωματώσετε το Django με το uWSGI.

Προαπαιτούμενο: uWSGI

Το uWSGI wiki περιγράφει πολλά installation procedures. Μπορείτε να εγκαταστήσετε οποιαδήποτε uWSGI έκδοση επιθυμείτε χρησιμοποιώντας τον διαχειριστή πακέτων της Python, pip. Για παράδειγμα:

# Install current stable version.
$ python -m pip install uwsgi

# Or install LTS (long term support).
$ python -m pip install https://projects.unbit.it/downloads/uwsgi-lts.tar.gz

Το μοντέλο του uWSGI

uWSGI operates on a client-server model. Your Web server (e.g., nginx, Apache) communicates with a django-uwsgi «worker» process to serve dynamic content.

Παραμετροποιώντας και ξεκινώντας τον uWSGI server για το Django

uWSGI supports multiple ways to configure the process. See uWSGI’s configuration documentation.

Παρακάτω φαίνεται ένα παράδειγμα της εντολής uwsgi για να ξεκινήσετε έναν uWSGI server:

uwsgi --chdir=/path/to/your/project \
    --module=mysite.wsgi:application \
    --env DJANGO_SETTINGS_MODULE=mysite.settings \
    --master --pidfile=/tmp/project-master.pid \
    --socket=127.0.0.1:49152 \      # can also be a file
    --processes=5 \                 # number of worker processes
    --uid=1000 --gid=2000 \         # if root, uwsgi can drop privileges
    --harakiri=20 \                 # respawn processes taking more than 20 seconds
    --max-requests=5000 \           # respawn processes after serving 5000 requests
    --vacuum \                      # clear environment on exit
    --home=/path/to/virtual/env \   # optional path to a virtual environment
    --daemonize=/var/log/uwsgi/yourproject.log      # background the process

Τα παραπανω προϋποθέτουν ότι έχετε ένα project με το όνομα mysite και μέσα σε αυτό ένα module mysite/wsgi.py το οποίο περιέχει ένα WSGI application object. Αυτή θα είναι η διάταξη που θα έχετε αν τρέξετε την εντολή django-admin startproject mysite (χρησιμοποιώντας το δικό σας όνομα project στη θέση του mysite, φυσικά) με μια νεώτερη έκδοση του Django. Αν το αρχείο mysite/wsgi.py δεν υπάρχει, θα χρειαστεί να το δημιουργήσετε. Δείτε στο άρθρο Πως να ανεβάσετε το site σας χρησιμοποιώντας το WSGI για τα προεπιλεγμένα περιεχόμενα που θα πρέπει να βάλετε σε αυτό το αρχείο καθώς και άλλα που μπορείτε να προσθέσετε.

Οι επιλογές που αφορούν το Django είναι:

• chdir: Το path στο φάκελο που χρειάζεται να είναι στο import path της Python – πχ ο φάκελος που περιέχει το project mysite.
• module`: Το module WSGI που θα χρησιμοποιηθεί – πιθανόν το αρχείο mysite.wsgi που δημιουργεί η εντολή startproject.
• env: Θα πρέπει να περιέχει τουλάχιστον τη μεταβλητή DJANGO_SETTINGS_MODULE.
• home: Optional path to your project virtual environment.

Παράδειγμα του configuration αρχείου ini:

[uwsgi]
chdir=/path/to/your/project
module=mysite.wsgi:application
master=True
pidfile=/tmp/project-master.pid
vacuum=True
max-requests=5000
daemonize=/var/log/uwsgi/yourproject.log

Παράδειγμα χρήσης του configuration αρχείου ini:

uwsgi --ini uwsgi.ini

Διορθώνοντας το σφάλμα UnicodeEncodeError για uploads αρχείων

Αν λαμβάνετε το σφάλμα UnicodeEncodeError όταν ανεβάζετε αρχεία που τα ονόματα τους περιέχουν χαρακτήρες που δεν ανήκουν στον ASCII κώδικα (όπως είναι οι ελληνικοί χαρακτήρες), σιγουρευτείτε ότι ο uWSGI είναι ρυθμισμένος να δέχεται ονόματα αρχείων με χαρακτήρες που δεν είναι ASCII, προσθέτωντας το παρακάτω στο αρχείο uwsgi.ini:

env = LANG=en_US.UTF-8

Δείτε στην ενότητα Files του Unicode οδηγού για λεπτομέρειες.

Ανατρέξτε στα εγχειρίδια του uWSGI σχετικά με managing the uWSGI process για πληροφορίες σχετικά με την εκκίνηση, παύση και επαναφόρτωση των uWSGI workers.