Django auf Bluehost

Dez. 28, 2011·
Julio Batista Silva
Julio Batista Silva
· 6 Min Lesezeit
blog Linux

Dieses Jahr habe ich die Domain juliobs.com und ein Hosting bei bluehost.com gekauft; bisher liegt dort nur eine Kopie meiner alten, from scratch in PHP gebauten Seite und dieser Blog.
Jetzt sind aber endlich Ferien, und ich habe etwas Zeit, alles neu zu machen.

Ich will eine professionellere und leichter zu pflegende Website bauen — gute Gründe für ein CMS oder ein Framework.
Ich habe schon Seiten mit Joomla gebaut und fand es sogar gut, aber ich will etwas anderes, etwas Pythonischeres…

Genau: ich nehme Django!
Ich wollte mich schon länger mit diesem Framework beschäftigen, und da ich viel Python lerne, verbinde ich das Nützliche mit dem Angenehmen.

Das einzige Problem: Bluehost unterstützt Django nicht offiziell, es ist nicht in simplescripts enthalten, und auf dem Server liegt Python 2.4, während mindestens 2.5 empfohlen wird.

In diesem Beitrag zeige ich Schritt für Schritt, wie man das umgeht und Django auf Bluehost installiert.

Python 2.7 installieren

  1. Wende dich an den technischen Support und bitte um SSH-Zugang. Der Support ist sehr gut, und der Zugang sollte noch am selben Tag freigeschaltet sein.

  2. Verbinde dich per SSH mit deiner Box und lade das neueste Python 2 herunter (2.7.3):

    julio@julio-acer ~> ssh juliobs.com
    Enter passphrase for key '/home/julio/.ssh/juliobs':
    
    juliobor@box780 ~  $  wget http://python.org/ftp/python/2.7.3/Python-2.7.3.tgz
    juliobor@box780 ~  $  tar xvfz Python-2.7.3.tgz
    
  3. Wechsle in den entpackten Ordner, konfiguriere und installiere Python mit Wide-Unicode-Support:

    juliobor@box780 ~  $  cd Python-2.7.3
    juliobor@box780 ~/Python-2.7.3  $  ./configure --prefix="$HOME" --enable-unicode=ucs4
    juliobor@box780 ~/Python-2.7.3  $  make
    juliobor@box780 ~/Python-2.7.3  $  make install
    

    Wenn alles geklappt hat, kannst du das neue Python so aufrufen:

    juliobor@box780 ~  $  ~/bin/python
    Python 2.7.3 (default, May 23 2012, 23:29:34)
    [GCC 4.1.2 20080704 (Red Hat 4.1.2-52)] on linux2
    Type "help", "copyright", "credits" or "license" for more information.
    >>>
    
  4. Bearbeite ~/.bashrc, damit die Variable PATH bei jedem Bash-Start exportiert wird (die Reihenfolge zählt):

    export PATH=$HOME/bin:$PATH
    
    juliobor@box780 ~  $  echo $PATH
    /home7/juliobor/bin:/usr/lib64/qt-3.3/bin:/home7/juliobor/perl5/bin:/usr/kerberos/bin:/ramdisk/bin:/usr/bin:/bin
    
  5. Führe die .bashrc aus und prüfe, ob der Befehl python die eben installierte Version aufruft:

    juliobor@box780 ~  $  source .bashrc
    juliobor@box780 ~  $  python
    Python 2.7.3 (default, May 23 2012, 23:29:34)
    [GCC 4.1.2 20080704 (Red Hat 4.1.2-52)] on linux2
    Type "help", "copyright", "credits" or "license" for more information.
    >>>
    
  6. Die Installationsdateien kannst du löschen.

    juliobor@box780 ~  $  rm -r  Python-2.7.3.tgz Python-2.7.3/
    

Fertig! Python ist aktuell, und wir können mit der Django-Installation beginnen.

