clarify language regarding undefined time tasks (#1316)

This commit is contained in:
John Bachir 2016-07-31 00:59:30 -04:00 committed by Randall Leeds
parent fdd5276a4c
commit b3f1c5cc29

View File

@ -65,12 +65,13 @@ The worker `gaiohttp` is a full asyncio worker using aiohttp_.
Choosing a Worker Type Choosing a Worker Type
====================== ======================
The default synchronous workers assume that your application is resource bound The default synchronous workers assume that your application is resource-bound
in terms of CPU and network bandwidth. Generally this means that your in terms of CPU and network bandwidth. Generally this means that your
application shouldn't do anything that takes an undefined amount of time. For application shouldn't do anything that takes an undefined amount of time. An example
instance, a request to the internet meets this criteria. At some point the of something that takes an undefined amount of time is a request to the internet.
external network will fail in such a way that clients will pile up on your At some point the external network will fail in such a way that clients will pile up on your
servers. servers. So, in this sense, any web application which makes outgoing requests to
APIs will benefit from an asynchronous worker.
This resource bound assumption is why we require a buffering proxy in front of a This resource bound assumption is why we require a buffering proxy in front of a
default configuration Gunicorn. If you exposed synchronous workers to the default configuration Gunicorn. If you exposed synchronous workers to the