Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Deployment

Xudong Zhang edited this page · 10 revisions

Overview

Most Tornado apps are run as single processes. For production, this usually means a fairly straight-forward combination of external process management and proxying. Here are some gathered best practices/resources.

Development

When debug mode is enabled, templates are not cached and the app will automatically restart during development. This will fail if a Python syntax error occurs, however. (This can be worked around w/ some additional code or by using Supervisor in development)

You might want to run your app from a terminal multiplexer like screen or tmux for more flexibility in leaving things running and tracing fatal errors.

Instrumentation

Production

Typically in production, multiple tornado app processes are run (at least one per core) with a frontend proxy. Tornado developer bdarnell has a tornado-production-skeleton illustrating this using Supervisor (process management) and nginx (proxying).

Process Management

Traditionally, Tornado apps are single-process and require an external process manager, however HTTPServer can be run with multiple processes. Additionally, there are a couple additional helpers for helping out with managing multiple processes.

Supervisor

Daemonizing

  • start-stop-daemon example - if you are running a standard Linux system this is an easy way to daemonize your Tornado app
  • Upstart example - Upstart is built into Ubuntu and can respawn crashed instances.

Tornado Multi-Process

As mentioned above, Tornado's HTTPServer can be configured for both multiple processes on a single or multiple sockets.

Proxying

The official docs includes an example for running nginx as a load balancing proxy and for serving static files.

Deployment

Something went wrong with that request. Please try again.