mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-02-01 21:29:24 +00:00
Code Issues 32 Releases Wiki Activity

Fixed #34109 -- Updated instructions for running with Uvicorn.

Browse Source 
Co-authored-by: Paolo Melchiorre <paolo@melchiorre.org>
This commit is contained in:
Simon Willison 2022-10-26 02:51:15 -07:00 committed by GitHub
parent e51c998f8d
commit 022a864a5d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/howto/deployment/asgi/uvicorn.txt
View File

@ -12,7 +12,7 @@ Installing Uvicorn
You can install Uvicorn with ``pip``:: You can install Uvicorn with ``pip``::
python -m pip install uvicorn gunicorn python -m pip install uvicorn
Running Django in Uvicorn Running Django in Uvicorn
========================= =========================
@ -24,12 +24,30 @@ called (separated by a colon).
For a typical Django project, invoking Uvicorn would look like:: For a typical Django project, invoking Uvicorn would look like::
gunicorn myproject.asgi:application -k uvicorn.workers.UvicornWorker python -m uvicorn myproject.asgi:application
This will start one process listening on ``127.0.0.1:8000``. It requires that This will start one process listening on ``127.0.0.1:8000``. It requires that
your project be on the Python path; to ensure that run this command from the your project be on the Python path; to ensure that run this command from the
same directory as your ``manage.py`` file. same directory as your ``manage.py`` file.
In development mode, you can add ``--reload`` to cause the server to reload any
time a file is changed on disk.
For more advanced usage, please read the `Uvicorn documentation <Uvicorn_>`_. For more advanced usage, please read the `Uvicorn documentation <Uvicorn_>`_.
Deploying Django using Uvicorn and Gunicorn
===========================================
Gunicorn_ is a robust web server that implements process monitoring and automatic
restarts. This can be useful when running Uvicorn in a production environment.
To install Uvicorn and Gunicorn, use the following::
python -m pip install uvicorn gunicorn
Then start Gunicorn using the Uvicorn worker class like this::
python -m gunicorn myproject.asgi:application -k uvicorn.workers.UvicornWorker
.. _Uvicorn: https://www.uvicorn.org/ .. _Uvicorn: https://www.uvicorn.org/
.. _Gunicorn: https://gunicorn.org/