Python Web框架Tornado運行和部署
本文實例為大家分享了Python Web框架Tornado運行和部署的詳細內(nèi)容,供大家參考,具體內(nèi)容如下
一、運行和部署
因為Tornado內(nèi)置了自己的HTTPServer,運行和部署它與其他Python web框架不太一樣。你需要寫一個main()函數(shù)來啟動服務,而不是配置一個WSGI容器來運行你的應用:
def main(): app = make_app() app.listen(8888) IOLoop.current().start() if __name__ == '__main__': main()
配置你的操作系統(tǒng)或者進程管理器來運行這個程序以啟動服務。注意,增加每個進程允許打開的最大文件句柄數(shù)是可能是必要的(為了避免“Too many open files” 的錯誤)。為了增加這個上限(例如設置為50000 ) 你可以使用ulimit命令,修改/etc/security/limits.conf 或者設置minfds 在你的supervisord配置中。
二、進程和端口
由于Python的GIL(全局解釋器鎖),為了充分利用多CPU的機器,運行多個Python 進程是很有必要的。通常,最好是每個CPU運行一個進程。
Tornado包含了一個內(nèi)置的多進程模式來一次啟動多個進程,這需要一個在main 函數(shù)上做點微小的改變:
def main(): app = make_app() server = tornado.httpserver.HTTPServer(app) server.bind(8888) server.start(0) # forks one process per cpu IOLoop.current().start()
這是最簡單的方式來啟動多進程并讓他們共享同樣的端口,雖然它有一些局限性。首先,每個子進程將有它自己的IOLoop,所以fork之前,不接觸全局 IOLoop 實例是重要的(甚至是間接的)。其次,在這個模型中,很難做到零停機 (zero-downtime)更新。最后,因為所有的進程共享相同的端口,想單獨監(jiān)控它們就更加困難了。
對更復雜的部署,建議啟動獨立的進程,并讓它們各自監(jiān)聽不同的端口, supervisord 的“進程組(process groups)”功能是一個很好的方式。當每個進程使用不同的端口,一個外部的負載均衡器,例如HAProxy或nginx通常需要對外向訪客提供一個單一的地址。
三、運行在負載均衡器后面
當運行在一個負載均衡器例如nginx,建議傳遞xheaders=True 給 HTTPServer 的構(gòu)造器。這將告訴Tornado使用類似 X-Real-IP 這樣的HTTP頭來獲取用戶的IP地址而不是把所有流量都認為來自于負載均衡器的IP地址。
這是一份原始的nginx配置文件,在結(jié)構(gòu)上類似于我們在FriendFeed所使用的配置。這是假設nginx和Tornado server運行在同一臺機器上的,并且四個 Tornado server 正運行在8000 - 8003端口:
user nginx;
worker_processes 1;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
events {
worker_connections 1024;
use epoll;
}
http {
# Enumerate all the Tornado servers here
upstream frontends {
server 127.0.0.1:8000;
server 127.0.0.1:8001;
server 127.0.0.1:8002;
server 127.0.0.1:8003;
}
include /etc/nginx/mime.types;
default_type application/octet-stream;
access_log /var/log/nginx/access.log;
keepalive_timeout 65;
proxy_read_timeout 200;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
gzip on;
gzip_min_length 1000;
gzip_proxied any;
gzip_types text/plain text/html text/css text/xml
application/x-javascript application/xml
application/atom+xml text/javascript;
# Only retry if there was a communication error, not a timeout
# on the Tornado server (to avoid propagating "queries of death"
# to all frontends)
proxy_next_upstream error;
server {
listen 80;
# Allow file uploads
client_max_body_size 50M;
location ^~ /static/ {
root /var/www;
if ($query_string) {
expires max;
}
}
location = /favicon.ico {
rewrite (.*) /static/favicon.ico;
}
location = /robots.txt {
rewrite (.*) /static/robots.txt;
}
location / {
proxy_pass_header Server;
proxy_set_header Host $http_host;
proxy_redirect off;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Scheme $scheme;
proxy_pass http://frontends;
}
}
}
四、靜態(tài)文件和文件緩存
Tornado中,你可以通過在應用程序中指定特殊的 static_path 來提供靜態(tài)文件服務:
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 請求的文件名,調(diào)用捕獲組把文件名作為方法的參數(shù)傳遞給處理程序) 你可以做同樣的事情,比如從網(wǎng)站的根提供 sitemap.xml 文件。 當然,你也可以通過在你的HTML中使用 <link /> 標簽來避免偽造根目錄的 apple-touch-icon.png 。
為了改善性能,通常情況下,讓瀏覽器主動緩存靜態(tài)資源是個好主意, 這樣瀏覽器就不會發(fā)送不必要的可能在渲染頁面時阻塞的 If-Modified-Since 或 Etag 請求了, Tornado使用 靜態(tài)內(nèi)容版本(static content versioning) 來支持此項功能。
為了使用這些功能,在你的模板中使用 static_url 方法,而不是直接在你的HTML中輸入靜態(tài)文件的URL:
<html>
<head>
<title>FriendFeed - {{ _("Home") }}</title>
</head>
<body>
<div><img src="{{ static_url("images/logo.png") }}"/></div>
</body>
</html>
static_url() 函數(shù)將把相對路徑翻譯成一個URI類似于 /static/images/logo.png?v=aae54.其中的 v 參數(shù)是 logo.png 內(nèi)容的哈希(hash),并且它的存在使得Tornado服務向用戶的瀏覽器發(fā)送緩存頭,這將使瀏覽器無限期的緩存內(nèi)容。
因為參數(shù) v 是基于文件內(nèi)容的,如果你更新一個文件并重啟服務,它將發(fā)送一個新的 v 值,所以用戶的瀏覽器將會自動的拉去新的文件。如果文件的內(nèi)容沒有改變,瀏覽器將會繼續(xù)使用本地緩存的副本,而不會從服務器檢查更新,顯著的提高了渲染性能。
在生產(chǎn)中,你可能想提供靜態(tài)文件通過一個更優(yōu)的靜態(tài)服務器, 比如nginx,你可以配置任何web服務器識別通過 static_url() 提供的版本標簽并相應的設置緩存頭。下面是我們在 FriendFeed 使用的nginx相關配置的一部分:
location /static/ {
root /var/friendfeed/static;
if ($query_string) {
expires max;
}
}
五、Debug模式和自動重載
如果傳遞 debug=True 配置給 Application 的構(gòu)造函數(shù),應用程序?qū)\行在debug/開發(fā)模式。 在這個模式下,為了方便于開發(fā)的一些功能將被啟用( 每一個也可以作為獨立的標簽使用,如果它們都被專門指定,那它們都將獲得獨立的優(yōu)先級):
1、autoreload=True: 應用程序?qū)^察它的源文件是否改變,并且當任何文件改變的時候便重載它自己。這減少了在開發(fā)中需要手動重啟服務的需求。然而,在debug模式下,某些錯誤(例如import的時候有語法錯誤)會導致服務 關閉,并且無法自動恢復。
2、compiled_template_cache=False: 模板將不會被緩存。
3、static_hash_cache=False: 靜態(tài)文件哈希 (被 static_url 函數(shù)使用) 將不會被緩存。
4、serve_traceback=True: 當一個異常在 RequestHandler 中沒有捕獲,將會生成一個包含調(diào)用棧信息的錯誤頁。
自動重載(autoreload)模式和 HTTPServer 的多進程模式不兼容,你不能給 HTTPServer.start 傳遞 1 以外的參數(shù)(或者調(diào)用 tornado.process.fork_processes) 當你使用自動重載模式的時候。
debug模式的自動重載功能可作為一個獨立的模塊位于 tornado.autoreload。以下兩者可以結(jié)合使用,在語法錯誤之時提供額外的健壯性: 設置 autoreload=True 可以在app運行時檢測文件修改,還有啟動 python -m tornado.autoreload myserver.py 來捕獲任意語法錯誤或者其他的啟動時錯誤。
重載會丟失任何Python解釋器命令行參數(shù)(-u). 因為它使用 sys.executable 和 sys.argv 重新執(zhí)行Python。此外,修改這些變量將造成重載錯誤。
在一些平臺(包括Windows 和Mac OSX 10.6之前),進程不能被“原地”更新,所以當檢測到代碼更新,舊服務就會退出然后啟動一個新服務。這已經(jīng)被公知來混淆一些IDE。
六、WSGI和Google App Engine
Tornado通常是獨立運行的,不需要一個WSGI容器。然而,在一些環(huán)境中 (例如Google App Engine),只運行WSGI,應用程序不能獨立運行自己的服務。在這種情況下,Tornado支持一個有限制的操作模式,不支持異步操作但允許一個Tornado's功能的子集在僅WSGI環(huán)境中。以下功能在WSGI模式下是不支持的,包括協(xié)程,@asynchronous 裝飾器,AsyncHTTPClient,auth 模塊和WebSockets。
你可以使用 tornado.wsgi.WSGIAdapter 把一個Tornado Application 轉(zhuǎn)換成WSGI應用。在這個例子中, 配置你的WSGI容器發(fā) 現(xiàn) application 對象:
import tornado.web
import tornado.wsgi
class MainHandler(tornado.web.RequestHandler):
def get(self):
self.write("Hello, world")
tornado_app = tornado.web.Application([
(r"/", MainHandler),
])
application = tornado.wsgi.WSGIAdapter(tornado_app)
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助。
相關文章
Tensorflow實現(xiàn)部分參數(shù)梯度更新操作
今天小編就為大家分享一篇Tensorflow實現(xiàn)部分參數(shù)梯度更新操作,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2020-01-01
使用pycallgraph分析python代碼函數(shù)調(diào)用流程以及框架解析
這篇文章主要介紹了使用pycallgraph分析python代碼函數(shù)調(diào)用流程以及框架解析,本文給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2021-03-03
Python數(shù)據(jù)結(jié)構(gòu)之棧、隊列的實現(xiàn)代碼分享
這篇文章主要介紹了Python數(shù)據(jù)結(jié)構(gòu)之棧、隊列的實現(xiàn)代碼分享,具有一定參考價值,需要的朋友可以了解下。2017-12-12
詳解Python如何實現(xiàn)惰性導入-lazy import
如果你的 Python 程序程序有大量的 import,而且啟動非常慢,那么你應該嘗試懶導入,本文分享一種實現(xiàn)惰性導入的一種方法,需要的可以參考一下2022-10-10
Python網(wǎng)絡編程之HTTP客戶端模塊urllib與urllib3
這篇文章介紹了Python網(wǎng)絡編程之HTTP客戶端模塊urllib與urllib3,文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-05-05
matplotlib 生成的圖像中無法顯示中文字符的解決方法
這篇文章主要介紹了matplotlib 生成的圖像中無法顯示中文字符的解決方法,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2020-06-06
Python Pickling 和 Unpickling 的區(qū)別
Python中的Pickling和Unpickling是與數(shù)據(jù)序列化和反序列化相關的重要概念,本文主要介紹了Python Pickling和Unpickling的區(qū)別,具有一定的參考價值,感興趣的可以了解一下2023-11-11
關于Python 解決Python3.9 pandas.read_excel(‘xxx.xlsx‘)報錯的問題
這篇文章主要介紹了關于Python 解決Python3.9 pandas.read_excel(‘xxx.xlsx‘)報錯的問題,本文給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-11-11

