PythonWeb框架Tornado運行與部署詳細介紹-Python教學-PHP中文網

本文實例為大家分享了Python Web框架Tornado運行和部署的詳細內容，供大家參考，具體內容如下

一、運行和部署
因為Tornado內建了自己的HTTPServer，運行和部署它與其他Python web框架不太一樣。你需要寫一個main()函數來啟動服務，而不是設定一個WSGI容器來運行你的應用程式:

def main():
  app = make_app()
  app.listen(8888)
  IOLoop.current().start()

if __name__ == &#39;__main__&#39;:
  main()

登入後複製

##設定你的作業系統或進程管理器來執行這個程式以啟動服務。請注意，增加每個程序允許打開的最大檔案句柄數是可能是必要的(為了避免“Too many open files” 的錯誤)。為了增加這個上限(例如設定為50000 ) 你可以使用ulimit指令，修改/etc/security/limits.conf 或設定minfds 在你的supervisord設定中。

二、進程和連接埠由於Python的GIL(全域解釋器鎖定)，為了充分利用多CPU的機器，運行多個Python 進程是很有必要的。通常，最好是每個CPU運行一個行程。

Tornado包含了一個內建的多進程模式來一次啟動多個進程，這需要一個在main 函數上做點微小的改變:

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)更新。最後，因為所有的進程共享相同的端口，想單獨監控它們就更加困難了。

對更複雜的部署，建議啟動獨立的進程，並讓它們各自監聽不同的端口， supervisord 的「進程組(process groups)」功能是一個很好的方式。當每個進程使用不同的端口，一個外部的負載平衡器，例如HAProxy或nginx通常需要對外向訪客提供一個單一的位址。

三、運行在負載平衡器後面當運行在一個負載平衡器例如nginx，建議傳遞xheaders=True 給 HTTPServer 的建構器。這將告訴Tornado使用類似 X-Real-IP 這樣的HTTP頭來獲取用戶的IP位址而不是把所有流量都認為來自於負載平衡器的IP位址。

這是一份原始的nginx配置文件，在結構上類似於我們在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;
    }
  }
}

登入後複製

在四、靜態檔案和檔案快取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[&#39;static_path&#39;])),
], **settings)

登入後複製

#這些設定將自動的把所有以/static/ 開頭的請求交由static目錄，例如http://www.php.cn/:8888/static/foo.png 將會透過指定的static目錄提供foo. png 檔案。我們也會自動從static目錄提供 /robots.txt 和 /favicon.ico (儘管它們並沒有以 /static/ 前綴開始)。

在上面的設定中，我們明確的配置Tornado從 StaticFileHandler 根下獲取 apple-touch-icon.png 文件，雖然文件在static文件目錄中。 (正規表示式擷取群組必須告訴 StaticFileHandler 請求的檔案名，呼叫擷取群組把檔案名稱作為方法的參數傳遞給處理程序) 你可以做同樣的事情，例如從網站的根提供 sitemap.xml 檔案。當然，你也可以透過在你的HTML中使用標籤來避免偽造根目錄的 apple-touch-icon.png 。

為了改善效能，通常情況下，讓瀏覽器主動快取靜態資源是個好主意，這樣瀏覽器就不會發送不必要的可能在渲染頁面時阻塞的If-Modified-Since 或Etag 請求了， Tornado使用靜態內容版本(static content versioning) 來支援此項功能。

為了使用這些功能，在你的範本中使用static_url 方法，而不是直接在你的HTML中輸入靜態檔案的URL:

<html>
  <head>
    <title>FriendFeed - {{ _("Home") }}</title>
  </head>
  <body>
    <p><img src="{{ static_url("images/logo.png") }}"/></p>
  </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) {
    expires max;
  }
 }

登入後複製

五、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 -m tornado.autoreload myserver.py 来捕获任意语法错误或者其他的启动时错误。

重载会丢失任何Python解释器命令行参数(-u). 因为它使用 sys.executable 和 sys.argv 重新执行Python。此外，修改这些变量将造成重载错误。

在一些平台(包括Windows 和Mac OSX 10.6之前)，进程不能被“原地”更新，所以当检测到代码更新，旧服务就会退出然后启动一个新服务。这已经被公知来混淆一些IDE。

六、WSGI和Google App Engine
Tornado通常是独立运行的，不需要一个WSGI容器。然而，在一些环境中 (例如Google App Engine)，只运行WSGI，应用程序不能独立运行自己的服务。在这种情况下，Tornado支持一个有限制的操作模式，不支持异步操作但允许一个Tornado's功能的子集在仅WSGI环境中。以下功能在WSGI模式下是不支持的，包括协程，@asynchronous 装饰器，AsyncHTTPClient，auth 模块和WebSockets。

你可以使用 tornado.wsgi.WSGIAdapter 把一个Tornado Application 转换成WSGI应用。在这个例子中，配置你的WSGI容器发现 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)

登入後複製

以上就是本文的全部内容，希望对大家的学习有所帮助。

更多PythonWeb框架Tornado运行和部署详细介绍相关文章请关注PHP中文网！