Prérequis
- L'accès à DirectAdmin : Premiers pas avec DirectAdmin
- Votre application Python (Flask, Django ou autre), avec son fichier requirements.txt
Ce guide met en ligne une application web Python, par exemple Flask ou Django, sur votre domaine ou à une adresse comme votredomaine.ca/app, avec la version de Python de votre choix. DirectAdmin la démarre et la garde en marche : vous n'avez pas de serveur à gérer. L'outil, Setup Python App, s'affiche en anglais.
1Créer l'application
Dans DirectAdmin, section Outils, cliquez sur Setup Python App, puis sur CREATE APPLICATION, et remplissez le formulaire :
Python version- La liste s'ouvre sur 2.7.18, une version abandonnée : choisissez-en une récente, comme 3.13.5
Application root- Le dossier de votre application, par exemple monapp : DirectAdmin le crée dans votre compte, à côté du dossier domains, hors de public_html
Application URL- Votre domaine, suivi d'un chemin comme monapp. Sans chemin, l'application répond à l'adresse du domaine et y prend la place de votre site
Application startup file- Laissez-le vide : DirectAdmin crée alors passenger_wsgi.py, le fichier de démarrage
Application Entry point- Laissez-le vide : il devient application, le nom que passenger_wsgi.py donne à votre application
Passenger log file- Facultatif : le champ commence par votre dossier personnel ; ajoutez par exemple logs/passenger.log pour y garder les erreurs de votre application
Cliquez sur CREATE. DirectAdmin crée le dossier et un passenger_wsgi.py d'exemple : ouvrez votre adresse, la page affiche « It works! » suivi de la version de Python.
2Envoyer vos fichiers
Avec le gestionnaire de fichiers ou en FTP, placez les fichiers de votre application et son requirements.txt dans son dossier, celui de Application root. Remplacez ensuite le contenu de passenger_wsgi.py pour qu'il charge votre application sous le nom application : avec Flask, par exemple, la ligne from app import app as application suffit, si votre fichier s'appelle app.py.
3Installer les modules
- Dans Setup Python App, la liste WEB APPLICATIONS montre votre application : cliquez sur son crayon, dans la colonne Actions.
- Sous Configuration files, entrez requirements.txt dans le champ Add another file and press enter, cliquez sur Add, puis sur SAVE, en haut.
- Cliquez sur Run Pip Install, puis sur requirements.txt dans la liste qui s'ouvre. Attendez une minute ou deux, le temps que les modules s'installent.
4Redémarrer et vérifier
Cliquez sur RESTART, en haut de la fiche de l'application, puis sur OPEN, à côté de l'adresse : votre application s'affiche. Refaites RESTART après chaque changement de fichiers, sinon l'ancienne version continue de tourner.
Lancer un script
Une commande à lancer une fois, comme les migrations de Django ? Sous Execute python script, entrez le chemin complet du script suivi de ses arguments, par exemple /home/utilisateur/monapp/manage.py migrate, puis cliquez sur Run Script. Seuls les scripts Python sont acceptés.
Variables d'environnement
Une clé d'API ou un mot de passe de base de données ne doit pas rester dans votre code. Sous Environment variables, cliquez sur ADD VARIABLE, entrez son nom et sa valeur, puis cliquez sur SAVE et sur RESTART : votre application la lit avec os.environ.
Questions fréquentes
L'application n'a pas pu démarrer : souvent, un module manque. Vérifiez que Run Pip Install a bien été lancé sur votre requirements.txt, puis cliquez sur RESTART. Pour voir l'erreur exacte, indiquez un Passenger log file et lisez-le.
Elle sert dans un terminal SSH, que l'Hébergement Web Mutualisé n'offre pas. Run Pip Install, Run Script et RESTART font le même travail depuis DirectAdmin.
Celles de votre compte d'hébergement : jusqu'à 8 cœurs de processeur et 4 Go de mémoire, partagés avec votre site. Pour une application plus lourde, un VPS vous donne un serveur à vous : voyez nos forfaits VPS.