Déploiement Flask
Une fois le développement terminé, l'application Flask doit être déployée dans un environnement de production afin que de vrais utilisateurs puissent y accéder.
Ce chapitre couvre les étapes clés et les considérations du développement à la production.
Serveur de développement vs serveur de production
Important: le serveur de développement intégré de Flask (flask run) ne convient qu'aux environnements de développement. Il lui manque la sécurité, la stabilité et les performances requises pour la production. Les environnements de production doivent utiliser un serveur WSGI professionnel.
| Fonctionnalités | Serveur de développement Flask | Serveur WSGI de production (Gunicorn/Waitress) |
|---|---|---|
| Gestion de la concurrence | Mono-thread (par défaut) | Multi-processus/Multi-thread/Coroutine |
| Sécurité | Le mode Debug permet l'exécution de code dans le navigateur | Aucune fonctionnalité de débogage, sécurisé et contrôlable |
| Performance | Non optimisé | Optimisé pour la haute concurrence |
| Scénarios applicables | Développement et débogage locaux | Environnement de production |
Liste de vérification du déploiement
Avant le déploiement, assurez-vous que tous les éléments suivants ont été complétés :
Exemple
import os
app.config.update(
# 1. Désactiver le mode Debug (obligatoire !)
DEBUG=False,
# 2. Lire la clé secrète à partir des variables d'environnement (ne jamais la coder en dur)
SECRET_KEY=os.environ.get("FLASK_SECRET_KEY", ""),
# 3. Configurer les options de sécurité des cookies de session
SESSION_COOKIE_SECURE=True, # Transmettre uniquement via HTTPS
SESSION_COOKIE_HTTPONLY=True, # Bloquer l'accès JavaScript
SESSION_COOKIE_SAMESITE="Lax", # Empêcher les attaques CSRF
)
Liste de contrôle complète :
| Élément à vérifier | Description | Niveau de risque |
|---|---|---|
| DEBUG = False | Désactiver le mode debug pour empêcher la fuite de code | Critique |
| SECRET_KEY aléatoire et secrète | Session et flash reposent sur la signature de clé | Critique |
| SECRET_KEY se lit depuis les variables d'environnement | Pas de codage en dur, ne pas committer dans Git | Critique |
| Lire les mots de passe de la base de données depuis les variables d'environnement | Informations sensibles absentes du code | Critique |
| SESSION_COOKIE_SECURE = True | Envoyer les cookies uniquement via HTTPS | Élevée |
| Les pages d'erreur n'exposent pas les informations de trace de pile | Utiliser un errorhandler personnalisé | Moyenne |
Déploiement avec Waitress (Windows/macOS/Linux)
WaitressC'est un serveur WSGI Python pur, multiplateforme et facile à installer :
(.venv) $ pip install waitress
Exemple
from waitress import serve
from app import create_app
app = create_app()
if __name__ == "__main__":
# Démarrer le serveur de production
serve(app, host="0.0.0.0", port=8000, threads=4)
# host="0.0.0.0" autorise l'accès externe
# threads=4 utilise 4 threads pour gérer les requêtes concurrentes
Démarrage :
(.venv) $ python run.py Serving on http://0.0.0.0:8000
Déploiement avec Gunicorn (Linux/macOS)
GunicornC'est le serveur Python WSGI le plus populaire sous Linux, avec d'excellentes performances :
(.venv) $ pip install gunicorn
Démarrer Gunicorn (spécifiez l'application directement sur la ligne de commande) :
# 基本用法:4 个 worker 进程 $ gunicorn -w 4 -b 0.0.0.0:8000 "app:create_app()" # 参数说明: # -w 4 : 启动 4 个 worker 进程(通常设为 CPU 核心数 × 2 + 1) # -b 0.0.0.0:8000 : 监听所有网络接口的 8000 端口 # "app:create_app()" : 模块名:工厂函数(与 flask --app 语法相同)
Sélection du type de worker Gunicorn :
| Type de worker | Scénarios applicables | Commande |
|---|---|---|
| sync (par défaut) | Gourmand en CPU, faible concurrence | gunicorn -w 4 app:app |
| gevent | Intensif en E/S, forte concurrence, connexions longues | gunicorn -k gevent -w 4 app:app |
| gthread | Concurrence moyenne, nécessite la prise en charge des threads | gunicorn --threads=2 -w 4 app:app |
Gunicorn ne prend pas en charge Windows. Si vous déployez sur Windows, veuillez utiliserWaitress。
Utiliser Nginx comme proxy inverse
En production, Nginx est généralement utilisé comme proxy inverse devant le serveur WSGI :
- Nginx gère les fichiers statiques (CSS, JS, images) avec une efficacité bien supérieure à Python
- Nginx assure la terminaison HTTPS (terminaison SSL)
- Nginx effectue l'équilibrage de charge, en répartissant les requêtes vers plusieurs workers backend
Un exemple minimal de configuration Nginx :
Exemple
server {
listen 80;
server_name example.com www.example.com;
# Les fichiers statiques sont gérés directement par Nginx
location /static/ {
alias /var/www/example/static/;
expires 30d; # Cache du navigateur pendant 30 jours
}
# Les autres requêtes sont transmises à Gunicorn
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Activer la configuration et recharger Nginx :
$ sudo ln -s /etc/nginx/sites-available/example /etc/nginx/sites-enabled/ $ sudo nginx -t # 检查配置语法 $ sudo systemctl reload nginx
Utiliser systemd pour gérer les services (Linux)
Créer un fichier de service systemd pour que l'application Flask démarre au démarrage et redémarre automatiquement après un plantage :
Exemple
[Unit]
Description=Application Flask EXAMPLE
After=network.target
[Service]
User=www-data
WorkingDirectory=/var/www/example
# Charger automatiquement les variables d'environnement depuis le fichier .env au démarrage
EnvironmentFile=-/var/www/example/.env
# Démarrer l'application avec Gunicorn
ExecStart=/var/www/example/.venv/bin/gunicorn -w 4 -b 127.0.0.1:8000 "app:create_app()"
# Redémarrer automatiquement après un crash
Restart=always
RestartSec=5
[Installer]
WantedBy=multi-user.target
Démarrer et gérer les services :
$ sudo systemctl daemon-reload # 重载配置文件 $ sudo systemctl enable example # 设置开机自启 $ sudo systemctl start example # 启动服务 $ sudo systemctl status example # 查看服务状态 $ sudo journalctl -u example -f # 实时查看日志
Référence rapide du serveur WSGI
| Server | Plateforme | Fonctionnalités | Installation |
|---|---|---|---|
| Werkzeug (intégré) | Toutes les plateformes | Développement uniquement, prend en charge le rechargement à chaud et le débogueur | Fourni avec Flask |
| Waitress | Toutes les plateformes | Python pur, préféré sous Windows | pip install waitress |
| Gunicorn | Linux/macOS | Bonnes performances, le choix privilégié sous Linux, et un écosystème mature | pip install gunicorn |
| uWSGI | Linux/macOS | Complet en fonctionnalités, configuration complexe | pip install uwsgi |
Résumé du tutoriel
Félicitations pour avoir terminé tout le contenu du tutoriel d'introduction à Flask !
Passons en revue ce que vous avez appris :
| Chapitre | Compétences clés |
|---|---|
| Comprendre Flask | Comprendre le positionnement et l'écosystème de Flask |
| Préparation de l’environnement | Créer un environnement virtuel, installer les dépendances |
| Première application | Créer une application minimale et utiliser flask run |
| Système de routage | Mappage d'URL, règles de variables, url_for, méthodes HTTP |
| Requête et réponse | Lire les données de requête et construire divers types de réponses |
| Rendu de template | Syntaxe Jinja2, héritage de template, protection contre les XSS |
| Fichiers statiques | Gérer les ressources statiques telles que CSS/JS/images |
| Session et cookie | Persistance de la session utilisateur, messages Flash |
| Gestion de la configuration | Configuration multi-environnements, chargement des variables d'environnement |
| Blueprint | Organisation modulaire du code, patron de conception Factory |
| Gestion des erreurs | Pages d'erreur personnalisées, journalisation |
| Intégration de base de données | Opérations SQLite, utilisation de l'objet g pour gérer les connexions |
| Test | test_client, pytest : tester les routes et les API |
| Déploiement | Gunicorn/Waitress + Nginx + systemd |
Pistes recommandées pour poursuivre l'apprentissage :
- Flask-SQLAlchemy: intégration de base de données plus puissante
- Flask-Login: authentification des utilisateurs et gestion des permissions
- Flask-WTF: traitement des formulaires et protection CSRF
- Flask-Migrate: gestion des migrations de base de données
- Flask-RESTfulouFlask-RESTX: création d'une API RESTful
- DockerDéploiement conteneurisé pour améliorer encore la portabilité