Installation de Django sur un hébergement mutualisé OVH

.htaccess

Options +ExecCGI
AddHandler cgi-script .cgi
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ django.cgi/$1 [QSA,L]

README.md

OVH permet l'exécution du code Python sur son hébergement mutualisé. Il est possible d'utiliser (en 2018) Python 3.4.2.

La version de Django la plus intéressante à utiliser avec Python 3.4 est la 1.11, car c'est une version étendue dont le support se prolongera jusqu'en 2020 alors que la 2.0 ne sera supportée que jusqu'en 2019, et que la 2.1 ne supportera pas Python 3.4 :

• https://docs.djangoproject.com/en/2.0/faq/install/
• https://www.djangoproject.com/download/

Dans un fichier requirements.txt, préciser :

    Django = 1.11.*

Puis installer vos requirements.txt (y compris tous modules complémentaire) via :

    pip3 install --root . -r requirements.txt

Dans votre dossier racine de projet, contenant manage.py et django.cgi.

L'arborescence proposée pour le code est la suivante :

/
├ projects/
│ ├ home/user/.local/lib/python3.4/site-packages
│ └ app/
│   ├ django_app/
│   | ├ __init__.py
│   | ├ settings.py
│   | ├ urls.py
│   | └ wsgi.py
│   ├ monsite/
│   | ├ migrations/
│   | ├ static/
│   | ├ template/
│   | ├ __init__.py
│   | ├ admin.py
│   | ├ models.py
│   | ├ tests.py
│   | ├ urls.py
│   | └ views.py
│   ├ manage.py
│   ├ requirements.txt
│   ├ git_bundle_scp.sh
│   └ database.sqlite
└ www/
  ├ static/
  │ ├ admin/
  │ │ ├ css/
  │ │ ├ img/
  │ │ └ js/
  │ └ monsite/
  │   ├ style.css
  │   └ favicon.png
  ├ django.cgi
  ├ .htaccess
  ├ sitemap.gz
  └ robots.txt

Le code de Django se place donc dans le dossier /projects/home/$user/.local/lib/python3.4/site-packages et le code « maison » dans le dossier /projects/app. Il est possible de personnaliser cela grâce aux instructions sys.path.append du fichier django.cgi.

Ces instructions sont également à adapter en fonction du nom de votre compte OVH (moncompte dans le fichier ci-joint). En cas de doute, vous pouvez obtenir cette information en créant dans le dossier www un fichier PHP contenant <?php echo getcwd(); ?>.

Une fois le tout fonctionnel en local chez vous, zipper et uploader le tout.

Le fonctionnement repose sur les fichiers /www/.htaccess et /www/django.cgi donnés ci-joints.

Il est essentiel que les permissions du fichier /www/django.cgi soient 755 ou supérieures. Le problème est que le serveur OVH remet les permissions à 604 dès que le fichier est modifié. Pensez-y quand vous rencontrez des erreurs 500 !

