使用 apache2 + `mod_proxy_uwsgi` + uwsgi + upstart 部署

时间:2022-03-14 03:10:56

使用 apache2 + mod_proxy_uwsgi + uwsgi + upstart 部署

网上运行 python wsgi 的应用时,大部分的资料都是使用 nginx 、uwsgi ,很少资料提及到 apache2 下如何进行处理。但是平时的部署环境其实很难跳过 apache2 ,很多环境已经带 apache2 ,不好另外安装一个 nginx ,因此,经过一番测试后,建议使用 apache2 + mode_proxy_uwsgi + uwsgi + upstart/systemd 的配置。整个配置并不复杂,请按照具体的步骤逐个处理。

以下的安装步骤是在 ubuntu 14.04 和 python3 中完成的。

安装依赖

安装 flask 和 uwsgi ::

pip3 install flask
pip3 install uwsgi

应用编写

首先,编写一个简单应用用于测试,可以使用 flask 或 django ,如果对 wsgi 熟悉,也可以直接使用 wsgi。这里是一个 flask 的示例 /var/www/test_app.py::

import flask
application = flask.Flask(__name__) @application.route('/')
def index():
return 'Hello, world!' if __name__ == '__main__':
application.run()

然后,做个简单的测试,启动服务器 ::

python3 /var/www/test_app.py

打开一个新的终端,用 curl 请求 ::

curl -v http://127.0.0.1:5000

可看到输出为 Hello, world!

uwsgi 配置

uwsgi 的运行方式有多种,这里只用命令行参数的方式运行,并写入到 upstart 中自动启动 /etc/init/uwsgi-test.conf ::

description     "uwsgi test"

start on runlevel [2345]
stop on runlevel [!2345] env LC_ALL=zh_CN.UTF-8
env LANG=zh_CN.UTF-8
env PYTHONIOENCODING=utf-8 exec uwsgi --socket 127.0.0.1:5000 --master --workers 2 --wsgi-file /var/www/test_app.py

为了能正确地处理 utf-8 编码的内容和日志输出,env 部分不能少。在 uwsgi 的配置可放到 ini 格式的配置文件中,并可指定一个 virtualenv 环境,防止破坏了主机的 python 环境,更多的配置选项见 http://uwsgi-docs.readthedocs.io/en/latest/

然后启动 uwsgi ::

start uwsgi-test

安装和配置 apache2

在 ubuntu 中,安装 apache2 和相关的工具 ::

apt-get install apache2 apache2-utils libapache2-mod-proxy-uwsgi

启用 mod_proxy_uwsgi ::

a2enmod proxy
a2enmod proxy_uwsgi

注意,必须同时启用 proxy 模块,否则 apache2 会报错,错误信息为 ::

Cannot load /usr/lib/apache2/modules/mod_proxy_uwsgi.so into
server: /usr/lib/apache2/modules/mod_proxy_uwsgi.so:
undefined symbol: ap_proxy_backend_broke。

编写一个配置文件 test.conf 放在 /etc/apache2/conf-available ::

ProxyPass /test uwsgi://127.0.0.1:5000

启用配置文件

a2enconf test

并重启 apache2 ::

service apache2 restart

现在用 curl 测试一下 ::

curl -v http://127.0.0.1/test

可看到输出为 Hello, world!

至此,全部工作已完成。