{"title":"Déploiement de Django avec uWSGI","version":"2.2","locale":"fr","docname":"howto/deployment/wsgi/uwsgi","url":"/fr/2.2/howto/deployment/wsgi/uwsgi/","canonical":"https://djangodocs.dev/fr/2.2/howto/deployment/wsgi/uwsgi/","summary":"uWSGI est un serveur conteneur d’applications rapide, auto-réparateur et convivial à la fois pour les développeurs et les administrateurs ; il est codé en C pur.…","html":"<h1>Déploiement de Django avec uWSGI<a class=\"heading-anchor\" href=\"#how-to-use-django-with-uwsgi\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<p><a class=\"reference external\" href=\"https://uwsgi-docs.readthedocs.io/\">uWSGI</a> est un serveur conteneur d’applications rapide, auto-réparateur et convivial à la fois pour les développeurs et les administrateurs ; il est codé en C pur.</p>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">Voir aussi</p>\n<p>La documentation de uWSGI fournit un <a class=\"reference external\" href=\"https://uwsgi.readthedocs.io/en/latest/tutorials/Django_and_nginx.html\">tutoriel</a> abordant Django, nginx et uWSGI (une possibilité de déploiement parmi plusieurs). La documentation ci-dessous se concentre sur la façon d’intégrer Django avec uWSGI.</p>\n</aside>\n<section id=\"prerequisite-uwsgi\">\n<h2>Prérequis : uWSGI<a class=\"heading-anchor\" href=\"#prerequisite-uwsgi\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Le wiki d’uWSGI décrit plusieurs <a class=\"reference external\" href=\"https://uwsgi-docs.readthedocs.io/en/latest/Install.html\">procédures d’installation</a>. En utilisant pip, le gestionnaire de paquets Python, vous pouvez installer n’importe quelle version d’uWSGI à l’aide d’une seule commande. Par exemple :</p>\n<div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"gp\"># </span>Install<span class=\"w\"> </span>current<span class=\"w\"> </span>stable<span class=\"w\"> </span>version.\n<span class=\"gp\">$ </span>pip<span class=\"w\"> </span>install<span class=\"w\"> </span>uwsgi\n\n<span class=\"gp\"># </span>Or<span class=\"w\"> </span>install<span class=\"w\"> </span>LTS<span class=\"w\"> </span><span class=\"o\">(</span>long<span class=\"w\"> </span>term<span class=\"w\"> </span>support<span class=\"o\">)</span>.\n<span class=\"gp\">$ </span>pip<span class=\"w\"> </span>install<span class=\"w\"> </span>https://projects.unbit.it/downloads/uwsgi-lts.tar.gz\n</code></pre></div>\n<section id=\"uwsgi-model\">\n<h3>Le modèle uWSGI<a class=\"heading-anchor\" href=\"#uwsgi-model\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>uWSGI opère sur un modèle client-serveur. Votre serveur Web (par ex. nginx ou Apache) communique avec un processus de travail django-uwsgi pour servir le contenu dynamique.</p>\n</section>\n<section id=\"configuring-and-starting-the-uwsgi-server-for-django\">\n<h3>Configuration et démarrage du serveur uWSGI pour Django<a class=\"heading-anchor\" href=\"#configuring-and-starting-the-uwsgi-server-for-django\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>uWSGI accepte plusieurs façons de configurer le processus. Voir la <a class=\"reference external\" href=\"https://uwsgi.readthedocs.io/en/latest/Configuration.html\">documentation de configuration</a> fournie par uWSGI.</p>\n<p>Voici un exemple de commande pour lancer un serveur uWSGI :</p>\n<div class=\"code-block\" data-language=\"bash\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>uwsgi<span class=\"w\"> </span>--chdir<span class=\"o\">=</span>/path/to/your/project<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--module<span class=\"o\">=</span>mysite.wsgi:application<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--env<span class=\"w\"> </span><span class=\"nv\">DJANGO_SETTINGS_MODULE</span><span class=\"o\">=</span>mysite.settings<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--master<span class=\"w\"> </span>--pidfile<span class=\"o\">=</span>/tmp/project-master.pid<span class=\"w\"> </span><span class=\"se\">\\</span>\n<span class=\"w\">    </span>--socket<span class=\"o\">=</span><span class=\"m\">127</span>.0.0.1:49152<span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">     </span><span class=\"c1\"># can also be a file</span>\n<span class=\"w\">    </span>--processes<span class=\"o\">=</span><span class=\"m\">5</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">                </span><span class=\"c1\"># number of worker processes</span>\n<span class=\"w\">    </span>--uid<span class=\"o\">=</span><span class=\"m\">1000</span><span class=\"w\"> </span>--gid<span class=\"o\">=</span><span class=\"m\">2000</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">        </span><span class=\"c1\"># if root, uwsgi can drop privileges</span>\n<span class=\"w\">    </span>--harakiri<span class=\"o\">=</span><span class=\"m\">20</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">                </span><span class=\"c1\"># respawn processes taking more than 20 seconds</span>\n<span class=\"w\">    </span>--max-requests<span class=\"o\">=</span><span class=\"m\">5000</span><span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">          </span><span class=\"c1\"># respawn processes after serving 5000 requests</span>\n<span class=\"w\">    </span>--vacuum<span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">                     </span><span class=\"c1\"># clear environment on exit</span>\n<span class=\"w\">    </span>--home<span class=\"o\">=</span>/path/to/virtual/env<span class=\"w\"> </span><span class=\"se\">\\ </span><span class=\"w\">  </span><span class=\"c1\"># optional path to a virtualenv</span>\n<span class=\"w\">    </span>--daemonize<span class=\"o\">=</span>/var/log/uwsgi/yourproject.log<span class=\"w\">      </span><span class=\"c1\"># background the process</span>\n</code></pre></div>\n<p>Cet exemple part du principe qu’un paquet de projet de premier niveau est nommé <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite</span></code>, dans lequel se trouve un module <code class=\"file docutils literal notranslate\"><span class=\"pre\">mysite/wsgi.py</span></code> contenant un objet WSGI <code class=\"docutils literal notranslate\"><span class=\"pre\">application</span></code>. C’est la disposition obtenue en lançant la commande <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span> <span class=\"pre\">startproject</span> <span class=\"pre\">mysite</span></code> (en remplaçant <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite</span></code> par votre propre nom de projet) avec toute version récente de Django. Si ce fichier n’existe pas, vous devrez le créer. Consultez la documentation de <a class=\"reference internal\" href=\"/fr/2.2/howto/deployment/wsgi/\"><span class=\"doc\">Comment déployer avec WSGI</span></a> pour connaître le contenu par défaut à placer dans ce fichier et ce que vous pouvez aussi y ajouter en plus.</p>\n<p>Les options spécifiques à Django sont :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">chdir</span></code>: le chemin vers le répertoire qui doit se trouver dans le chemin d’importation Python, par exemple le répertoire contenant le paquet <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">module</span></code>: le module WSGI à utiliser, probablement le module <code class=\"docutils literal notranslate\"><span class=\"pre\">mysite.wsgi</span></code> créé par la commande <a class=\"reference internal\" href=\"/fr/2.2/ref/django-admin/#django-admin-startproject\"><code class=\"xref std std-djadmin docutils literal notranslate\"><span class=\"pre\">startproject</span></code></a>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">env</span></code>: doit probablement contenir au moins</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">home</span></code>: chemin facultatif vers le virtualenv de votre projet.</p></li>\n</ul>\n<p>Exemple de fichier de configuration .ini :</p>\n<div class=\"code-block\" data-language=\"bash\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"o\">[</span>uwsgi<span class=\"o\">]</span>\n<span class=\"nv\">chdir</span><span class=\"o\">=</span>/path/to/your/project\n<span class=\"nv\">module</span><span class=\"o\">=</span>mysite.wsgi:application\n<span class=\"nv\">master</span><span class=\"o\">=</span>True\n<span class=\"nv\">pidfile</span><span class=\"o\">=</span>/tmp/project-master.pid\n<span class=\"nv\">vacuum</span><span class=\"o\">=</span>True\nmax-requests<span class=\"o\">=</span><span class=\"m\">5000</span>\n<span class=\"nv\">daemonize</span><span class=\"o\">=</span>/var/log/uwsgi/yourproject.log\n</code></pre></div>\n<p>Exemple d’utilisation de fichier de configuration .ini :</p>\n<div class=\"code-block\" data-language=\"bash\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>uwsgi<span class=\"w\"> </span>--ini<span class=\"w\"> </span>uwsgi.ini\n</code></pre></div>\n<aside class=\"admonition-fixing-unicodeencodeerror-for-file-uploads admonition\">\n<p class=\"admonition-title\">Résolution des erreurs <code class=\"docutils literal notranslate\"><span class=\"pre\">UnicodeEncodeError</span></code> pour les envois de fichiers</p>\n<p>Si vous obtenez des erreurs <code class=\"docutils literal notranslate\"><span class=\"pre\">UnicodeEncodeError</span></code> lors de l’envoi de fichiers contenant des caractères non ASCII dans leur nom, vérifiez que uWSGI est configuré pour accepter les noms de fichiers non ASCII en ajoutant ceci dans <code class=\"docutils literal notranslate\"><span class=\"pre\">uwsgi.ini</span></code>:</p>\n<div class=\"code-block\" data-language=\"bash\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code><span class=\"nv\">env</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"nv\">LANG</span><span class=\"o\">=</span>en_US.UTF-8\n</code></pre></div>\n<p>Consultez la section <a class=\"reference internal\" href=\"/fr/2.2/ref/unicode/#unicode-files\"><span class=\"std std-ref\">Fichiers</span></a> du guide de référence Unicode pour plus de détails.</p>\n</aside>\n<p>Consultez la documentation de uWSGI sur la <a class=\"reference external\" href=\"https://uwsgi-docs.readthedocs.io/en/latest/Management.html\">gestion du processus uWSGI</a> pour des informations sur le démarrage, l’arrêt et le rechargement des processus de travail uWSGI.</p>\n</section>\n</section>","rootId":"how-to-use-django-with-uwsgi","toc":[{"title":"Prérequis : uWSGI","anchor":"prerequisite-uwsgi","children":[{"title":"Le modèle uWSGI","anchor":"uwsgi-model","children":[]},{"title":"Configuration et démarrage du serveur uWSGI pour Django","anchor":"configuring-and-starting-the-uwsgi-server-for-django","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"Guides pratiques","url":"/fr/2.2/howto/"},{"docname":"howto/deployment/index","title":"Déploiement de Django","url":"/fr/2.2/howto/deployment/"},{"docname":"howto/deployment/wsgi/index","title":"Comment déployer avec WSGI","url":"/fr/2.2/howto/deployment/wsgi/"}],"prev":{"docname":"howto/deployment/wsgi/gunicorn","title":"Déploiement de Django avec Gunicorn","url":"/fr/2.2/howto/deployment/wsgi/gunicorn/"},"next":{"docname":"howto/deployment/wsgi/modwsgi","title":"Django avec Apache et mod_wsgi","url":"/fr/2.2/howto/deployment/wsgi/modwsgi/"},"formats":{"html":"/fr/2.2/howto/deployment/wsgi/uwsgi/","markdown":"/fr/2.2/howto/deployment/wsgi/uwsgi.md","json":"/fr/2.2/howto/deployment/wsgi/uwsgi.json"},"source":"https://github.com/django/django/blob/stable/2.2.x/docs/howto/deployment/wsgi/uwsgi.txt","official":"https://docs.djangoproject.com/fr/2.2/howto/deployment/wsgi/uwsgi/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}