Sanic框架应用部署方法详解

时间:2018-07-18
这篇文章主要介绍了Sanic框架应用部署方法,结合实例形式分析了Sanic框架应用部署的具体流程、相关命令与使用技巧,并附带说明了Gunicorn的配置方法,需要的朋友可以参考下

本文实例讲述了Sanic框架应用部署方法。分享给大家供大家参考,具体如下:

简介

Sanic是一个类似Flask的Python 3.5+ Web服务器,它的写入速度非常快。除了Flask之外,Sanic还支持异步请求处理程序。这意味着你可以使用Python 3.5中新的闪亮的异步/等待语法,使你的代码非阻塞和快速。

在之前的博文中已经讲到如何使用Sanic开发一个Python后台程序,接下来记录一下怎么部署Sanic应用

部署

内置的网络服务器简化了Sanic的部署,在定义了一个sanic.Sanic实例之后,可以调用run()方法再传入以下关键字参数:

  • host:主机服务器的地址,默认为127.0.0.1
  • port:启动服务器的断开,默认为8000
  • debug:启用调试输出,默认为False
  • ssl:SSLContext用于工作人员的ssl加密,默认为None
  • sock:服务器接受连接的套接字,默认为None
  • wrokers:产生工作进程的数量,默认为1
  • loop:一个asyncio兼容的循环事件。如果没有指定,Sanic创建它自己的事情循环,默认为None
  • protocolasyncio.protocol的子类,默认为HttpProtocol

wrokers

默认情况下,Sanic只使用一个CPU在主进程中进行监听,有时我们为了资源利用最大化,可以指定run参数的workers数量即可:

app.run(host="0.0.0.0",port=5000,wrokers=4)

Sanic会自动在多个进行中交换路线,所以如果有多个CPU,建议尽可能多的workers

通过命令运行

如果你喜欢命令行参数,则你可以通过执行模块来启动Sanic服务器。例如,你将Sanic初始化为app的文件名为manager.py,则可以像这样运行服务器:

复制代码 代码如下:
python -m sanic manager.app --host=0.0.0.0 --port=5000 --workers=4

用命令行的方式运行sanic程序,则不需要再Python文件中调用app.run()方法了

通过Gunicorn运行