Django installieren

  1. Es gibt mehrere Wege, an Django zu kommen. Für mich ist eine Versionsverwaltung der einfachste: sie erleichtert spätere Updates und erlaubt es, mit der jeweils neuesten Version zu arbeiten.

    Beachte aber: mit trunk/master installierst du die neueste, noch in Erprobung befindliche Version, die für Seiten mit Stabilitätsanspruch nicht zu empfehlen ist. Auf mich trifft das nicht zu.

    Ich empfehle git, da die Django-Entwicklung nach GitHub umgezogen ist; es gibt aber auch Spiegel unter svn und mercurial (auf Bluehost ist mercurial nicht installiert).

    Zum späteren Aktualisieren genügt git pull bei git bzw. svn update bei SVN.

  2. Aktualisiere setuptools und installiere pip:

    juliobor@box780 ~  $  wget http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg
    juliobor@box780 ~  $  sh setuptools-0.6c11-py2.7.egg
    juliobor@box780 ~  $  rm setuptools-0.6c11-py2.7.egg
    
    juliobor@box780 ~  $  easy_install pip
    

    Oder führe das Skript https://bootstrap.pypa.io/get-pip.py aus

  3. Installiere das Django-Modul.

    Am einfachsten installierst du Django mit pip. Der folgende Befehl lädt und installiert direkt von GitHub — und erspart dir größere Eingriffe in $PATH.

    juliobor@box780 ~  $  pip install git+https://github.com/django/django.git
    

    Alternativen:

    • pip benutzen, aber das Verzeichnis der Versionsverwaltung behalten: sudo pip install -e ~/django/ (leichter mit git pull aktuell zu halten)
    • Eine .pth-Datei im Ordner site-packages anlegen, die auf das per git/svn geladene Verzeichnis zeigt
    • Mit setup.py install --user installieren
  4. Bearbeite “~/.bashrc” erneut:

    export PATH=$HOME/bin:$HOME/.local/bin:$PATH
    
    juliobor@box780 ~  $  echo $PATH
    /home7/juliobor/bin:/home7/juliobor/.local/bin:/usr/lib64/qt-3.3/bin:/home7/juliobor/perl5/bin:/usr/kerberos/bin:/ramdisk/bin:/usr/bin:/bin
    
  5. Prüfe, ob sich Django importieren lässt:

    juliobor@box780 ~  $  python
    Python 2.7.3 (default, May 23 2012, 23:29:34)
    [GCC 4.1.2 20080704 (Red Hat 4.1.2-52)] on linux2
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import django
    >>> django.VERSION
    (1, 5, 0, 'alpha', 0)
    >>> print django.get_version()
    1.5
    
  6. Für das FastCGI-Protokoll müssen wir Flup installieren:

    juliobor@box780 ~  $  pip install flup
    

    Alternative:

    juliobor@box780 ~  $  wget http://www.saddi.com/software/flup/dist/flup-1.0.2.tar.gz
    juliobor@box780 ~  $  tar xvfz flup-1.0.2.tar.gz
    juliobor@box780 ~  $  cd flup-1.0.2
    juliobor@box780 ~/flup-1.0.2  $  python setup.py build
    juliobor@box780 ~/flup-1.0.2  $  python setup.py install
    

Damit ist Django installiert. Wir können ein Testprojekt anlegen, um die Grundlagen zu lernen und zu sehen, ob alles läuft.

Ein Projekt anlegen

  • Lege ein Projektverzeichnis an einem Ort an, der nicht aus dem Web erreichbar ist (also außerhalb von ~/public_html). Zum Beispiel:

    juliobor@box780 ~  $  mkdir django_projects; cd django_projects
    
  • Lege ein Projekt in deinem Projektordner an

    juliobor@box780 ~/django_projects  $  django-admin.py startproject juliobs
    

    Wenn du nicht pip benutzt hast, musst du vermutlich $PATH anpassen, um django-admin.py wie oben aufrufen zu können:

    juliobor@box780 ~  $  export PATH=/home7/juliobor/django/django/bin:$PATH
    
  • Trag in settings.py die Einstellungen deiner Datenbank ein.

    'ENGINE': 'django.db.backends.sqlite3',
    'NAME': '/home7/juliobor/django_projects/mysite/testDB',
    

    sqlite3 ist zum Testen gut, ich empfehle aber PostgreSQL. Dafür brauchst du psycopg2:

    juliobor@box780 ~  $  pip install psycopg2
    

    Alternative:

    juliobor@box780 ~  $  easy_install psycopg2
    
  • Führe den folgenden Befehl aus, um die Datenbanktabellen anzulegen. Antworte mit no, wenn nach einem Benutzer gefragt wird: juliobor@box780 ~/django_projects/juliobs $ python manage.py syncdb

  • Lege eine .fcgi-Datei in ~/public_html an (oder in einem Unterverzeichnis, wenn du magst)

    Bearbeite die Datei django.fcgi und mach sie ausführbar:

    #!/home7/juliobor/bin/python
    import sys
    import os
    
    # Add a custom Python path.
    sys.path.insert(0,"/home7/juliobor/django_projects/juliobs")
    sys.path.insert(0,"/home7/juliobor/bin")
    
    os.chdir("/home7/juliobor/django_projects/juliobs")
    
    # Set the DJANGO_SETTINGS_MODULE environment variable.
    os.environ['DJANGO_SETTINGS_MODULE'] = "juliobs.settings"
    
    from django.core.servers.fastcgi import runfastcgi
    runfastcgi(method="threaded", daemonize="false")
    
    juliobor@box780 ~/public_html  $  chmod a+x django.fcgi
    
  • Ergänze eine .htaccess

  • Wenn Django im Wurzelverzeichnis der Seite liegt:

    AddHandler fcgid-script .fcgi
    Options +SymLinksIfOwnerMatch
    RewriteEngine On
    RewriteBase /
    RewriteRule ^(media/.*)$ - [L]
    RewriteCond %{REQUEST_URI} !(django.fcgi)
    RewriteRule ^(.*)$ django.fcgi/$1 [L]
    
  • Wenn die Seite unter /django liegt:

    ~/public_html/.htaccess

    AddHandler fcgid-script .fcgi
    Options +SymLinksIfOwnerMatch
    RewriteEngine On
    RewriteBase /
    RewriteRule ^(django\.fcgi/.*)$ - [L]
    RewriteRule ^(.*)$ /django/django.fcgi/$1 [L]
    

