Déploiement sur Heroku

Si l'idée de configurer Nginx et Gunicorn à la main vous donne des sueurs froides, Heroku est une alternative séduisante. C'est une plateforme "PaaS" (Platform as a Service) qui s'occupe de presque tout pour vous. Je vous montre comment faire pour mettre votre projet en ligne sans vous arracher les cheveux, en respectant quelques règles spécifiques à cet environnement.

Les fichiers indispensables

Heroku a besoin de savoir comment faire tourner votre application. Pour cela, vous devez créer trois fichiers texte à la racine de votre projet :

• requirements.txt : La liste de vos bibliothèques Python (générée avec pip freeze).
• runtime.txt : La version exacte de Python que vous utilisez (ex: python-3.11.4).
• Procfile : Le fichier le plus important. Il indique à Heroku la commande pour lancer le serveur.

web: gunicorn mon_projet.wsgi

Gérer la base de données et les fichiers statiques

Heroku utilise des bases de données PostgreSQL par défaut. Pour que Django s'y connecte automatiquement, je vous suggère d'installer dj-database-url. Ce petit utilitaire va lire les réglages de Heroku et configurer votre settings.py tout seul.

Pour les fichiers CSS et les images, Heroku ne permet pas de les stocker de manière classique. La solution la plus simple est d'utiliser WhiteNoise. C'est une bibliothèque qui permet à Django de servir ses propres fichiers statiques de manière très efficace.

import dj_database_url

# Configuration de la base de données pour Heroku
DATABASES['default'] = dj_database_url.config(conn_max_age=600, ssl_require=True)

# Activation de WhiteNoise pour les fichiers statiques
MIDDLEWARE = [
    'whitenoise.middleware.WhiteNoiseMiddleware',
    # ... autres middlewares
]

Le déploiement via Git

Le déploiement sur Heroku est lié à votre historique Git. Une fois que vos fichiers sont prêts, il vous suffit de pousser votre code vers le serveur de Heroku. C'est une méthode très fluide : chaque git push déclenche automatiquement une nouvelle mise en ligne de votre site.

Heroku est parfait pour les prototypes ou les petits projets. Mais si vous voulez un contrôle total sur votre machine et payer moins cher sur le long terme, la prochaine étape est de voir comment déployer Django sur un VPS.

Par carabde | Mis à jour le 09/05/2026