Installer un serveur web Python3
Structure du serveur Web
Installation des paquets de Raspbian
Avant de commencer, mettre à jour le gestionnaire de paquets :
|
1 2 |
sudo apt-get update sudo apt-get upgrade |
Installer Apache
Apache est un puissant serveur HTTP, populaire et libre de droits.
|
1 |
sudo apt-get install apache2 |
Vérification : en tapant l’adresse IP du Raspberry dans un navigateur, on doit voir apparaitre la page par défaut d’Apache :
Installer WSGI
WSGI est une interface entre des serveurs HTTP et des applications Web pour le langage Python.
|
1 |
sudo apt-get install libapache2-mod-wsgi-py3 |
Configuration du serveur Python
Supposons que nous souhaitions créer une application web nommée machin, voici la structure que nous allons construire :
L’application s’appelle machin . A la racine de son dossier, /home/machin, on doit trouver :
- un fichier machin.wsgi , chargé de faire l’interface entre Python et Apache,
- les fichiers Python, dont le programme principal machin.py,
- les dossiers utiles à Python Flask (voir plus tard …) .
Construire le dossier du site
|
1 |
mkdir /home/pi/machin |
Créer le fichier wsgi
|
1 |
nano /home/pi/machin/machin.wsgi |
|
1 2 3 |
import sys sys.path.insert(0, '/home/pi/machin') from machin import app as application |
Oui, c’est bien du Python, même si l’extension ne le dit pas.
Dans from machin import app as application :
- machin fait référence au module Python machin.py,
- app est l’objet principal du site (Flask) défini dans le fichier machin.py (créé plus tard …)
Configurer Apache
Créer un nouveau fichier de configuration Apache :
|
1 |
sudo nano /etc/apache2/sites-available/machin.conf |
avec le contenu suivant :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
<VirtualHost *:80> ServerName machin WSGIDaemonProcess machin user=pi group=www-data threads=5 WSGIScriptAlias / /home/pi/machin/machin.wsgi <Directory /home/pi/machin> WSGIProcessGroup machin WSGIScriptReloading On WSGIApplicationGroup %{GLOBAL} Require all granted </Directory> ErrorLog /home/pi/machin/logs/error.log </VirtualHost> |
Ce fichier renseigne le serveur Apache sur :
- le port du site : 80
- l’alias à utiliser pour atteindre le site ( / ) suivi du chemin du fichier de configuration wsgi ( /home/pi/machin/machin.wsgi)
l’alias / et le choix du port 80 (le port HTTP par défaut) impliquent que l’URL sera simplement l’adresse IP du Raspberry
- le dossier où se situe le site (ici /home/pi/machin)
- le chemin du fichier log (ici /home/pi/machin/logs/error.log )
Ce fichier est très important : il permettra d’enregistrer tous les messages d’erreur et ainsi déboguer le programme.
Il maintenant penser à créer le sous-dossier logs :
|
1 |
mkdir /home/pi/machin/logs |
Activer la configuration wsgi
|
1 |
sudo /usr/sbin/a2ensite machin.conf |
Désactiver la configuration par défaut
|
1 |
sudo /usr/sbin/a2dissite 000-default |
Redémarrer Apache
|
1 |
sudo service apache2 reload |
ou bien
|
1 |
sudo systemctl reload apache2 |
Servir une application Web Python Flask via Apache
Supposons que l’application s’appelle machin.py et soit placée dans le dossier /home/pi/machin/
|
1 2 3 4 5 6 7 8 9 10 |
from flask import Flask app = Flask(__name__) @app.route("/") def hello(): return "Machin !" if __name__ == "__main__": app.run(debug = True) |
Pour plus de détails sur les fonctionnalités et l’utilisation de Flask, voir l’article Python Flask.
Vérification : si tout s’est bien passé, en tapant l’adresse IP du Raspberry dans un navigateur, on doit voir apparaitre « Machin ! » sur la page web !
Autres petites astuces
Voici une liste non exhaustive de petites choses qui peuvent servir…
Faire un reverse proxy
Pour rediriger une URL locale (par exemple un flux vidéo d’URL <adresse IP locale>:8080 ), il faut réaliser un reverse proxy :
Activer les fonctions de proxy
|
1 |
sudo a2enmod proxy proxy_http |
Modifier le fichier de configuration Apache
|
1 |
sudo nano /etc/apache2/sites-available/machin.conf |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
VirtualHost *:80> ServerName machin ProxyPass /cam/ http://<adresse IP locale>:8080/ ProxyPassReverse /cam/ http://<adresse IP locale>:8080/ ProxyRequests Off WSGIDaemonProcess machin user=pi group=www-data threads=5 WSGIScriptAlias / /home/pi/machin/machin.wsgi <Directory /home/pi/machin> WSGIProcessGroup machin WSGIScriptReloading On WSGIApplicationGroup %{GLOBAL} Require all granted </Directory> ErrorLog /home/pi/machin/logs/error.log </VirtualHost> |
Redémarrer Apache
|
1 |
sudo service apache2 reload |
Réinitialisation complète
En cas de fausse manœuvre et qu’il devient nécessaire de recommencer à zéro, voici comment proprement réinstaller Apache :
|
1 2 |
sudo apt-get remove --purge apache2 apache2-utils sudo apt-get install apache2 |
source : http://raspbian-france.fr/installer-serveur-web-raspberry/
