Pas encore de site web à héberger ? Nous créons aussi votre site ou votre application. Voir les packs

KENN HOSTING
Tous les articles
Tutoriels

Déployer une application Python (Django ou Flask) sur cPanel

Aurel KENNE14 août 20268 min de lecture

Avant de commencer

Si vous avez une application Python, que ce soit un projet Django ou une API Flask, vous pouvez la déployer directement sur votre hébergement cPanel KennHosting. Vous n'avez pas besoin d'un serveur dédié ni d'un VPS pour ça : cPanel intègre un outil natif, "Setup Python App", qui s'appuie sur Passenger pour faire tourner votre application Python aux côtés de votre site.

Ce guide couvre la création de l'application dans cPanel, l'installation de vos dépendances, la configuration du point d'entrée WSGI (le fichier qui relie votre code à Passenger), la connexion à une base de données, et les particularités propres à Django et à Flask.

Étape 1 : créer l'application dans cPanel

Connectez-vous à votre cPanel, puis rendez-vous dans la section Logiciels. Cliquez sur Setup Python App (parfois affiché "Configurer une application Python" selon la langue de l'interface).

Cliquez ensuite sur Create Application. Un formulaire vous demande plusieurs informations :

  • Version Python : choisissez une version récente dans la liste proposée (Python 3.10 ou 3.11 par exemple, selon ce qui est disponible sur votre compte).
  • Application root : le dossier qui contiendra votre code, par exemple monapi. Ce dossier se trouve à la racine de votre compte (pas dans public_html directement, Passenger gère lui-même l'exposition de l'application).
  • Application URL : le domaine, sous-domaine ou sous-dossier sur lequel votre application sera accessible.
  • Application startup file : cPanel propose par défaut passenger_wsgi.py. C'est le fichier que Passenger va charger pour démarrer votre application, et un squelette minimal est généré automatiquement à la création. Nous allons le modifier à l'étape 5.

Validez la création. cPanel crée le dossier, un environnement virtuel Python dédié (virtualenv) et le fichier passenger_wsgi.py de départ.

Étape 2 : noter la commande d'activation du virtualenv

Une fois l'application créée, cPanel affiche en haut de la page une commande d'activation de l'environnement virtuel, propre à votre compte. Elle ressemble à ceci, mais avec votre propre nom d'utilisateur et le chemin exact de votre application :

source /home/votrecompte/virtualenv/monapi/3.11/bin/activate && cd /home/votrecompte/monapi

Copiez exactement cette commande depuis l'interface cPanel, ne la recopiez pas de mémoire : le chemin varie selon votre compte, le nom de votre application et la version Python choisie. Vous en aurez besoin à chaque fois que vous voudrez installer une dépendance ou lancer une commande Django depuis le Terminal.

Étape 3 : envoyer le code de votre application

Vous avez deux façons de mettre votre code sur le serveur :

Avec Git (recommandé si vous êtes à l'aise en SSH) : connectez-vous en SSH à votre compte (depuis l'onglet Terminal de cPanel ou un client SSH), placez-vous dans le dossier "Application root" créé à l'étape 1, puis clonez votre dépôt :

cd /home/votrecompte/monapi
git clone https://github.com/votre-compte/votre-projet.git .

Avec le Gestionnaire de fichiers ou FTP : compressez votre projet en .zip (sans l'environnement virtuel local si vous en avez un), uploadez l'archive dans le dossier "Application root" via le Gestionnaire de fichiers de cPanel, puis clic droit sur l'archive pour choisir Extraire.

Dans les deux cas, n'incluez pas de dossier venv/ ou .venv/ local : l'environnement virtuel sera celui que cPanel a généré à l'étape 1, vous y installerez les dépendances à l'étape suivante.

Étape 4 : installer les dépendances

Ouvrez le Terminal depuis cPanel (section Avancé), activez le virtualenv avec la commande notée à l'étape 2, puis installez les paquets listés dans votre fichier requirements.txt :

source /home/votrecompte/virtualenv/monapi/3.11/bin/activate && cd /home/votrecompte/monapi
pip install -r requirements.txt

Si votre projet n'a pas encore de requirements.txt, générez-le depuis votre environnement de développement avant l'upload :

pip freeze > requirements.txt

Étape 5 : configurer le point d'entrée passenger_wsgi.py

C'est l'étape la plus importante et la plus souvent source d'erreur. Passenger charge le fichier passenger_wsgi.py et s'attend à y trouver une variable nommée exactement application. Le contenu de ce fichier change selon votre framework.

Pour une application Flask

Si votre fichier principal s'appelle monapp.py et que votre instance Flask s'appelle app à l'intérieur, votre passenger_wsgi.py doit ressembler à ceci :

import sys
import os

sys.path.insert(0, os.path.dirname(__file__))

from monapp import app as application

Le nom application est obligatoire, ce n'est pas un choix arbitraire : c'est ce que Passenger recherche pour savoir comment démarrer votre app. Si votre instance Flask s'appelle autrement dans votre code, adaptez uniquement la partie import ... as application, pas le nom final.

Pour une application Django

Django génère déjà un fichier wsgi.py à l'intérieur du dossier de votre projet (celui créé par django-admin startproject monprojet, vous le trouverez dans monprojet/wsgi.py). Votre passenger_wsgi.py doit simplement pointer vers ce wrapper existant :

import sys
import os

sys.path.insert(0, os.path.dirname(__file__))
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'monprojet.settings')

from monprojet.wsgi import application

Remplacez monprojet par le nom réel de votre dossier de projet Django (celui qui contient settings.py, urls.py, wsgi.py). Si votre application ne démarre pas après cette étape, le premier réflexe est de vérifier que ce nom correspond exactement à l'arborescence envoyée sur le serveur.

Étape 6 : définir les variables d'environnement

Plutôt que d'écrire vos secrets en clair dans le code, utilisez la section Environment Variables de l'interface "Setup Python App". Ajoutez-y par exemple :

SECRET_KEY=votre_cle_secrete_django_ou_flask
DEBUG=False
DB_HOST=localhost
DB_NAME=votrecompte_nomdebase
DB_USER=votrecompte_utilisateur
DB_PASSWORD=votre_mot_de_passe

Ces variables sont injectées automatiquement par Passenger dans l'environnement de votre application, vous pouvez les lire dans votre code Python avec os.environ.get('SECRET_KEY').

Étape 7 : préparer la base de données

Avant de connecter votre application, créez la base de données MySQL (ou PostgreSQL, les deux moteurs sont disponibles) directement depuis cPanel. Si vous n'avez pas encore créé de base sur votre compte, suivez notre article dédié à la création d'une base de données MySQL dans cPanel, les étapes sont les mêmes quel que soit le langage utilisé ensuite pour s'y connecter.

Pensez à ajouter le bon connecteur à votre requirements.txt selon le moteur choisi :

# Pour MySQL
mysqlclient

# Pour PostgreSQL
psycopg2-binary

Réinstallez ensuite les dépendances (pip install -r requirements.txt, virtualenv activé) si vous avez ajouté une ligne après l'étape 4.

Étape 8 : commandes spécifiques à Django

Si vous déployez un projet Django, deux commandes sont à lancer depuis le Terminal, virtualenv activé, avant de considérer le déploiement terminé :

python manage.py migrate
python manage.py collectstatic

La commande migrate applique vos migrations de base de données sur la base que vous venez de connecter. La commande collectstatic regroupe tous vos fichiers statiques (CSS, JS, images de l'admin) dans un seul dossier, défini par le réglage STATIC_ROOT de votre settings.py. Sur un hébergement mutualisé, Django ne sert pas ces fichiers statiques lui-même en production : assurez-vous que STATIC_ROOT pointe vers un dossier accessible, et que votre configuration (ou un lien symbolique) le rend joignable depuis le web si vous en avez besoin publiquement.

Étape 9 : démarrer l'application

Retournez dans Setup Python App, repérez votre application dans la liste, et cliquez sur Restart. C'est ce bouton qui recharge réellement votre code : toute modification de fichier ou de dépendance ne sera prise en compte qu'après ce redémarrage.

Visitez ensuite l'URL configurée à l'étape 1 pour vérifier que tout fonctionne.

Mettre à jour votre application plus tard

Un point important à garder en tête : ce déploiement manuel ne se met pas à jour automatiquement à chaque git push sur votre dépôt. Il n'y a pas de webhook intégré dans cette configuration. Pour publier une nouvelle version de votre code, vous devrez :

  1. Mettre à jour les fichiers sur le serveur (git pull si vous avez cloné en SSH, ou re-upload via le Gestionnaire de fichiers).
  2. Réinstaller les dépendances si requirements.txt a changé (pip install -r requirements.txt, virtualenv activé).
  3. Relancer les migrations si besoin (python manage.py migrate pour Django).
  4. Cliquer sur Restart dans Setup Python App.

Si vous développez activement et que vous préférez un déploiement automatique à chaque push sans repasser par ces étapes manuellement, notre module Applications (accessible depuis votre espace client) propose justement ce fonctionnement avec une app déjà connectée à votre dépôt GitHub.