Django
Django to otwarty, napisany w [[Python|Pythonie] framework przeznaczony do tworzenia aplikacji WWW. Na serwerach MyDevil.net możliwe jest uruchamianie stron opartych o ten framework dzięki zastosowaniu technologii Phusion Passenger.
Spis treści
Wstępna konfiguracja domeny
Do uruchomienia strony napisanej w Django należy pierw zadbać o prawidłową konfigurację samej domeny. Przed przystąpieniem do dalszych kroków należy upewnić się, że:
- Domena jest prawidłowo dodana i skonfigurowana w naszym systemie DNS,
- Została dodana Strona WWW z wskazaniem typu Python.
Informacja
W przypadku chęci skorzystania z virtualenv przy dodawaniu strony należy podać ścieżkę do binarki python znajdującej się wewnątrz katalogu wirtualnego środowiska.
Projekt Django
Głównym katalogiem katalog projektu Django (tj. katalog, w którym znajduje się plik manage.py) musi być folder /usr/home/$USER/domains/domena/public_python. Nazwa projektu Django nie ma znaczenia, dopóki zachowana jest powyższa nazwa katalogu.
Nowy projekt django
Nowy projekt django należy utworzyć w katalogu ~/domains/domena/public_python - najprostszym sposobem utworzenia odpowiedniego projektu jest wydanie następujących poleceń:
DOMAIN=example.com # zmienną DOMAIN należy zmodyfikować cd ~/domains/$DOMAIN/ rm -rf public_python django-admin.py startproject public_python
W ostatnim poleceniu można zmienić nazwę public_python na dowolną nazwę projektu - należy wtedy pamiętać, że projekt zostanie utworzony w katalogu o tej właśnie nazwie, którą trzeba zmienić na public_python.
Istniejący projekt django
Istniejący projekt Django należy umieścić jako katalog ~/domains/domena/public_python. W przypadku gdy projekt nie nazywa się public_python należy zmienić jego nazwę.
Konfiguracja Phusion Passenger
Ostatnim krokiem jest konfiguracja modułu Phusion Passenger, który jest odpowiedzialny za uruchomienie aplikacji Django. Należy w katalogu projektu django (~/domains/domena/public_python) utworzyć plik passenger_wsgi.py i umieścić w nim następującą zawartość (zależnie od wersji Django), modyfikując linijkę wskazującą nazwę aplikacji (oznaczoną komentarzem):
Django 1.7 i nowsze
import sys, os
sys.path.append(os.getcwd())
os.environ['DJANGO_SETTINGS_MODULE'] = "nazwa_aplikacji.settings" # zmienić 'nazwa_aplikacji' na
# nazwę projektu django
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()
Django do wersji 1.6 włącznie
import sys, os
sys.path.append(os.getcwd())
os.environ['DJANGO_SETTINGS_MODULE'] = "nazwa_aplikacji.settings" # zmienić 'nazwa_aplikacji' na
# nazwę projektu django
import django.core.handlers.wsgi
application = django.core.handlers.wsgi.WSGIHandler()
Nazwa aplikacji
Nazwę aplikacji (projektu Django) można wyciągnąć z pliku manage.py poleceniem grep DJANGO_SETTINGS_MODULE manage.py.
Testowanie konfiguracji
Poprawność konfiguracji modułu Phusion Passenger można sprawdzić wydając polecenie python passenger_wsgi.py - jeśli aplikacja nie zwróci żadnych błędów to znaczy, że aplikacja powinna zostać prawidłowo uruchomiona przez passengera.
Uwaga!
Polecenie python passenger_wsgi.py sprawdzi jedynie poprawność konfiguracji modułu Phusion Passenger - w przypadku błędów samej aplikacji django, zostaną one obsłużone przez moduł, bądź samo Django.
Błąd uniemożliwiający start aplikacji sprawi, że na stronie zostanie wyświetlony generyczny błąd Phusion Passenger. Błędy w trakcie działania aplikacji zostaną złapane przez Django i ich obsługa jest zależna od konfiguracji samej aplikacji.
