Web 应用只有部署到服务器上才能被真正的使用,前面我们了解了用 Flask 开发 Web 应用,今天就来了解下,如何部署 Flask 应用。
与开发应用相比,部署应用,多些工作,如处理日志,服务器状态报告,项目打包等,接下来我们逐个了解下。
日志简介
在练习 Web 应用时,对日志的需求不高,程序问题可以在调试时看到。对于发布后的应用,没法实时查看运行信息,为了方便查错,需要将运行信息记录在日志里。
logging 模块是 Python 中 常用的日志处理模块,可以支持多种日志输出形式,如文本、邮件、日志服务器等,日志被分为 5 个等级,用于不同的情况,等级从低到高依次是:
debug
:用于开发时调试info
:用于记录必要信息,以便了解程序运行状态warning
:警告,适用于轻微的不影响系统运行的错误提示error
:错误,用于不能忽略的异常情况,计算错误,处理流程出错等critical
:严重错误,能会使应用挂掉或者不可恢复的严重问题
调用与等级名称相同的方法,就可以记录相应等级的日志,例如:
logger.debug('我是一个调试信息')logger.warning('我是一个警告')
等级除了用于日志分类外,还可以作为输出的过滤条件,例如只记录 warning 级以上的日志:
logger.setLevel(level = logging.WARNING)
另外,还可以定义出入内容和样式,例如:
logging.basicConfig(format = '%(asctime)s - %(name)s - %(levelname)s - %(message)s')
Flask 应用实例,带有日志实例 logger,使用很方便,例如:
from flask import Flask app = Flask(__name__) app.logger.info("Hello logger!") # 记录一个等级为 info 的日志
在 blueprint 中,可以通过引入 current_app,即当前环境中的应用实例来得到 logger,如:
from flask import Blueprintfrom flask import current_app home_bp = Blueprint('home_bp', __name__)@home_bp.route('/', methods=['GET', 'POST'])def index(): current_app.logger.debug("进入首页视图函数处理")
日志配置
应用需要部署在不同的环境中,一般分开发环境,测试环境,生产环境,不同的环境对日志记录的需求不同,例如开发环境,需要详细的日志,生产环境需要简洁的日志,且能将严重错误通知管理员等等。
在 《Flask 项目结构》一节中,我们使用 config 类为不同环境设置不同数据库连接,也可以为不同环境配置日志,例如,测试环境中,将等级为 info 及以上的日志输出到文件;生产环境中,将等级为 error 及以上的日志发送邮件:
# 测试环境class TestingConfig(Config): ... @classmethod def init_app(cls, app): super().init_app(app) # 定义普通日志文件处理器 file_handler = logging.FileHandler(cls.LOG_FILENAME, mode='a', encoding='utf-8', delay=False) # 设置记录等级 file_handler.setLevel(logging.INFOINFO) app.logger.addHandler(file_handler) # 生产环境class ProductionConfig(Config): ... @classmethod def init_app(cls, app): super().init_app(app) # 定义邮件日志处理器 from logging.handlers import SMTPHandler credentials = None secure = None # 邮件各种参数和配置来自基类 config if getattr(cls, 'MAIL_USERNAME', None): credentials = (cls.MAIL_USERNAME, cls.MAIL_PASSWORD) if getattr(cls, 'MAIL_USE_TLS', None): secure = () mail_handler = SMTPHandler( mailhost=(cls.MAIL_SERVER, cls.MAIL_PORT), fromaddr=cls.FLASKY_MAIL_SENDER, toaddrs=[cls.FLASKY_ADMIN], subject=cls.FLASKY_MAIL_SUBJECT_PREFIX + ' APPLICATION ERROR', credentials=credentials, secure=secure ) # 设置发送等级 mail_handler.setLevel(logging.ERROR) app.logger.addHandler(mail_handler)
这样在代码中用调用日志记录方法,根据不同环境,日志就能被恰当的处理了。
项目打包
一般我们会为一个项目创建一个文件夹,由于 Python 项目不需要编译,开发完成后,将项目文件夹拷贝到服务上就可以完成了部署。
在应用开发过程中,我们会陆续安装一些依赖库或模块,部署后,必须安装这些被依赖,应用才能运行,要记住安装了哪些依赖不是件轻松的事
幸好 pip
提供了导出依赖模块名录的功能,可以一并导出依赖名录:
- 将环境中依赖的外部模块名录导入到 requirements.txt 中
pip frerze > requirements.txt
- 在服务器上依据 requirements.txt 安装应用依赖
pip install -r requirements.txt
我们要将 requirements.txt 作为项目代码的一部分。
值得注意的是 pip freeze
命令并不是针对特定项目的,即,导出的是所在 Python 环境中的 所有外部模块。
如果一个 Python 环境中,创建了两个不同的项目,各自有不同的依赖,那么导出来的依赖会是两个项目以来的合集,虽然对部署来说没有有问题,但安装没必要的依赖不算是好事。
因此创建项目时,为其创建一个独立的 Python 虚拟环境是个好编程习惯。
Web 服务器
虽然 Flask 提供了内置 Web 服务器,但是那种服务器是为开发打造的,达不到生产环境中需要的安全和效率,细心的同学会注意到,用 app.run()
或者 flask run
启动应用时,都会得到一句警告:Do not use the development server in a production environment.
那么在生产环境中,需要用生产专用 Web 服务器,比如 uWSGI、Gunicorn、Gevent 等等,
注意:多数 Web 服务器只支持 Linux 操作系统,如果在 Windows 上部署,可以用 Apache + mod_wsgi 的方式
我们以 uWSGI 为例,了解下如何将 Flask 项目同 uWSGI 服务器关联。
安装 uWSGI
pip install uwsgi
指定启动脚本
启动脚本就是创建应用实例所在的代码文件。
如果没有明确的应用实例定义,例如用了工厂方法,就需要单独创建一个应用实例,例如,创建一个 run.py
脚本:
from myflask import create_appimport os env_dist = os.environconfig = env_dist.get('MY_FLASK_ENV', 'default')app = create_app(config)
- 从
myflask
项目中引入工厂方法create_app
- 引入系统模块
os
,为了读取环境变量 - 从环境变量
MY_FLASK_ENV
中读取 Flask 应用环境参数(环境变量名可随意),如果没有配置,默认值为default
,即为开发环境(具体配置参考:Flask 项目结构) - 将 Flask 应用参数作为参数创建 Flask 应用实例
注意:在启动脚本中不要调用
run
方法,如果有需要放在if __name__ == '__main__'
判断之下,否则 Web 服务器启动时,没创建一个应用实例(即运行一次启动脚本),就要启动一个 Flask 内置服务器,不仅浪费资源,还会出现端口冲突的错误
启动 uWSGI
uwsgi --http :9090 --wsgi-file run.py
- --http: 通过 http 可访问,绑定端口为 9090
- --wsgi-file:指定启动脚本
一般我们会将启动设置写在配置文件中,一是有方便加入更多配置,二是方便管理,uWSGI 支持 ini、xml、yaml、json 格式的配置文件
以 ini 格式为例,创建uwsgi.ini:
[uwsgi]# 开启主进程master = true# 使用 http 协议,绑定 5000 端口http=:5000# 应用主目录chdir = /home/alisx/justdopython/flaskapps# 应用启动脚本wsgi-file=/home/alisx/justdopython/flaskapps/run.py# 启动脚本中定义的 Flask 实例 变量名callable=app# 应用使用 Python 虚拟环境路径home=/home/alisx/justdopython/flaskapps/.venv# Web 服务器工作进程数processes=4# 每个进程中线程数threads=2# uWSGI 进程号存放文件,用户停止和关闭pidfile =/home/alisx/justdopython/flaskapps/uwsgi.pid
请注意 home
配置项,用来指定 Python 虚拟环境
启动 uWSGI :
uwsgi uwsgi.ini
uWSGI 功能强大,配置丰富,这里只展示了基本的配置参数,想要了解更多可以参考文后 uWSGI 参考链接。
前置服务器
如果只是在服务器上部署一个 Flask 应用,可以跳过这里,用时再看不迟
尽管 uWSGI 功能强,性能高,完全可以胜任 Web 服务器,在实际部署中,我们还是想将其放在功能更全性能更好的专职前置 Web 服务器之后
这样做的好处是:
- 可以部署多个 Web 应用
- 不必争夺 80 端口
- 方便配置高并发和负载均衡
我们以现在流行从前置(反向代理)服务器 nginx 为例作
如果服务器上没有 nginx 需要先安装,以 ubuntu 为例:
sudo apt-get install nginx
在 nginx 的虚拟服务器的 location 中指定后端服务器:
...location / { include uwsgi_params; uwsgi_pass 127.0.0.1:9090;}...
- include: 让 nginx 加载 uwsgi 功能模块
- uwsgi_pass: 指定用 uwsgi 协议的后端应用的地址和端口,此时 uWSGI 启动参数 http 要换位 socket:
uwsgi --socket 127.0.0.1:9090
最后重启 nginx 就可以了向外提供我们的 Web 服务了。
关于 uWSGI 通信协议
前面 nginx 配置中,使用了 uwsgi_pass
指定后端服务器和通信协议
对于 uWSGI 而言,既可以指 Web 服务器,也可以指 uwsgi 通信协议(类似于 http 协议),是uWSGI 服务器其的默认通信协议,具有更好的性能和安全性,启动 uWSGI 服务器时,可以指定所使用的协议:
--http
: 会启动一个 http 进程,来接受 http 请求,该进程地位等同于 nginx,相当于前置服务器,http 进程使用 uwsgi 协议与 后端服务器通信--http-socket
: 不启动 http 进程,需要前置服务器,且前置服务器不支持 uwsgi 协议的情况下使用--socket
: 前置服务器支持 uwsgi 协议情况使用,例如用 nginx 作为前置服务器时
总结
今天介绍了如何部署一个 Flask 应用,从部署前的准备,一直到前置服务器的配置,其中以 uWSGI Web 服务器为例,介绍了如何将 Flask 应用绑定到生产服务器上,以及一些前置服务器的基本知识,希望对您发布自己的应用有一些帮助。
最后,示例代码中提供了较为完整的例子,特别是通过 config 配置日志的部分,请您参考。