了解过Gunicorn的都知道,Gunicorn为WSGI容器的一种,常见的还有uWSGI(可参考附录Gunicorn配置说明

为了使用Gunicorn运行Sanic程序,我们还需要设置worker-class参数,并将其设置为sanic.worker.GunicornWorker

复制代码 代码如下:
gunicorn manager:app bind 0.0.0.0:5000 worker-class sanic.worker.GunicornWorker

如果你的应用程序遭受内存泄漏,你可以将Gunicorn配置在完成指定数量的请求之后正常重新启动工作程序,这可以帮助限制内存泄漏的影响

附录:Gunicorn配置说明

在前面的文章《Python Web编程之WSGI协议》中有记录WSGI容器的作用,以及我们知道常见的容器就只有的uWSGI和Gunicorn,在《Python Web编程之WSGI协议》中有记录他们的特性及优缺点,在这就不在多做描述。接下来将着重记录一下Gunicorn的一些配置:

config

-c CONFIG, --config CONFIG

Gunicorn配置文件路径,路径形式的字符串格式,如:

gunicorn -c gunicorn.conf manager:app

bind

-b ADDRESS, --bind ADDRESS

Gunicorn绑定服务器套接字,Host形式的字符串格式。Gunicorn可绑定多个套接字,如:

gunicorn -b 127.0.0.1:8000 -b [::1]:9000 manager:app

backlog

--backlog

未决连接的最大数量,即等待服务的客户的数量。必须是正整数,一般设定在64~2048的范围内,一般设置为2048,超过这个数字将导致客户端在尝试连接时错误

workers

-w INT, --workers INT

用于处理工作进程的数量,为正整数,默认为1。worker推荐的数量为当前的CPU个数*2 + 1。计算当前的CPU个数方法:

import multiprocessing
print multiprocessing.cpu_count()

worker_class

-k STRTING, --worker-class STRTING

要使用的工作模式,默认为sync。可引用以下常见类型“字符串”作为捆绑类:

  • sync
  • eventlet:需要下载eventlet>=0.9.7
  • gevent:需要下载gevent>=0.13
  • tornado:需要下载tornado>=0.2
  • gthread
  • gaiohttp:需要python 3.4和aiohttp>=0.21.5

threads

--threads INT

处理请求的工作线程数,使用指定数量的线程运行每个worker。为正整数,默认为1。

worker_connections

--worker-connections INT

最大客户端并发数量,默认情况下这个值为1000。此设置将影响geventeventlet工作模式

max_requests

--max-requests INT

重新启动之前,工作将处理的最大请求数。默认值为0。

max_requests_jitter

--max-requests-jitter INT

要添加到max_requests的最大抖动。抖动将导致每个工作的重启被随机化,这是为了避免所有工作被重启。randint(0,max-requests-jitter)

timeout

-t INT, --timeout INT

超过这么多秒后工作将被杀掉,并重新启动。一般设定为30秒

graceful_timeout

--graceful-timeout INT

优雅的人工超时时间,默认情况下,这个值为30。收到重启信号后,工作人员有那么多时间来完成服务请求。在超时(从接收到重启信号开始)之后仍然活着的工作将被强行杀死。

keepalive

--keep-alive INT

在keep-alive连接上等待请求的秒数,默认情况下值为2。一般设定在1~5秒之间。

limit_request_line

--limit-request-line INT

HTTP请求行的最大大小,此参数用于限制HTTP请求行的允许大小,默认情况下,这个值为4094。值是0~8190的数字。此参数可以防止任何DDOS攻击

limit_request_fields

--limit-request-fields INT

限制HTTP请求中请求头字段的数量。此字段用于限制请求头字段的数量以防止DDOS攻击,与limit-request-field-size一起使用可以提高安全性。默认情况下,这个值为100,这个值不能超过32768

limit_request_field_size

--limit-request-field-size INT

限制HTTP请求中请求头的大小,默认情况下这个值为8190。值是一个整数或者0,当该值为0时,表示将对请求头大小不做限制

reload

--reload

代码更新时将重启工作,默认为False。此设置用于开发,每当应用程序发生更改时,都会导致工作重新启动。

reload_engine

--reload-engine STRTING

选择重载的引擎,支持的有三种:

  • auto
  • pull
  • inotity:需要下载

spew

--spew

打印服务器执行过的每一条语句,默认False。此选择为原子性的,即要么全部打印,要么全部不打印

check_config

--check-config

显示现在的配置,默认值为False,即显示。

preload_app

--preload

在工作进程被复制(派生)之前加载应用程序代码,默认为False。通过预加载应用程序,你可以节省RAM资源,并且加快服务器启动时间。

chdir

--chdir

加载应用程序之前将chdir目录指定到指定目录

daemon

--daemon

守护Gunicorn进程,默认False

raw_env

-e ENV, --env ENV

设置环境变量(key=value),将变量传递给执行环境,如:

gunicorin -b 127.0.0.1:8000 -e abc=123 manager:app

在配置文件中写法:

raw_env=["abc=123"]

pidfile

-p FILE, --pid FILE

设置pid文件的文件名,如果不设置将不会创建pid文件

worker_tmp_dir

--worker-tmp-dir DIR

设置工作临时文件目录,如果不设置会采用默认值。

accesslog

--access-logfile FILE

要写入的访问日志目录

access_log_format

--access-logformat STRING

要写入的访问日志格式。如:

access_log_format = '%(h)s %(l)s %(u)s %(t)s'

常见格式说明:

识别码 说明
h 远程地址
l “-“
u 用户名
t 时间
r 状态行,如:GET /test HTTP/1.1
m 请求方法
U 没有查询字符串的URL
q 查询字符串
H 协议
s 状态码
B response长度
b response长度(CLF格式)
f 参考
a 用户代理
T 请求时间,单位为s
D 请求时间,单位为ms
p 进程id
{Header}i 请求头
{Header}o 相应头
{Variable}e 环境变量

errorlog

--error-logfile FILE, --log-file FILE

要写入错误日志的文件目录。

loglevel

--log-level LEVEL

错误日志输出等级。

支持的级别名称为:

  • debug(调试)
  • info(信息)
  • warning(警告)
  • error(错误)
  • critical(危急)

Gunicorn的更多配置可参考:http://docs.gunicorn.org/en/stable/settings.html#server-mechanics

更多关于Python相关内容可查看本站专题:《Python入门与进阶经典教程》、《Python数据结构与算法教程》、《Python函数使用技巧总结》、《Python字符串操作技巧汇总》及《Python文件与目录操作技巧汇总

希望本文所述对大家Python程序设计有所帮助。