From 407eeff9dee23657cf59071ac930f1bf8d1d9ac5 Mon Sep 17 00:00:00 2001 From: Katie McLaughlin Date: Thu, 12 Sep 2019 15:44:37 +1000 Subject: [PATCH] [3.0.x] Refs #30767 -- Improved deployment documentation. Backport of abeb4599af5ea7a384e18ec6201a95c9e419b44a from master --- docs/howto/deployment/index.txt | 32 ++++++++++++++++++++++++++------ 1 file changed, 26 insertions(+), 6 deletions(-) diff --git a/docs/howto/deployment/index.txt b/docs/howto/deployment/index.txt index bbf53181b4..4af1f3beaf 100644 --- a/docs/howto/deployment/index.txt +++ b/docs/howto/deployment/index.txt @@ -6,13 +6,33 @@ Django is full of shortcuts to make Web developers' lives easier, but all those tools are of no use if you can't easily deploy your sites. Since Django's inception, ease of deployment has been a major goal. -This section contains guides to the two main ways to deploy Django. WSGI is the -main Python standard for communicating between Web servers and applications, -but it only supports synchronous code. +There are many options for deploying your Django application, based on your +architecture or your particular business needs, but that discussion is outside +the scope of what Django can give you as guidance. -ASGI is the new, asynchronous-friendly standard that will allow your Django -site to use asynchronous Python features, and asynchronous Django features as -they are developed. +Django, being a web framework, needs a web server in order to operate. And +since most web servers don't natively speak Python, we need an interface to +make that communication happen. + +Django currently supports two interfaces: WSGI and ASGI. + +* `WSGI`_ is the main Python standard for communicating between Web servers and + applications, but it only supports synchronous code. + +* `ASGI`_ is the new, asynchronous-friendly standard that will allow your + Django site to use asynchronous Python features, and asynchronous Django + features as they are developed. + +You should also consider how you will handle :doc:`static files +` for your application, and how to handle +:doc:`error reporting`. + +Finally, before you deploy your application to production, you should run +through our :doc:`deployment checklist` to ensure that your +configurations are suitable. + +.. _WSGI: https://wsgi.readthedocs.io/en/latest/ +.. _ASGI: https://asgi.readthedocs.io/en/latest/ .. toctree:: :maxdepth: 2