mod_wsgiLink to this heading#Το να ανεβάσετε το Django site σας (deploying) στην παραγωγή (production) χρησιμοποιώντας τον Apache Web server και το mod_wsgi είναι μια δοκιμασμένη και πετυχημένη μέθοδος.
\nΤο mod_wsgi είναι ένα Apache module το οποίο μπορεί να φιλοξενήσει κάθε Python WSGI εφαρμογή, συμπεριλαμβανομένου και του Django. Το Django θα δουλέψει με κάθε έκδοση του Apache που υποστηρίζει το mod_wsgi.
\nThe official mod_wsgi documentation is your source for all the details about\nhow to use mod_wsgi. You’ll probably want to start with the installation and\nconfiguration documentation.
\nΑφού εγκαταστήσετε και ενεργοποιήσετε το mod_wsgi, επεξεργαστείτε το αρχείο httpd.conf του Apache Web server και προσθέστε τα ακόλουθα. Αν χρησιμοποιείτε κάποια έκδοση του Apache παλαιότερη της 2.4, αντικαταστήστε το Require all granted με το Allow from all και επίσης προσθέστε τη γραμμή Order deny,allow από πάνω.
WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py\nWSGIPythonHome /path/to/venv\nWSGIPythonPath /path/to/mysite.com\n\n<Directory /path/to/mysite.com/mysite>\n<Files wsgi.py>\nRequire all granted\n</Files>\n</Directory>\nΗ πρώτη παράμετρος στη γραμμή του WSGIScriptAlias είναι το βασικό URL path που θέλετε να εξυπηρετηθεί η εφαρμογή σας (η κάθετος, /, υποδεικνύει το root url) και η δεύτερη είναι η τοποθεσία που βρίσκεται το «WSGI file» – δείτε παρακάτω – στο σύστημα σας, συνήθως μέσα στο φάκελο του project σας (mysite, σε αυτό το παράδειγμα). Αυτό λέει στον Apache να εξυπηρετήσει κάθε request κάτω από αυτό το url (αν κατέχετε το url με το όνομα πχ www.mysite.com τότε θα εξυπηρετηθούν όλα τα urls που ξεκινούν με αυτό το όνομα) χρησιμοποιώντας την WSGI εφαρμογή η οποία ορίζεται σε αυτό το αρχείο (wsgi.py).
Αν εγκαταστήσετε τα Python dependencies του project σας μέσα σε ένα virtualenv, τότε προσθέστε το μονοπάτι (path) του virtualenv χρησιμοποιώντας το WSGIPythonHome. Δείτε περισσότερα στον οδηγό mod_wsgi virtualenv guide για περισσότερες πληροφορίες.
Η γραμμή WSGIPythonPath βεβαιώνει ότι το project σας θα είναι διαθέσιμο για να γίνει import στο Python path. Με άλλα λόγια, ότι το import mysite δουλεύει.
Το κομμάτι του <Directory> απλώς βεβαιώνει ότι ο Apache μπορεί να έχει πρόσβαση στο αρχείο σας wsgi.py.
Επόμενο βήμα είναι να σιγουρευτούμε ότι υπάρχει το αρχείο wsgi.py με το WSGI application object. Από την έκδοση του Django 1.4 και μετά, η εντολή startproject θα δημιουργήσει ένα τέτοιο αρχείο. Αν όχι, θα χρειαστεί να το δημιουργήσετε εσείς. Δείτε στο εγχειρίδιο του WSGI για τα προεπιλεγμένα περιεχόμενα που μπορείτε να βάλτε σε αυτό το αρχείο καθώς και άλλα πράγματα που μπορείτε να προσθέσετε.
mod_wsgi daemon modeLink to this heading#Η λειτουργία daemon («daemon mode») είναι η προτεινόμενη λειτουργία για να τρέχετε το mod_wsgi (σε πλατφόρμες εκτός Windows). Για να δημιουργήσετε το απαραίτητο daemon process group και να εξουσιοδοτήσετε το Django instance να το τρέξει, θα πρέπει να προσθέσετε τα κατάλληλα directives WSGIDaemonProcess και WSGIProcessGroup. Αν χρησιμοποιείτε την παραπάνω ρύθμιση με το daemon mode δεν θα μπορείτε να χρησιμοποιήσετε το WSGIPythonPath. Αντ’ αυτού θα πρέπει να χρησιμοποιήσετε την επιλογή python-path μέσα στο WSGIDaemonProcess. Για παράδειγμα:
WSGIDaemonProcess example.com python-home=/path/to/venv python-path=/path/to/mysite.com\nWSGIProcessGroup example.com\nΑν θέλετε να εξυπηρετήσετε το project σας σε κάποιον υποφάκελο (πχ στη διεύθυνση https://example.com/mysite), μπορείτε να προσθέσετε το WSGIScriptAlias στην παραπάνω παραμετροποίηση:
WSGIScriptAlias /mysite /path/to/mysite.com/mysite/wsgi.py process-group=example.com\nΔείτε το επίσημο εγχειρίδιο του mod_wsgi για περισσότερες λεπτομέρειες στην παραμετροποίηση του daemon mode.
\nΤο Django δεν εξυπηρετεί το ίδιο, αρχεία. Αυτό το αφήνει στον Web server τον οποίο θα διαλέξετε εσείς.
\nΠροτείνουμε να διαλέξετε έναν διαφορετικό Web server – πχ κάποιον ο οποίος δεν τρέχει ήδη Django – για να εξυπηρετήσετε τα media files. Παρακάτω φαίνονται μερικές καλές επιλογές:
\n\nΑν, παρόλ’ αυτά, δεν έχετε άλλη επιλογή παρά να εξυπηρετήσετε τα media files στον ίδιο Apache VirtualHost που τρέχει και το Django, μπορείτε να ρυθμίσετε τον Apache να εξυπηρετήσει μερικά URLs ως static media και άλλα χρησιμοποιώντας το mod_wsgi interface στο Django.
Αυτό το παράδειγμα ρυθμίζει το Django στο site root, αλλά εξυπηρετεί τα αρχεία robots.txt, favicon.ico και οτιδήποτε μέσα στα URLs /static/ και /media/ ως ένα static file (πχ JavaScript, CSS, fonts αρχείο κλπ). Όλα τα άλλα URLs θα εξυπηρετηθούν χρησιμοποιώντας το mod_wsgi:
Alias /robots.txt /path/to/mysite.com/static/robots.txt\nAlias /favicon.ico /path/to/mysite.com/static/favicon.ico\n\nAlias /media/ /path/to/mysite.com/media/\nAlias /static/ /path/to/mysite.com/static/\n\n<Directory /path/to/mysite.com/static>\nRequire all granted\n</Directory>\n\n<Directory /path/to/mysite.com/media>\nRequire all granted\n</Directory>\n\nWSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py\n\n<Directory /path/to/mysite.com/mysite>\n<Files wsgi.py>\nRequire all granted\n</Files>\n</Directory>\nΑν χρησιμοποιείτε κάποια παλαιότερη έκδοση του Apache από 2.4, αντικαταστήστε το Require all granted με το Allow from all και, επίσης, προσθέστε τη γραμμή Order deny,allow από πάνω.
Όταν η εφαρμογή django.contrib.staticfiles είναι μέσα στα INSTALLED_APPS, ο Django development server αυτόματα εξυπηρετεί τα static files της εφαρμογής admin (και κάθε άλλης εγκατεστημένης εφαρμογής). Αυτό, ωστόσο, δεν ισχύει ότι χρησιμοποιείτε κάποια άλλη διάταξη server. Είστε υπεύθυνοι για να ρυθμίσετε τον Apache ή οποιονδήποτε άλλο Web server χρησιμοποιείτε, για να εξυπηρετήσετε τα αρχεία για το site του admin.
Τα αρχεία του admin βρίσκονται στην τοποθεσία django/contrib/admin/static/admin της Django διανομής.
Συνιστούμε θερμά να χρησιμοποιείτε την εφαρμογή django.contrib.staticfiles για να διαχειριστείτε τα αρχεία του admin (μαζί με κάποιον Web server όπως περιγράφηκε στην προηγούμενη ενότητα. Αυτό σημαίνει ότι χρησιμοποιείτε την διαχειριστική εντολή collectstatic για να συγκεντρώσετε τα static files στο φάκελο in STATIC_ROOT και κατόπιν να ρυθμίσετε τον Web server σας να εξυπηρετεί το φάκελο STATIC_ROOT στη διεύθυνση STATIC_URL), αλλά αν δεν το κάνετε, παρακάτω φαίνονται τρεις διαφορετικές προσεγγίσεις του θέματος:
Δημιουργήστε ένα symbolic link στα static files του admin από το document root σας (αυτό ίσως απαιτήσει να χρησιμοποιήσετε το +FollowSymLinks στη ρύθμιση του Apache).
Χρησιμοποιήστε ένα directive Alias, όπως περιγράφηκε παραπάνω, για να κάνετε alias το κατάλληλο URL (πιθανόν το STATIC_URL + admin/) με την ακριβή τοποθεσία των αρχείων του admin.
Αντιγράψτε τα static files του admin ούτως ώστε να υπάρχουν μέσα στο document root του Apache σας.
Το Django παρέχει έναν handler που επιτρέπει στον Apache να πιστοποιεί τους χρήστες απ’ ευθείας μέσω το σύστημα πιστοποίησης του Django. Δείτε περισσότερα στο εγχειρίδιο της πιστοποίησης του mod_wsgi.
\n