{"id":9174,"date":"2024-08-30T14:24:36","date_gmt":"2024-08-30T14:24:36","guid":{"rendered":"https:\/\/www.webhi.com\/how-to\/?p=9174"},"modified":"2024-08-30T14:24:39","modified_gmt":"2024-08-30T14:24:39","slug":"deployer-application-flask-avec-gunicorn-nginx-ubuntu","status":"publish","type":"post","link":"https:\/\/www.webhi.com\/how-to\/fr\/deployer-application-flask-avec-gunicorn-nginx-ubuntu\/","title":{"rendered":"D\u00e9ployer une Application Flask avec Gunicorn et Nginx sur Ubuntu"},"content":{"rendered":"\n
\"D\u00e9ployer<\/figure>\n\n\n\n

Le d\u00e9ploiement d’une application Flask est une \u00e9tape cruciale pour rendre votre application web accessible au monde entier. Bien que Flask soit fourni avec un serveur de d\u00e9veloppement int\u00e9gr\u00e9, ce dernier n’est pas adapt\u00e9 pour un environnement de production. Pour une configuration robuste, \u00e9volutive et pr\u00eate pour la production, vous aurez besoin d’une combinaison de Gunicorn, Nginx et Ubuntu. Ce guide vous guidera \u00e0 travers le processus de d\u00e9ploiement de votre application Flask avec Gunicorn et Nginx sur un serveur Ubuntu.<\/p>\n\n\n\n

D\u00e9ployer des applications Flask sur un serveur peut sembler difficile si vous d\u00e9butez dans le d\u00e9veloppement backend, mais ce guide complet d\u00e9taillera chaque \u00e9tape. \u00c0 la fin, vous aurez une application Flask en cours d’ex\u00e9cution sur Ubuntu, servie par Gunicorn et Nginx.<\/p>\n\n\n\n

Comprendre la Pile de D\u00e9ploiement : Flask, Gunicorn et Nginx<\/strong><\/h2>\n\n\n\n

Avant de plonger dans le processus de d\u00e9ploiement, il est important de comprendre les outils que nous utiliserons.<\/p>\n\n\n\n

Flask : Le Micro Framework Web<\/strong><\/h3>\n\n\n\n

Flask est un framework web l\u00e9ger \u00e9crit en Python. Il est con\u00e7u pour \u00eatre simple, flexible et facile \u00e0 utiliser, ce qui en fait un choix populaire pour la cr\u00e9ation d’applications web. Cependant, le serveur int\u00e9gr\u00e9 de Flask n’est pas adapt\u00e9 aux environnements de production car il ne peut pas g\u00e9rer plus d’une requ\u00eate \u00e0 la fois.<\/p>\n\n\n\n

Gunicorn : Le Serveur HTTP WSGI pour Python<\/strong><\/h3>\n\n\n\n

Gunicorn (Green Unicorn) est un serveur HTTP WSGI pour Python qui sert votre application Flask. Il utilise un mod\u00e8le de processus pr\u00e9-fork, ce qui signifie qu’il cr\u00e9e plusieurs processus de travail pour g\u00e9rer plusieurs requ\u00eates simultan\u00e9ment. Cela en fait une solution id\u00e9ale pour servir des applications Flask en production. Gunicorn se situe entre votre application Flask et le serveur web (Nginx dans ce cas), prenant en charge la gestion des requ\u00eates et la r\u00e9ponse.<\/p>\n\n\n\n

Nginx : Le Serveur Web et Proxy Inverse<\/strong><\/h3>\n\n\n\n

Nginx est un serveur web performant qui agit \u00e9galement comme un proxy inverse, un \u00e9quilibreur de charge et un cache HTTP. Dans cette configuration, Nginx se situera devant Gunicorn, g\u00e9rant les connexions des clients et le contenu statique, puis transmettant les requ\u00eates dynamiques \u00e0 Gunicorn. Cette s\u00e9paration des pr\u00e9occupations am\u00e9liore la s\u00e9curit\u00e9, les performances et l’\u00e9volutivit\u00e9.<\/p>\n\n\n\n

Configurer le Serveur Ubuntu<\/strong><\/h2>\n\n\n\n

Configuration Initiale du Serveur<\/strong><\/h3>\n\n\n\n

Tout d’abord, vous avez besoin d’un acc\u00e8s \u00e0 un serveur Ubuntu. Il peut s’agir d’une machine physique, d’une machine virtuelle ou d’une instance cloud de fournisseurs comme AWS, DigitalOcean ou Google Cloud Platform.<\/p>\n\n\n\n

    \n
  1. Connectez-vous \u00e0 votre serveur :<\/strong><\/li>\n<\/ol>\n\n\n\n
    $ ssh nom_utilisateur@adresse_ip_serveur<\/code><\/pre>\n\n\n\n
      \n
    1. Mettez \u00e0 jour l’index de vos paquets :<\/strong><\/li>\n<\/ol>\n\n\n\n
      $ sudo apt update<\/code><\/pre>\n\n\n\n
        \n
      1. Mettez \u00e0 jour les paquets install\u00e9s :<\/strong><\/li>\n<\/ol>\n\n\n\n
        $ sudo apt upgrade<\/code><\/pre>\n\n\n\n
        Installation des Paquets N\u00e9cessaires<\/strong><\/h3>\n\n\n\n
        Vous aurez besoin de Python, pip et virtualenv pour ex\u00e9cuter votre application Flask.<\/p>\n\n\n\n
          \n
        1. Installez Python et pip :<\/strong><\/li>\n<\/ol>\n\n\n\n
          $ sudo apt install python3 python3-pip<\/code><\/pre>\n\n\n\n
            \n
          1. Installez virtualenv :<\/strong><\/li>\n<\/ol>\n\n\n\n
            $ sudo pip3 install virtualenv<\/code><\/pre>\n\n\n\n
            Pr\u00e9parer Votre Application Flask<\/strong><\/h2>\n\n\n\n
            Cr\u00e9er une Application Flask<\/strong><\/h3>\n\n\n\n
            Si vous n’avez pas encore d’application Flask, vous pouvez en cr\u00e9er une simple. Voici un exemple :<\/p>\n\n\n\n
              \n
            1. Cr\u00e9ez un r\u00e9pertoire pour votre projet :<\/strong><\/li>\n<\/ol>\n\n\n\n
              $ mkdir ~\/monappflask\n$ cd ~\/monappflask<\/code><\/pre>\n\n\n\n
                \n
              1. Cr\u00e9ez un environnement virtuel :<\/strong><\/li>\n<\/ol>\n\n\n\n
                $ virtualenv venv<\/code><\/pre>\n\n\n\n
                  \n
                1. Activez l’environnement virtuel :<\/strong><\/li>\n<\/ol>\n\n\n\n
                  $ source venv\/bin\/activate<\/code><\/pre>\n\n\n\n
                    \n
                  1. Installez Flask :<\/strong><\/li>\n<\/ol>\n\n\n\n
                    $ pip install Flask<\/code><\/pre>\n\n\n\n
                      \n
                    1. Cr\u00e9ez une simple application Flask :<\/strong><\/li>\n<\/ol>\n\n\n\n
                      Cr\u00e9ez un fichier nomm\u00e9 app.py<\/code> :<\/p>\n\n\n\n
                      from flask import Flask\n\napp = Flask(__name__)\n\n@app.route('\/')\ndef hello_world():\n      return 'Bonjour, Monde !'\n\nif __name__ == '__main__':\n      app.run()<\/code><\/pre>\n\n\n\n
                        \n
                      1. Testez votre application :<\/strong><\/li>\n<\/ol>\n\n\n\n
                        Ex\u00e9cutez l’application pour vous assurer que tout fonctionne :<\/p>\n\n\n\n
                        $ python app.py<\/code><\/pre>\n\n\n\n
                        Vous devriez voir une sortie indiquant que le serveur de d\u00e9veloppement Flask est en cours d’ex\u00e9cution. Visitez http:\/\/adresse_ip_serveur:5000<\/code> dans votre navigateur, et vous devriez voir “Bonjour, Monde !”.<\/p>\n\n\n\n
                        Structurer l’Application Flask<\/strong><\/h3>\n\n\n\n
                        Dans un environnement de production, il est recommand\u00e9 de structurer votre application Flask de mani\u00e8re modulaire. Voici un exemple simple de la fa\u00e7on dont vous pourriez structurer votre application :<\/p>\n\n\n\n
                        monappflask\/\n\u2502\n\u251c\u2500\u2500 app\/\n\u2502   \u251c\u2500\u2500 __init__.py\n\u2502   \u251c\u2500\u2500 routes.py\n\u2502   \u251c\u2500\u2500 models.py\n\u2502   \u2514\u2500\u2500 templates\/\n\u2502\n\u251c\u2500\u2500 venv\/\n\u251c\u2500\u2500 config.py\n\u251c\u2500\u2500 requirements.txt\n\u2514\u2500\u2500 wsgi.py<\/code><\/pre>\n\n\n\n
                        Cr\u00e9er un Point d’Entr\u00e9e WSGI<\/strong><\/h3>\n\n\n\n
                        Gunicorn a besoin d’un point d’entr\u00e9e WSGI pour servir votre application Flask. Il s’agit g\u00e9n\u00e9ralement d’un fichier nomm\u00e9 wsgi.py<\/code> :<\/p>\n\n\n\n
                          \n
                        1. Cr\u00e9ez le fichier wsgi.py<\/code> :<\/strong><\/li>\n<\/ol>\n\n\n\n
                          from app import app\n\nif __name__ == \"__main__\":\n      app.run()<\/code><\/pre>\n\n\n\n
                            \n
                          1. Installez les d\u00e9pendances suppl\u00e9mentaires :<\/strong><\/li>\n<\/ol>\n\n\n\n
                            Si votre application a des d\u00e9pendances suppl\u00e9mentaires, listez-les dans un fichier requirements.txt<\/code> et installez-les :<\/p>\n\n\n\n
                            $ pip freeze > requirements.txt\n$ pip install -r requirements.txt<\/code><\/pre>\n\n\n\n
                            D\u00e9ployer Flask avec Gunicorn<\/strong><\/h2>\n\n\n\n
                            Installer Gunicorn<\/strong><\/h3>\n\n\n\n
                            Gunicorn est un paquet Python, il peut donc \u00eatre install\u00e9 via pip.<\/p>\n\n\n\n
                              \n
                            1. Installez Gunicorn :<\/strong><\/li>\n<\/ol>\n\n\n\n
                              $ pip install gunicorn<\/code><\/pre>\n\n\n\n
                              Ex\u00e9cuter Gunicorn<\/strong><\/h3>\n\n\n\n
                              Pour tester que Gunicorn peut servir votre application, ex\u00e9cutez la commande suivante :<\/p>\n\n\n\n
                              $ gunicorn --bind 0.0.0.0:8000 wsgi:app<\/code><\/pre>\n\n\n\n
                              Cette commande indique \u00e0 Gunicorn de servir votre application Flask en utilisant le fichier wsgi.py<\/code>, en se liant au port 8000. Vous devriez pouvoir acc\u00e9der \u00e0 votre application \u00e0 http:\/\/adresse_ip_serveur:8000<\/code>.<\/p>\n\n\n\n
                              Configurer Gunicorn pour la Production<\/strong><\/h3>\n\n\n\n
                              Pour la production, vous voudrez g\u00e9n\u00e9ralement ex\u00e9cuter Gunicorn avec plusieurs processus de travail pour g\u00e9rer plusieurs requ\u00eates simultan\u00e9ment.<\/p>\n\n\n\n
                                \n
                              1. Cr\u00e9ez un fichier de service systemd pour Gunicorn :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                Cela vous permettra de g\u00e9rer Gunicorn avec systemd, le syst\u00e8me d’init utilis\u00e9 par Ubuntu.<\/p>\n\n\n\n
                                $ sudo nano \/etc\/systemd\/system\/gunicorn.service<\/code><\/pre>\n\n\n\n
                                Ajoutez le contenu suivant :<\/p>\n\n\n\n
                                [Unit]<\/strong>\nDescription=Instance Gunicorn pour servir monappflask\nAfter=network.target\n\n[Service]<\/strong>\nUser=nom_utilisateur\nGroup=www-data\nWorkingDirectory=\/home\/nom_utilisateur\/monappflask\nEnvironment=\"PATH=\/home\/nom_utilisateur\/monappflask\/venv\/bin\"\nExecStart=\/home\/nom_utilisateur\/monappflask\/venv\/bin\/gunicorn --workers 3 --bind unix:monappflask.sock -m 007 wsgi:app\n\n[Install]<\/strong>\nWantedBy=multi-user.target<\/code><\/pre>\n\n\n\n
                                Remplacez nom_utilisateur<\/code> par votre nom d’utilisateur r\u00e9el.<\/p>\n\n\n\n
                                  \n
                                1. D\u00e9marrez et activez le service Gunicorn :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                  $ sudo systemctl start gunicorn\n$ sudo systemctl enable gunicorn<\/code><\/pre>\n\n\n\n
                                    \n
                                  1. V\u00e9rifiez l’\u00e9tat du service Gunicorn :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                    $ sudo systemctl status gunicorn<\/code><\/pre>\n\n\n\n
                                    Si tout est configur\u00e9 correctement, Gunicorn devrait \u00eatre en cours d’ex\u00e9cution et servir votre application Flask.<\/p>\n\n\n\n
                                    Configurer Nginx<\/strong><\/h2>\n\n\n\n
                                    Installer Nginx<\/strong><\/h3>\n\n\n\n
                                    Si vous n’avez pas Nginx install\u00e9, vous pouvez l’installer en utilisant la commande suivante :<\/p>\n\n\n\n
                                    $ sudo apt install nginx<\/code><\/pre>\n\n\n\n
                                    Configurer Nginx comme Proxy Inverse<\/strong><\/h3>\n\n\n\n
                                    Nginx agira comme un proxy inverse, en transmettant les requ\u00eates \u00e0 Gun<\/p>\n\n\n\n
                                    icorn et en servant les fichiers statiques directement.<\/p>\n\n\n\n
                                      \n
                                    1. Cr\u00e9ez un nouveau bloc serveur :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                      $ sudo nano \/etc\/nginx\/sites-available\/monappflask<\/code><\/pre>\n\n\n\n
                                      Ajoutez le contenu suivant :<\/p>\n\n\n\n
                                      server<\/strong> {\n      listen 80;\n      server_name votre_domaine_ou_IP;\n\n      location<\/strong> \/ {\n         include proxy_params;\n         proxy_pass http:\/\/unix:\/home\/nom_utilisateur\/monappflask\/monappflask.sock;\n      }\n\n      location<\/strong> \/static\/ {\n         alias \/home\/nom_utilisateur\/monappflask\/app\/static\/;\n      }\n\n      error_log \/home\/nom_utilisateur\/monappflask\/error.log;\n      access_log \/home\/nom_utilisateur\/monappflask\/access.log;\n}<\/code><\/pre>\n\n\n\n
                                      Remplacez nom_utilisateur<\/code> par votre nom d’utilisateur r\u00e9el et votre_domaine_ou_IP<\/code> par l’adresse IP ou le nom de domaine de votre serveur.<\/p>\n\n\n\n
                                        \n
                                      1. Activez le nouveau bloc serveur :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                        $ sudo ln -s \/etc\/nginx\/sites-available\/monappflask \/etc\/nginx\/sites-enabled<\/code><\/pre>\n\n\n\n
                                          \n
                                        1. Testez la configuration de Nginx :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                          $ sudo nginx -t<\/code><\/pre>\n\n\n\n
                                          Si le test est r\u00e9ussi, vous devriez voir un message indiquant que la configuration est correcte.<\/p>\n\n\n\n
                                            \n
                                          1. Red\u00e9marrez Nginx pour appliquer les modifications :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                            $ sudo systemctl restart nginx<\/code><\/pre>\n\n\n\n
                                            Autoriser Nginx \u00e0 Travers le Pare-feu<\/strong><\/h3>\n\n\n\n
                                            Si vous utilisez UFW (Uncomplicated Firewall), vous devez autoriser Nginx \u00e0 travers le pare-feu.<\/p>\n\n\n\n
                                            $ sudo ufw allow 'Nginx Full'<\/code><\/pre>\n\n\n\n
                                            S\u00e9curiser l’Application avec SSL<\/strong><\/h2>\n\n\n\n
                                            Pour s\u00e9curiser votre application, vous pouvez configurer SSL en utilisant Let’s Encrypt.<\/p>\n\n\n\n
                                            Installer Certbot<\/strong><\/h3>\n\n\n\n
                                            Certbot est un outil pour automatiser le processus d’obtention et de renouvellement des certificats SSL.<\/p>\n\n\n\n
                                              \n
                                            1. Installez Certbot et le plugin Nginx :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                              $ sudo apt install certbot python3-certbot-nginx<\/code><\/pre>\n\n\n\n
                                                \n
                                              1. Obtenez un certificat SSL :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                                Ex\u00e9cutez la commande suivante, en rempla\u00e7ant votre_domaine_ou_IP<\/code> par votre domaine ou adresse IP :<\/p>\n\n\n\n
                                                $ sudo certbot --nginx -d votre_domaine_ou_IP<\/code><\/pre>\n\n\n\n
                                                  \n
                                                1. V\u00e9rifiez le renouvellement du certificat SSL :<\/strong><\/li>\n<\/ol>\n\n\n\n
                                                  Certbot renouvellera automatiquement vos certificats SSL. Vous pouvez simuler un renouvellement pour v\u00e9rifier si cela fonctionne :<\/p>\n\n\n\n
                                                  $ sudo certbot renew --dry-run<\/code><\/pre>\n\n\n\n
                                                  Surveiller et Consigner<\/strong><\/h2>\n\n\n\n
                                                  Logs de Gunicorn<\/strong><\/h3>\n\n\n\n
                                                  Gunicorn consigne sa sortie dans le journal systemd. Pour voir les logs :<\/p>\n\n\n\n
                                                  $ sudo journalctl -u gunicorn<\/code><\/pre>\n\n\n\n
                                                  Logs de Nginx<\/strong><\/h3>\n\n\n\n
                                                  Nginx consigne les requ\u00eates et les erreurs dans les fichiers journaux situ\u00e9s dans \/var\/log\/nginx\/<\/code>. Vous pouvez les consulter avec :<\/p>\n\n\n\n
                                                  $ sudo tail -f \/var\/log\/nginx\/access.log\n$ sudo tail -f \/var\/log\/nginx\/error.log<\/code><\/pre>\n\n\n\n
                                                  D\u00e9pannage des Probl\u00e8mes Courants<\/strong><\/h2>\n\n\n\n
                                                  Gunicorn \u00c9choue \u00e0 D\u00e9marrer<\/strong><\/h3>\n\n\n\n