Python Web框架Tornado运行和部署
本文实例为大家分享了PythonWeb框架Tornado运行和部署的详细内容,供大家参考,具体内容如下
一、运行和部署
因为Tornado内置了自己的HTTPServer,运行和部署它与其他Pythonweb框架不太一样。你需要写一个main()函数来启动服务,而不是配置一个WSGI容器来运行你的应用:
defmain(): app=make_app() app.listen(8888) IOLoop.current().start() if__name__=='__main__': main()
配置你的操作系统或者进程管理器来运行这个程序以启动服务。注意,增加每个进程允许打开的最大文件句柄数是可能是必要的(为了避免“Toomanyopenfiles”的错误)。为了增加这个上限(例如设置为50000)你可以使用ulimit命令,修改/etc/security/limits.conf或者设置minfds在你的supervisord配置中。
二、进程和端口
由于Python的GIL(全局解释器锁),为了充分利用多CPU的机器,运行多个Python进程是很有必要的。通常,最好是每个CPU运行一个进程。
Tornado包含了一个内置的多进程模式来一次启动多个进程,这需要一个在main函数上做点微小的改变:
defmain(): app=make_app() server=tornado.httpserver.HTTPServer(app) server.bind(8888) server.start(0)#forksoneprocesspercpu IOLoop.current().start()
这是最简单的方式来启动多进程并让他们共享同样的端口,虽然它有一些局限性。首先,每个子进程将有它自己的IOLoop,所以fork之前,不接触全局IOLoop实例是重要的(甚至是间接的)。其次,在这个模型中,很难做到零停机(zero-downtime)更新。最后,因为所有的进程共享相同的端口,想单独监控它们就更加困难了。
对更复杂的部署,建议启动独立的进程,并让它们各自监听不同的端口,supervisord的“进程组(processgroups)”功能是一个很好的方式。当每个进程使用不同的端口,一个外部的负载均衡器,例如HAProxy或nginx通常需要对外向访客提供一个单一的地址。
三、运行在负载均衡器后面
当运行在一个负载均衡器例如nginx,建议传递xheaders=True给HTTPServer的构造器。这将告诉Tornado使用类似X-Real-IP这样的HTTP头来获取用户的IP地址而不是把所有流量都认为来自于负载均衡器的IP地址。
这是一份原始的nginx配置文件,在结构上类似于我们在FriendFeed所使用的配置。这是假设nginx和Tornadoserver运行在同一台机器上的,并且四个Tornadoserver正运行在8000-8003端口:
usernginx; worker_processes1; error_log/var/log/nginx/error.log; pid/var/run/nginx.pid; events{ worker_connections1024; useepoll; } http{ #EnumeratealltheTornadoservershere upstreamfrontends{ server127.0.0.1:8000; server127.0.0.1:8001; server127.0.0.1:8002; server127.0.0.1:8003; } include/etc/nginx/mime.types; default_typeapplication/octet-stream; access_log/var/log/nginx/access.log; keepalive_timeout65; proxy_read_timeout200; sendfileon; tcp_nopushon; tcp_nodelayon; gzipon; gzip_min_length1000; gzip_proxiedany; gzip_typestext/plaintext/htmltext/csstext/xml application/x-javascriptapplication/xml application/atom+xmltext/javascript; #Onlyretryiftherewasacommunicationerror,notatimeout #ontheTornadoserver(toavoidpropagating"queriesofdeath" #toallfrontends) proxy_next_upstreamerror; server{ listen80; #Allowfileuploads client_max_body_size50M; location^~/static/{ root/var/www; if($query_string){ expiresmax; } } location=/favicon.ico{ rewrite(.*)/static/favicon.ico; } location=/robots.txt{ rewrite(.*)/static/robots.txt; } location/{ proxy_pass_headerServer; proxy_set_headerHost$http_host; proxy_redirectoff; proxy_set_headerX-Real-IP$remote_addr; proxy_set_headerX-Scheme$scheme; proxy_passhttp://frontends; } } }
四、静态文件和文件缓存
Tornado中,你可以通过在应用程序中指定特殊的static_path来提供静态文件服务:
settings={ "static_path":os.path.join(os.path.dirname(__file__),"static"), "cookie_secret":"__TODO:_GENERATE_YOUR_OWN_RANDOM_VALUE_HERE__", "login_url":"/login", "xsrf_cookies":True, } application=tornado.web.Application([ (r"/",MainHandler), (r"/login",LoginHandler), (r"/(apple-touch-icon\.png)",tornado.web.StaticFileHandler, dict(path=settings['static_path'])), ],**settings)
这些设置将自动的把所有以/static/开头的请求交由static目录,例如http://localhost:8888/static/foo.png将会通过指定的static目录提供foo.png文件。我们也会自动从static目录提供/robots.txt和/favicon.ico(尽管它们并没有以/static/前缀开始)。
在上面的设置中,我们明确的配置Tornado从StaticFileHandler根下获取apple-touch-icon.png文件,虽然文件在static文件目录中。(正则表达式捕获组必须告诉StaticFileHandler请求的文件名,调用捕获组把文件名作为方法的参数传递给处理程序)你可以做同样的事情,比如从网站的根提供sitemap.xml文件。当然,你也可以通过在你的HTML中使用<link/>标签来避免伪造根目录的apple-touch-icon.png。
为了改善性能,通常情况下,让浏览器主动缓存静态资源是个好主意,这样浏览器就不会发送不必要的可能在渲染页面时阻塞的If-Modified-Since或Etag请求了,Tornado使用静态内容版本(staticcontentversioning)来支持此项功能。
为了使用这些功能,在你的模板中使用static_url方法,而不是直接在你的HTML中输入静态文件的URL:
<html> <head> <title>FriendFeed-{{_("Home")}}</title> </head> <body> <div><imgsrc="{{static_url("images/logo.png")}}"/></div> </body> </html>
static_url()函数将把相对路径翻译成一个URI类似于/static/images/logo.png?v=aae54.其中的v参数是logo.png内容的哈希(hash),并且它的存在使得Tornado服务向用户的浏览器发送缓存头,这将使浏览器无限期的缓存内容。
因为参数v是基于文件内容的,如果你更新一个文件并重启服务,它将发送一个新的v值,所以用户的浏览器将会自动的拉去新的文件。如果文件的内容没有改变,浏览器将会继续使用本地缓存的副本,而不会从服务器检查更新,显著的提高了渲染性能。
在生产中,你可能想提供静态文件通过一个更优的静态服务器,比如nginx,你可以配置任何web服务器识别通过static_url()提供的版本标签并相应的设置缓存头。下面是我们在FriendFeed使用的nginx相关配置的一部分:
location/static/{ root/var/friendfeed/static; if($query_string){ expiresmax; } }
五、Debug模式和自动重载
如果传递debug=True配置给Application的构造函数,应用程序将会运行在debug/开发模式。在这个模式下,为了方便于开发的一些功能将被启用(每一个也可以作为独立的标签使用,如果它们都被专门指定,那它们都将获得独立的优先级):
1、autoreload=True:应用程序将会观察它的源文件是否改变,并且当任何文件改变的时候便重载它自己。这减少了在开发中需要手动重启服务的需求。然而,在debug模式下,某些错误(例如import的时候有语法错误)会导致服务关闭,并且无法自动恢复。
2、compiled_template_cache=False:模板将不会被缓存。
3、static_hash_cache=False:静态文件哈希(被static_url函数使用)将不会被缓存。
4、serve_traceback=True:当一个异常在RequestHandler中没有捕获,将会生成一个包含调用栈信息的错误页。
自动重载(autoreload)模式和HTTPServer的多进程模式不兼容,你不能给HTTPServer.start传递1以外的参数(或者调用tornado.process.fork_processes)当你使用自动重载模式的时候。
debug模式的自动重载功能可作为一个独立的模块位于tornado.autoreload。以下两者可以结合使用,在语法错误之时提供额外的健壮性:设置autoreload=True可以在app运行时检测文件修改,还有启动python-mtornado.autoreloadmyserver.py来捕获任意语法错误或者其他的启动时错误。
重载会丢失任何Python解释器命令行参数(-u).因为它使用sys.executable和sys.argv重新执行Python。此外,修改这些变量将造成重载错误。
在一些平台(包括Windows和MacOSX10.6之前),进程不能被“原地”更新,所以当检测到代码更新,旧服务就会退出然后启动一个新服务。这已经被公知来混淆一些IDE。
六、WSGI和GoogleAppEngine
Tornado通常是独立运行的,不需要一个WSGI容器。然而,在一些环境中(例如GoogleAppEngine),只运行WSGI,应用程序不能独立运行自己的服务。在这种情况下,Tornado支持一个有限制的操作模式,不支持异步操作但允许一个Tornado's功能的子集在仅WSGI环境中。以下功能在WSGI模式下是不支持的,包括协程,@asynchronous装饰器,AsyncHTTPClient,auth模块和WebSockets。
你可以使用tornado.wsgi.WSGIAdapter把一个TornadoApplication转换成WSGI应用。在这个例子中,配置你的WSGI容器发现application对象:
importtornado.web importtornado.wsgi classMainHandler(tornado.web.RequestHandler): defget(self): self.write("Hello,world") tornado_app=tornado.web.Application([ (r"/",MainHandler), ]) application=tornado.wsgi.WSGIAdapter(tornado_app)
以上就是本文的全部内容,希望对大家的学习有所帮助。