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

# Chemin du fichier : app.py (Vérifications de la configuration de l'environnement de production)
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

# Chemin du fichier : run.py (script de démarrage en production)
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

Flask 生产环境部署架构

Un exemple minimal de configuration Nginx :

Exemple

# Chemin du fichier : /etc/nginx/sites-available/example
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

# Chemin du fichier : /etc/systemd/system/example.service
[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é
autres extensions