Mam nadzieję, że to kompletny poradnij jak uruchomić Django na DreamHoście.

Przewodnik ten miał pokazać jak zainstalować Django na DreamHoście z użyciem Virtual Pythona (proces opisany tu). Niestety miałem z tym pewne problemy i postanowiłem opublikować wersję w pełni sprawdzoną. Wysłałem w tej sprawie maila do supportu i jeżeli jakoś to wyjaśnią opiszę w szczegółach ten drugi schemat - moim zaniem dużo “ładniejszy”.

Przewodnik ten jest w większości oparty na tym co już w sieci jest: Jeff Croft, wiki.dreamhost.com. Nie skupiam się tu na konfiguracji aplikacji lecz na konfiguracji samego konta na DreamHoście.

Jeżeli chcesz założyć konto na DreamHoście możesz przed płatnością podać kod: DJANGOPL, który da Ci zniżkę w wysokości 60 USD a jednocześnie DreamHost przekaże nam 37 USD na hosting pod różne projekty (między innymi tego bloga i django.pl). Dobra dość z reklamami - zaczynamy.

Uwaga/wyjaśnienie: ‘~‘ tak jak zmienna systemowa $HOME na systemach UNIXowych znaczy katalog domowy.
Po pierwsze w panelu administracyjnym w zakładce “Users -> manage users”, dodajemy użytkownika (zaznaczamy “Shell account”, jako “Shell: /bin/bash”). W naszym przypadku użytkownik nazywa sie sandpit_djangopl

Dodajemy domenę/subdomenę “domains -> manage domains”. Musimy ustawić domenę, która będzie obsługiwała FCGI (zaznaczamy “FastCGI Support?”). Jako użytkownika FTP/CGI (”FTP user / CGI-runs-as user:”) wybieramy przed chwilą stworzonego użytkownika. W naszym przypadku domeną będzie sandpit.django.pl

Ważne: jeden użytkownik systemowy, którym ma uruchamiać procesy FCGI powinien mieć tylko jedną domenę/subdomenę.

Przykład: użytkownik djangopl, który obsługuje domenę django.pl (na której działa aplikacja FCGI, czyli procesy o nazwie dispatch.fcgi - tylko tej nazwy DreamHost nie zabija gdy długo chodzą) nie powinien obsługiwać również subdomeny np sandpit.django.pl, pod którą ma działać inna aplikacja FCGI. Jeżeli w tej kwestii jednak się mylę proszę poprawcie mnie.

Mamy już użytkownika i domenę. Logujemy się na niego używając SSH (na Windowsie możemy użyć puTTY)

W moim przypadku:

Ściągamy Flupa - będzie nam serwował FastCGI. Mamy dwie możliwości: wersję “stabilną” (0.5 na dziś - teoretycznie stabilne projekty zaczynają się od wersji 1.0): Skupimy się tu na wersji z SVN:

Ściągamy kod źródłowy Django z SVN (możemy też zainstalować wersję stabilną z paczki ale ta na dziś to 0.95 i nie zawiera choćby newforms):

Teraz sprawmy by django-admin.py był dostępny w konsoli (pomocne gdy tworzymy projekt od zera) - modyfikujemy zmienną systemową wyszukiwania $PATH (jeśli sam ją modyfikowałeś, może to dać różne rezultaty) oraz $PYTHONPATH - miejsca, w których Python wyszukuje modułów.

Mała rada co do .bash_profile w pliku znajduje się wpis, który dotyczy wyświetlania promptu BASHowego: PS1=”[\h ]$ ” ja zmieniam go na: PS1=”[\h \w]$ ” by pokazywał katalog, w którym jestem.

Django mamy zainstalowane więc możemy wrzucić nasz projekt i go odpowiednio skonfigurować (w tym przypadku projekt nazywa się djangopl i umieszczony zostanie w katalogu ~/django_projects/):

W katalogu ~/django_projects/ umieszczamy nasz projekt np. pobieramy go z SVN, kopiujemy przez FTP lub SSH wedle uznania. Gdy to juz zrobiliśmy, zmieniamy uprawnienia do pliku settings.py i zmieniamy jego zawartośc wedle uznania (dane bazy danych, debug itd). W tym kroku wiele zależy od tego jak stworzona została aplikacja i z czego korzysta więc zbyt wiele nie potrafie opisać.

Ważna uwaga dotycząca biezpieczeństwa. Standardowo DreamHost zakłada katalogi z prawami do odczytu i uruchamiania dla wszystkich (755) - przez co jeżeli ktoś zna ścieżkę, może dodać sobie nasz katalog z projektami i działać na modułach. Jeżeli chcemy by to nie było możliwe możemy zmienić prawa dostępu tak. (Jeżeli przez to pojawią się problemy robimy: chmod 755 -R ~/django_projects/ po czym chmod 600 ~/django_projects/djangopl/settings.py):

Krótki tutorial dotyczący Vima.
W skrócie: aby wprowadzać tekst wciskamy: insert (lub i) aby zapisać zmiany Esc (jeżeli jesteśmy w trybie wprowadzania) później :x. Aby skasować całą linię: Esc (jeżeli jesteśmy w trybie wprowadzania tekstu) i dd.

Teraz możemy sprawić by nasz projekt (tu djangopl) był serwowany pod domena sandpit.django.pl:

Do pliku wklejamy ten kod uwzględniając oczywiście zmianę katalogu użytkownika (tu sandpit_djangopl) :

Zamykamy plik i w konsoli zmieniamy jego prawa:

Sprawmy by Apache wszystko poza odwołaniami do zawartości katalogów media i admin_media oddelegowywał przez dispatch.fcgi do Django. Plik .htaccess musi znajdować sie w katalogu głównym naszej domeny:

Katalogi admin i admin_media zlinkujemy do odpowiednich scieżek skonfigurowanych w settings.py:

Teoretycznie nasz projekt jest już wystawiony i powinien działać. Wchodzimy tu: http://sandpit.django.pl.

Ewentualne Problemy.
Pamiętajmy o tym, że domena potrzebuje trochę czasu na propagację. Dodatkowo nie wiem dlaczego ale często byba, że Apache na DreamHoście zaczyna odpalać skrypty FastCGI dopiero po pewnym czasie. Przy pierwszych walkach okazywało się, że po godzinach spędzonych nad uruchomieniem - następnego dnia wszystko działało bez zarzutu.

Możliwe jest, że aplikacja wyrzuca wyjątek i jeżeli ustawiny mamy DEBUG=False (a tak powinniśmy zrobić) możemy sprawdzić sam skrypt tak:

Skrypt ten przeszukuje linii kody, która zawiera słowo Status. Jeżeli pojawi się:

będzie to oznaczało, że wszystko gra. Jeżeli pominiemy fragment | grep Status skrypt powinien w konsoli “wypluć” czysty zwrot (np HTML)

PS właśnie dostałem zwrot od Supportu DreamHosta i może uda mi się podać receptę na instalacje Django i Pylons z użyciem Virtual Pythona.

Jeżeli cokolwiek jest niejasne bądź okaże się, że popełniłem gdzieś błąd - proszę komentujcie, razem ulepszymy ten poradnik.