Astuce : si vous hébergez votre site sur un contrat start10m (donc avec 10 Mo d'espace disque), il est tout-à-fait possible de faire fonctionner Django. Commencez par supprimer les dossiers correspondant aux traductions que vous n'utilisez pas, dans les répertoires /locale/. Pour ma part, je ne garde que les dossiers /locale/en. Le dossier Django-1.6.10/django passe alors de 26 Mo à 6 Mo et il vous reste donc 4 Mo pour héberger votre code, votre base de données et les fichiers statiques. Cependant, par défaut, Python va stocker les fichiers bytecode (*.pyc) et ceux-ci réduiront d'autant l'espace disponible pour l'hébergement. Les lignes suivantes, à ajouter au fichier django.cgi, permettent d'empêcher Python de stocker ces fichiers (au prix d'une réduction des performances) :

os.environ['PYTHONDONTWRITEBYTECODE'] = '1'
sys.dont_write_bytecode = True

N'oubliez pas de configurer les variables ALLOWED_HOSTS au(x) bon(s) nom(s) de domaine et DEBUG et TEMPLATE_DEBUG à False dans /projects/app/django_app/settings.py.

Django-on-OVH-tutorial.md

La méthode présentée ici permet d'installer un site Django sur un hébergement mutualisé OVH.

Lisez d'abord le fichier README puis copiez les fichiers .htaccess et django.cgi vers votre hébergement, ainsi que le code source de Django et le code source de votre site web.

django.cgi

#!/usr/bin/python3 -Ou
# encoding: utf-8

import os, sys, pprint

OVH_PREFIX = '/homez.17/$ovh_user/$project_name/'  # À modifier
ENV_PREFIX = 'home/$local_user/.local/'  # À modifier
SITE_PACKAGES_PREFIX = 'lib/python3.5/site-packages/'  # À modifier

sys.path.insert(0, OVH_PREFIX + ENV_PREFIX + SITE_PACKAGES_PREFIX)
sys.path.insert(0, OVH_PREFIX + ENV_PREFIX + "bin/")
sys.path.insert(0, OVH_PREFIX)

os.environ['DJANGO_SETTINGS_MODULE'] = 'main_app.settings'  # À modifier

def run_with_cgi(application):
	environ = dict(os.environ.items())
	environ['wsgi.input'] = sys.stdin.buffer
	environ['wsgi.errors'] = sys.stderr.buffer
	environ['wsgi.version'] = (1, 0)
	environ['wsgi.multithread'] = False
	environ['wsgi.multiprocess'] = True
	environ['wsgi.run_once'] = True
	
	if environ.get('HTTPS', 'off') in ('on', '1'):
		environ['wsgi.url_scheme'] = 'https'
	else:
		environ['wsgi.url_scheme'] = 'http'
		
	headers_set = []
	headers_sent = []
	
	def write(data):
		if not headers_set:
			raise AssertionError("write() before start_response()")
		elif not headers_sent:	# Before the first output, send the stored headers
			status, response_headers = headers_sent[:] = headers_set
			sys.stdout.write('Status: %s\r\n' % status)
			
			for header in response_headers:
				sys.stdout.write('%s: %s\r\n' % header)
				
			sys.stdout.write('\r\n')
			
		sys.stdout.buffer.write(data)
		sys.stdout.flush()
				
		def start_response(status, response_headers, exc_info=None):
			if exc_info:
				try:
					if headers_sent:	# Re-raise original exception if headers sent
						raise (exc_info[0], exc_info[1], exc_info[2])
				finally:
					exc_info = None	 # avoid dangling circular ref
			elif headers_set:
				raise AssertionError("Headers already set!")
				
			headers_set[:] = [status, response_headers]
			return write
		
		result = application(environ, start_response)
		try:
			for data in result:
				if data:  # don't send headers until body appears
					write(data)
					
			if not headers_sent:
				write('')  # send headers now if body was empty
		finally:
			if hasattr(result, 'close'):
				result.close()
try:
	from django.core.wsgi import get_wsgi_application
	run_with_cgi(get_wsgi_application())
except Exception as exc:
	print("Content-type: text/html\n\n")
	print('<html><body><pre>')
	print('<h1>Server Error 500 by django.cgi</h1>')
	import django
	print('<b>django.VERSION</b> :', django.VERSION)
	print('<b>Python version</b> :', sys.version)
	print('<b>sys.stdout.encoding</b> :', sys.stdout.encoding)
	import datetime
	print('<b>Exception datetime : </b>', datetime.now())
	print(exc)
	print(traceback.format_exc())
	pprint.pprint(sys.path)
	print('')
	pprint.pprint(os.environ)
	print('</pre></body></html>')

git_bundle_scp.sh

#!/bin/bash
# Send and deploy your last commits to OVH
# we need git bundle because Hébergés OVH can't access internet from SSH sessions

# A repository have been created first, from a full bundle on the Hébergé                    

git bundle create prj.bundle last_bundle..mastergit  # you need a tag 'last_bundle' already set
tag -f last_bundle master  # sets the tag for next bundle
scp prj.bundle $user-ovh@ssh.clusterXXX.ovh.net:

CMDS=$(cat <<EOF
cd prj
git pull
./manage.py migrate
./manage.py collectstatic --no-input
EOF
)

ssh $user-ovh@ssh.clusterXXX.ovh.net "$CMDS"