Python Pyramid - 部署
本教程中到目前为止开发的 Pyramid 应用程序示例已在本地计算机上执行。 要公开访问它,它必须部署在支持 WSGI 标准的生产服务器上。
许多与 WSGI 兼容的 http 服务器都可用于此目的。 例如 −
- waitress
- paste.httpserver
- CherryPy
- uWSGI
- gevent
- mod_wsgi
我们已经讨论了如何使用 Waitress 服务器来托管 Pyramid 应用程序。 它可以在具有公共 IP 地址的机器的端口 80 (HTTP) 和 443 (HTTPS) 上提供服务。
mod_wsgi
Apache 服务器是一款流行的开源 HTTP 服务器软件,由 Apache Software Foundation 发布。 它为互联网上的大多数 Web 服务器提供支持。 mod_wsgi(由 Graham Dumpleton 开发)是一个 Apache 模块,它提供了一个 WSGI 接口,用于在 Apache 上部署基于 Python 的 Web 应用程序。
在本节中,将逐步解释在 Apache 服务器上部署 Pyramid 应用程序的过程。 在这里,我们将使用 XAMPP,一种流行的开源 Apache 发行版。 可以在 https://www.apachefriends.org/download.html 上下载。
mod_wsgi 模块随 PIP 安装程序一起安装。 在安装之前,将 MOD_WSGI_APACHE_ROOTDIR 环境变量设置为 Apache 可执行文件所在的目录。
C:\Python310\Scripts>set MOD_WSGI_APACHE_ROOTDIR=C:/xampp/apache C:\Python310\Scripts>pip install mod_wsgi
接下来,在命令终端中运行以下命令。
C:\Python310\Scripts>mod_wsgi-express module-config LoadFile "C:/Python310/python310.dll" LoadModule wsgi_module "C:/Python310/lib/site-packages/mod_wsgi/server/mod_wsgi.cp310-win_amd64.pyd" WSGIPythonHome "C:/Python310"
这些是要合并到 Apache 配置文件中的 mod_wsgi 模块设置。 打开 XAMPP 安装的 httpd.conf 文件,并将上述命令行的输出复制到其中。
接下来,为我们的应用程序创建一个虚拟主机配置。 Apache 将虚拟主机信息存储在 httpd-vhosts.conf 文件中,该文件位于 C:\XAMPP\Apache\conf\extra\ 文件夹中。 打开文件并在其中添加以下行 −
<VirtualHost *> ServerName localhost:6543 WSGIScriptAlias / e:/pyramid-env/hello/production.ini <Directory e:/pyramid-env/hello> Order deny,allow Allow from all Require all granted </Directory> </VirtualHost>
在这里,假设使用 Cookiecutter 实用程序构建了一个 hello Pyramid 项目。 这里使用了生产环境要使用的PasteDeploy配置文件。
此虚拟主机配置需要合并到 Apache 的 httpd.conf 文件中。 这是通过在其中添加以下行来完成的 −
# Virtual hosts Include conf/extra/httpd-vhosts.conf
我们现在必须将以下代码保存为 pyramid.wsgi 文件,该文件返回 Pyramid WSGI 应用程序对象。
from pyramid.paster import get_app, setup_logging ini_path = 'e:/pyramid-env/hello/production.ini' setup_logging(ini_path) application = get_app(ini_path, 'main')
执行上述过程后,重新启动 XAMPP 服务器,我们应该能够在 Apache 服务器上运行 Pyramid 应用程序。
在 Uvicorn 上部署
Uvicorn 是一个 ASGI 兼容服务器(ASGI 代表异步网关接口)。由于 Pyramid 是一个基于 WSGI 的 Web 框架,我们需要借助 asgiref.wsgi 模块中定义的 WsgiToAsgi() 函数将 WSGI 应用程序对象转换为 ASGI 对象。
from asgiref.wsgi import WsgiToAsgi from pyramid.config import Configurator from pyramid.response import Response def hello_world(request): return Response("Hello") with Configurator() as config: config.add_route("hello", "/") config.add_view(hello_world, route_name="hello") wsgi_app = config.make_wsgi_app() app = WsgiToAsgi(wsgi_app)
将以上代码保存为app.py。 使用 pip 实用程序安装 Uvicorn。
pip3 install uvicorn
以 ASGI 模式运行 Pyramid 应用程序。
uvicorn app:app
同样,它可以使用 daphne 服务器提供。
daphne app:app