Πως να χρησιμοποιήσετε το Django με το uWSGILink to this heading

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

Προαπαιτούμενο: uWSGILink to this heading

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

Shell
# 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

Το μοντέλο του uWSGILink to this heading

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 για το DjangoLink to this heading

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

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

Shell
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:

Shell
[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:

Shell
uwsgi --ini uwsgi.ini

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