Jetzt kannst du jeder Django-Anleitung folgen. Das meiste lerne ich aus The Django Book (The Definitive Guide to Django): es hat diese Web-Vorschau, ist gut gepflegt und erklärt die Konzepte verständlich.

Django + Apache + mod_wsgi

Aus naheliegenden Gründen entwickle ich nicht direkt auf dem Server, auf dem meine Seite liegt, sondern auf meinem eigenen Notebook. Django hat einen praktischen Weg, die Seite ohne eigenen Server zu testen: den Befehl python2 manage.py runserver

Die Seite sollte dann unter http://localhost:8000 erscheinen

Manches lässt sich so aber schwerer testen, und da ich Apache ohnehin installiert habe, finde ich es viel praktischer, damit zu entwickeln und zu testen.

  1. Installiere Django aus git über pip:

    julio@julio-acer ~> sudo pip2 install git+https://github.com/django/django.git
    
  2. Installiere mod_wsgi:

    julio@julio-acer ~> sudo pacman -S mod_wsgi
    
  3. Bearbeite wsgi.py:

    import os
    import sys
    
    # Ergänzt sys.path um den Projektpfad und dessen übergeordnetes Verzeichnis (nötig für
    # import juliobs.settings). Geht auch über httpd.conf mit PythonPath
    sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "../../")))
    sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "../")))
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "juliobs.settings")
    
    from django.core.wsgi import get_wsgi_application
    application = get_wsgi_application()
    
  4. Bearbeite die http.conf

    LoadModule wsgi_module modules/mod_wsgi.so
    
    #WSGI - (für Django)
    WSGIScriptAlias /django /media/externo/Documentos/Programacao/Web/django_projects/juliobs/wsgi.py
    WSGIPythonPath /media/externo/Documentos/Programacao/Web/django_projects/juliobs/
    
    <Directory /media/externo/Documentos/Programacao/Web/django_projects/juliobs>
        <Files wsgi.py>
        Order deny,allow
        Allow from all
        </Files>
    </Directory>
    
    Alias /media/ /media/externo/Documentos/Programacao/Web/django_projects/juliobs/juliobs/media/
    <Directory /media/externo/Documentos/Programacao/Web/django_projects/juliobs/juliobs/media>
    SetHandler None
    Order allow,deny
    Allow from all
    </Directory>
    
  5. Die Seite sollte jetzt unter http://localhost/django erreichbar sein

Stelle deine Seite unter Versionskontrolle

Jetzt läuft alles, und wir können mit der Entwicklung der Seite beginnen. Denk daran, dass

Wenn du den Code deiner Seite nicht in einem Repository wie GitHub ablegen willst, ist rsync eine gute Alternative

julio@julio-acer Web/django/django_projects> rsync -avze --delete ssh juliobs juliobor@juliobs.com:~/django_projects

Anmerkungen:

  • Fehler beim Anlegen des Superusers:

    python manage.py createsuperuser
        return getpass.getuser().decode(locale.getdefaultlocale()[1])
    TypeError: decode() argument 1 must be string, not None
    

    Ich habe es gelöst, indem ich das Locale gesetzt habe:

    juliobor@box780 ~  $  export LANG=en_US.UTF-8
    
  • Unter Arch Linux ist mod_wsgi für Python 3; du musst mod_wsgi2 installieren.


Julio Batista Silva
Autoren
Senior Cloud Developer

Ich bin ein brasilianischer Computeringenieur mit Wohnsitz in Deutschland und begeistere mich für Technik, Wissenschaft, Fotografie und Sprachen.

Ich programmiere seit etwa zwei Jahrzehnten und habe dabei alles von mobilen Apps und Webentwicklung bis hin zu Machine Learning erkundet. Derzeit fokussiere ich mich auf Cloud‑SRE und Data Engineering.

Ich engagiere mich ehrenamtlich in den Open‑Source- und Python‑Communities, helfe bei der Organisation der PyCon DE und PyData Berlin, betreue als Mentor und trage mit Code und Übersetzungen bei.

In meinem Blog teile ich Linux‑Tipps, Einrichtungsanleitungen und persönliche Notizen, die ich als spätere Referenz geschrieben habe. Ich hoffe, dass sie auch anderen nützlich sind. Die Inhalte sind in mehreren Sprachen verfügbar.

Schau dir meine Galerie an, um einige meiner Fotografien zu sehen.

Abseits der Tastatur findest du mich auf Konzerten, beim Klarinettenspiel, Radfahren, Tauchen oder beim Erkunden neuer Orte, Kulturen und Küchen.

Ich freue mich immer über den Austausch! 🙂

comments powered by Disqus